Compartilhar via

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. Esse 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 registrado no cofre e, em seguida, o armazena 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 cofre

$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 Nome como "pstest-vm" que está registrado no cofre e, em seguida, o armazena na variável $Cont. O segundo comando cancela o registro do contêiner de backup especificado do cofre dos serviços de recuperação e gera a tarefa de backup para monitorar e acompanhar a conclusão.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorne o contêiner a ser excluído.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VaultId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

ContainerBase