Disable-AzRecoveryServicesBackupProtection

  • Referenz
Modul:
Az.RecoveryServices

Deaktiviert den Schutz für ein sicherungsgeschütztes Element.

Syntax

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

Beschreibung

Mit dem Cmdlet Disable-AzRecoveryServicesBackupProtection wird der Schutz für ein durch Azure Backup geschütztes Element deaktiviert. Mit diesem Cmdlet wird die regelmäßige geplante Sicherung eines Elements beendet und für immer beibehalten. Dieses Cmdlet kann auch vorhandene Wiederherstellungspunkte für das Sicherungselement löschen, wenn es mit dem Parameter RemoveRecoveryPoints ausgeführt wird. Dieses Cmdlet kann die Sicherung eines Elements anhalten und Wiederherstellungspunkte gemäß Sicherungsrichtlinie beibehalten, wenn es mit dem Parameter "RetainRecoveryPointsAsPerPolicy" verwendet wird. Eine Bedingung bei diesem Szenario besteht darin, dass Sicherungen erst angehalten werden können, wenn die Unveränderlichkeit im Tresor aktiviert ist. Um die Unveränderlichkeit für einen Wiederherstellungsdiensttresor zu aktivieren, folgen pls dem Cmdlet Update-AzRecoveryServicesVault. Legen Sie den Tresorkontext mithilfe des Cmdlets Set-AzRecoveryServicesVaultContext fest, bevor Sie das aktuelle Cmdlet verwenden.

Beispiele

Beispiel 1: Deaktivieren des Sicherungsschutzes

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

Der erste Befehl ruft ein Array von Sicherungscontainern ab und speichert es dann im $Cont Array. Der zweite Befehl ruft das Sicherungselement ab, das dem ersten Containerelement entspricht, und speichert es dann in der variablen $PI. Der letzte Befehl deaktiviert den Sicherungsschutz für das Element in $PI[0], behält die Daten jedoch bei.

Beispiel 2

Deaktiviert den Schutz für ein sicherungsgeschütztes Element. (automatisch generiert)

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

Beispiel 3: Deaktivieren des Schutzes mit Beibehaltung von Wiederherstellungspunkten gemäß Richtlinie

$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

Das erste Cmdlet ruft die AzureVM-Sicherungselemente für den Wiederherstellungsdiensttresor ab. Das zweite Cmdlet wird zum Anhalten der Sicherung für $item[0] des Wiederherstellungsdienstetress verwendet. Eine Bedingung bei diesem Szenario besteht darin, dass Sicherungen erst angehalten werden können, wenn die Unveränderlichkeit im Tresor aktiviert ist. Um die Unveränderlichkeit für einen Wiederherstellungsdiensttresor zu aktivieren, folgen pls dem Cmdlet Update-AzRecoveryServicesVault. Der dritte und vierte Befehl werden verwendet, um das aktualisierte Sicherungselement und dessen Schutzstatus abzurufen. Verwenden Sie "Enable-AzRecoveryServicesBackupProtection" mit dem Parameter "-Item", um den Schutz wieder aufzunehmen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-Item

Gibt das Sicherungselement an, für das dieses Cmdlet den Schutz deaktiviert. Verwenden Sie das Cmdlet "Get-AzRecoveryServicesBackupItem", um ein AzureRmRecoveryServicesBackupItem-Objekt abzurufen.

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

-RemoveRecoveryPoints

Gibt an, dass dieses Cmdlet vorhandene Wiederherstellungspunkte löscht.

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

-RetainRecoveryPointsAsPerPolicy

Wenn diese Option verwendet wird, laufen alle Wiederherstellungspunkte für dieses Element gemäß der Aufbewahrungsrichtlinie ab.

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

-Token

Zusätzliches Zugriffstoken für die Authentifizierung kritischer Vorgänge für das Resource Guard-Abonnement

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

-VaultId

ARM-ID des Recovery Services Vault.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

ItemBase

String

Ausgaben

JobBase