Freigeben über

Remove-AzureStorSimpleDeviceBackupPolicy

  • Referenz
Modul:
Azure

Entfernt eine vorhandene Sicherungsrichtlinie.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicyId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicy <BackupPolicyDetails>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureStorSimpleDeviceBackupPolicy entfernt ein vorhandenes BackupPolicy-Objekt . Nachdem Sie eine Sicherungsrichtlinie entfernt haben, werden keine weiteren Sicherungen basierend auf dieser Richtlinie ausgeführt. Dieses Cmdlet löscht auch alle Zeitpläne, die der gelöschten Richtlinie zugeordnet sind.

Beispiele

Beispiel 1: Entfernen einer Sicherungsrichtlinie

PS C:\>Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -Force
VERBOSE: ClientRequestId: b3e4d485-eae4-4cf4-a43b-815f3abcd2dd_PS
VERBOSE: ClientRequestId: a260ee98-46aa-49e0-91ac-31d4155f4cae_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: 92a9c264-90df-4345-a495-92767dd266f2_PS
695be190-ac81-4cf2-b1c5-03ef6b08d005
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
695be190-ac81-4cf2-b1c5-03ef6b08d005 for tracking the task's status

Mit diesem Befehl wird die BackupPolicy entfernt, die die Instanz-ID 00001111-aaaa-2222-bbbb-3333cccc44444 aufweist, sodass keine weiteren Sicherungen basierend auf dieser Richtlinie erstellt werden. Der Befehl löscht auch alle Zeitpläne, die dieser Richtlinie zugeordnet sind. Der Befehl startet den Vorgang, der das BackupPolicy-Objekt entfernt, und gibt dann ein TaskResponse-Objekt zurück. Verwenden Sie das Cmdlet Get-AzureStorSimpleTask , um den Status der Aufgabe anzuzeigen.

Beispiel 2: Entfernen der ersten Sicherungsrichtlinien für ein Gerät

PS C:\>$Policies = Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm"
PS C:\> Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId $Policies[0].InstanceId -Force -WaitForComplete
VERBOSE: ClientRequestId: db3b49fa-cffa-446d-ba52-daa6802e00f7_PS
VERBOSE: ClientRequestId: 70e2b56f-c2df-40d0-a1e5-d7a4d7e25962_PS
VERBOSE: About to run a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: f8eb3d4d-2c57-4fc9-9f40-79d0f2ea1b6a_PS


JobId        : 820a246e-54b6-41a9-bdd5-15d5daea9b0a
JobResult    : Succeeded
JobStatus    : Completed
ErrorCode    : 
ErrorMessage : 
JobSteps     : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep, 
               Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The job created for your remove operation has completed successfully.

Der erste Befehl ruft die Sicherungsrichtlinien für das Gerät mit dem Namen Contoso63-AppVm ab und speichert sie dann in der $Policies Variablen.

Mit dem zweiten Befehl wird die erste Sicherungsrichtlinie von Contoso63-AppVm entfernt. Der Befehl verwendet die standardmäßige Punktsyntax, um die InstanceId-Eigenschaft des ersten Elements in $Policies zu identifizieren. Dieser Befehl gibt den WaitForComplete-Parameter an, sodass der Befehl die Aufgabe abschließt, und gibt dann ein TaskStatusInfo-Objekt für die Aufgabe zurück.

Beispiel 3: Entfernen einer Sicherungsrichtlinie mithilfe der Pipeline

PS C:\>Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyName "TSQAVolume01_Default" | Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -Force -WaitForComplete
VERBOSE: ClientRequestId: 60080fb1-2f88-4c17-bfd7-21aa73440a9c_PS
VERBOSE: ClientRequestId: 04c91121-50d7-4796-9af6-fc6a7d6b6a0e_PS
VERBOSE: ClientRequestId: 47ceb37c-672f-42e8-bd19-1190925c46cd_PS
VERBOSE: ClientRequestId: cbc39757-f2cc-4cc5-93ea-4ec0fbfb0ca8_PS
VERBOSE: ClientRequestId: 3614d47a-51fc-4500-a5f1-5401301ca4e3_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: dbd7166e-1888-4b11-9af9-8d49712a8c8b_PS
702ad240-5730-4015-b051-56055bd2c2d3
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
702ad240-5730-4015-b051-56055bd2c2d3 for tracking the task's status
VERBOSE: BackupPolicy with id bfe0bf8a-2d09-4690-93da-38a4f24e9f4f found!

Dieser Befehl ruft ein BackupPolicyDetails -Objekt mithilfe von Get-AzureStorSimpleDeviceBackupPolicy ab und übergibt es dann mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet entfernt die Sicherungsrichtlinie namens TSQAVolume01_Default.

Parameter

-BackupPolicy

Gibt das zu löschende BackupPolicyDetails -Objekt an. Verwenden Sie das Cmdlet Get-AzureStorSimpleDeviceBackupPolicy, um ein BackupPolicyDetails-Objekt abzurufen.

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

-BackupPolicyId

Gibt die Instanz-ID des zu löschenden BackupPolicy-Objekts an.

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

-DeviceName

Gibt den Namen des StorSimple-Geräts an, auf dem die Sicherungsrichtlinie gelöscht werden soll.

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

-Force

Gibt an, dass dieses Cmdlet Sie nicht zur Bestätigung auffordert.

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

-Profile

Gibt ein Azure-Profil an.

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

-WaitForComplete

Gibt an, dass dieses Cmdlet auf den Abschluss des Vorgangs wartet, bevor es die Steuerung an die Windows PowerShell-Konsole zurückgibt.

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

Eingaben

BackupPolicyDetails

Dieses Cmdlet akzeptiert ein zu löschende BackupPolicyDetails-Objekt .

Ausgaben

TaskStatusInfo, TaskResponse

Dieses Cmdlet gibt ein TaskStatusInfo-Objekt zurück, wenn Sie den WaitForComplete-Parameter angeben. Wenn Sie diesen Parameter nicht angeben, wird ein TaskResponse-Objekt zurückgegeben.