Unregister-AzRecoveryServicesBackupContainer

Module:

Az.RecoveryServices Module

Unregisters a Windows Server or other container from the vault.

Unregister-AzRecoveryServicesBackupContainer
 [-Container] <ContainerBase>
 [-PassThru]
 [-Force]
 [-VaultId <String>]
 [-DefaultProfile <IAzureContextContainer>]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

The Unregister-AzRecoveryServicesBackupContainer cmdlet unregisters a Windows Server or other Backup container from the vault. This cmdlet removes references to a container from the vault. Before you can unregister a container, you must delete any protected data associated with that container. Set the vault context by using the Set-AzRecoveryServicesVaultContext cmdlet before you use the current cmdlet.

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Cont = Get-AzRecoveryServicesBackupContainer -ContainerType "Windows" -BackupManagementType MAB -VaultId $vault.ID
Unregister-AzRecoveryServicesBackupContainer -Container $Cont

The first command gets the Windows container named server01.contoso.com that is registered in the vault, and then stores it in the $Cont variable. The second command unregisters the specified Windows Server from the Azure Backup vault.

Unregisters a Windows Server or other container from the vault. (autogenerated)

Unregister-AzRecoveryServicesBackupContainer -Container $Cont -VaultId $vault.ID

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Cont = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer -BackupManagementType AzureWorkload -VaultId $vault.ID | Where-Object { $_.Name -match "pstest-vm" }
Unregister-AzRecoveryServicesBackupContainer -Container $Cont

WorkloadName Operation Status StartTime EndTime JobID
------------ --------- ------ --------- ------- -----
sql-pstest-vm2 UnRegister Completed 1/3/2024 6:26:54 AM 1/3/2024 6:29:18 AM f8626j98-8027-7h89-aa77-1a7ed83f5645

The first command gets the container with Name like "pstest-vm" that is registered in the vault, and then stores it in the $Cont variable. The second command unregisters the specified backup container from the recovery services vault and outputs the backup job to monitor and track completion.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.