Unregister-AzRecoveryServicesBackupContainer

  • Referência
Módulo:
Az.RecoveryServices

Cancela o registro de um Windows Server ou outro contêiner do cofre.

Sintaxe

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

Description

O cmdlet Unregister-AzRecoveryServicesBackupContainer cancela o registro de um Windows Server ou outro contêiner de Backup do cofre. Este cmdlet remove referências a um contêiner do cofre. Antes de cancelar o registro de um contêiner, você deve excluir todos os dados protegidos associados a esse contêiner. Defina o contexto do cofre usando o cmdlet Set-AzRecoveryServicesVaultContext antes de usar o cmdlet atual.

Exemplos

Exemplo 1: Cancelar o registro de um Windows Server do cofre

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

O primeiro comando obtém o contêiner do Windows chamado server01.contoso.com que está registrado no cofre e, em seguida, armazena-o na variável $Cont. O segundo comando cancela o registro do Windows Server especificado do cofre do Backup do Azure.

Exemplo 2

Cancela o registro de um Windows Server ou outro contêiner do cofre. (gerado automaticamente)

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

Exemplo 3: Cancelar o registro de um contêiner MSSQL do vault

$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

O primeiro comando obtém o contêiner com Name como "pstest-vm" que está registrado no vault e, em seguida, armazena-o na variável $Cont. O segundo comando cancela o registro do contêiner de backup especificado do cofre de serviços de recuperação e gera a saída do trabalho de backup para monitorar e acompanhar a conclusão.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Container

Especifica um objeto de contêiner de backup para cancelar o registro. Para obter um objeto BackupContainer , use o cmdlet Get-AzRecoveryServicesBackupContainer.

Tipo:ContainerBase
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Forçar o cancelamento do registro do contêiner (impede a caixa de diálogo de confirmação). Este parâmetro é opcional.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Retorne o contêiner a ser excluído.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VaultId

ID ARM do Cofre dos Serviços de Recuperação.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

ContainerBase