Freigeben über

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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:ItemBase
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RemoveRecoveryPoints

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

Typ:SwitchParameter
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RetainRecoveryPointsAsPerPolicy

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Token

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VaultId

ARM-ID des Recovery Services Vault.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ItemBase

String

Ausgaben

JobBase