< Back
Unregister-AzureRmRecoveryServicesBackupManagementServer
Post
NAME Unregister-AzureRmRecoveryServicesBackupManagementServer
SYNOPSIS
Unregisters a SCDPM server or Backup server from the vault.
SYNTAX
Unregister-AzureRmRecoveryServicesBackupManagementServer [-AzureRmBackupManagementServer] <BackupEngineBase> [-DefaultProfile
<IAzureContextContainer>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Unregister-AzureRmRecoveryServicesBackupManagementServer cmdlet unregisters a System Center Data Protection Manager (SCDPM) server or an Azure
Backup server from the vault. This cmdlet removes references to the servers that are unregistered 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-AzureRmRecoveryServicesVaultContext cmdlet before you use the current cmdlet.
PARAMETERS
-AzureRmBackupManagementServer <BackupEngineBase>
Specifies an SCDPM server object to unregister. To obtain an BackupManagementServer object, use the
Get-AzureRmRecoveryServicesBackupManagementServer cmdlet.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Return the Backup Management Server to be deleted.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
NOTES
Example 1: Unregister an SCDPM server from the vault
PS C:\\>$BMS = Get-AzureRmRecoveryServicesBackupManagementServer -Name "dpmserver01.contoso.com"
PS C:\\> Unregister-AzureRmRecoveryServicesBackupManagementServer -AzureRmBackupManagementServer $BMS
The first command gets the Backup management server named dpmserver01.contoso.com, and then stores it in the $BMS variable.
The second command unregisters the SCDPM server from the vault.
RELATED LINKS
Online Version:
https://docs.microsoft.com/en-us/powers ... mentserver
Get-AzureRmRecoveryServicesBackupManagementServer
SYNOPSIS
Unregisters a SCDPM server or Backup server from the vault.
SYNTAX
Unregister-AzureRmRecoveryServicesBackupManagementServer [-AzureRmBackupManagementServer] <BackupEngineBase> [-DefaultProfile
<IAzureContextContainer>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Unregister-AzureRmRecoveryServicesBackupManagementServer cmdlet unregisters a System Center Data Protection Manager (SCDPM) server or an Azure
Backup server from the vault. This cmdlet removes references to the servers that are unregistered 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-AzureRmRecoveryServicesVaultContext cmdlet before you use the current cmdlet.
PARAMETERS
-AzureRmBackupManagementServer <BackupEngineBase>
Specifies an SCDPM server object to unregister. To obtain an BackupManagementServer object, use the
Get-AzureRmRecoveryServicesBackupManagementServer cmdlet.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Return the Backup Management Server to be deleted.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
NOTES
Example 1: Unregister an SCDPM server from the vault
PS C:\\>$BMS = Get-AzureRmRecoveryServicesBackupManagementServer -Name "dpmserver01.contoso.com"
PS C:\\> Unregister-AzureRmRecoveryServicesBackupManagementServer -AzureRmBackupManagementServer $BMS
The first command gets the Backup management server named dpmserver01.contoso.com, and then stores it in the $BMS variable.
The second command unregisters the SCDPM server from the vault.
RELATED LINKS
Online Version:
https://docs.microsoft.com/en-us/powers ... mentserver
Get-AzureRmRecoveryServicesBackupManagementServer