Disable-AzRecoveryServicesBackupProtection

  • Referência
Módulo:
Az.RecoveryServices

Desabilita a proteção para um item protegido por backup.

Syntax

Disable-AzRecoveryServicesBackupProtection
       [-Item] <ItemBase>
       [-RemoveRecoveryPoints]
       [-RetainRecoveryPointsAsPerPolicy]
       [-Force]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

O cmdlet Disable-AzRecoveryServicesBackupProtection desabilita a proteção para um item protegido pelo Backup do Azure. Esse cmdlet interrompe o backup agendado regular de um item e retém para sempre. Esse cmdlet também pode excluir pontos de recuperação existentes para o item de backup se executado com o parâmetro RemoveRecoveryPoints. Esse cmdlet pode suspender o backup de um item e reter pontos de recuperação de acordo com a política de backup se usado com o parâmetro RetainRecoveryPointsAsPerPolicy. Uma condição com esse cenário é que os backups não podem ser suspensos até que a imutabilidade esteja habilitada no cofre. Para habilitar a imutabilidade em um cofre de serviços de recuperação, os pls seguem o cmdlet Update-AzRecoveryServicesVault. Defina o contexto do cofre usando o cmdlet Set-AzRecoveryServicesVaultContext antes de usar o cmdlet atual.

Exemplos

Exemplo 1: Desativar a proteção de backup

$Cont = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM
$PI = Get-AzRecoveryServicesBackupItem -Container $Cont[0] -WorkloadType AzureVM
Disable-AzRecoveryServicesBackupProtection -Item $PI[0]

O primeiro comando obtém uma matriz de contêineres de backup e, em seguida, armazena-a na matriz $Cont. O segundo comando obtém o item Backup correspondente ao primeiro item de contêiner e, em seguida, armazena-o na variável $PI. O último comando desativa a proteção de backup para o item em $PI[0], mas retém os dados.

Exemplo 2

Desabilita a proteção para um item protegido por backup. (gerado automaticamente)

Disable-AzRecoveryServicesBackupProtection -Item $PI[0] -RemoveRecoveryPoints -VaultId $vault.ID

Exemplo 3: Desativar a proteção com pontos de recuperação de retenção de acordo com a política

$item = Get-AzRecoveryServicesBackupItem -VaultId $suspendVault.ID -BackupManagementType AzureVM -WorkloadType AzureVM
Disable-AzRecoveryServicesBackupProtection -Item $item[0] -RetainRecoveryPointsAsPerPolicy -VaultId $vault.ID -Force
$item = Get-AzRecoveryServicesBackupItem -VaultId $suspendVault.ID -BackupManagementType AzureVM -WorkloadType AzureVM
 $item[0].ProtectionState

BackupsSuspended

O primeiro cmdlet busca os itens de backup do AzureVM para o cofre dos serviços de recuperação. O segundo cmdlet é usado para suspender o backup para $item[0] do cofre de serviços de recuperação. Uma condição com esse cenário é que os backups não podem ser suspensos até que a imutabilidade esteja habilitada no cofre. Para habilitar a imutabilidade em um cofre de serviços de recuperação, os pls seguem o cmdlet Update-AzRecoveryServicesVault. O terceiro e quarto comandos são usados para buscar o item de backup atualizado e seu estado de proteção. Para retomar a proteção de volta, use Enable-AzRecoveryServicesBackupProtection com o parâmetro -Item.

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Item

Especifica o item Backup para o qual esse cmdlet desabilita a proteção. Para obter um AzureRmRecoveryServicesBackupItem, use o cmdlet Get-AzRecoveryServicesBackupItem.

Type:ItemBase
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RemoveRecoveryPoints

Indica que esse cmdlet exclui pontos de recuperação existentes.

Type:SwitchParameter
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RetainRecoveryPointsAsPerPolicy

Se essa opção for usada, todos os pontos de recuperação para este item expirarão de acordo com a política de retenção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Token

Token de acesso auxiliar para autenticar operações críticas para a assinatura do resource guard

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

ItemBase

String

Saídas

JobBase