Remove-AzureStorSimpleDeviceBackup

  • Referenz
Modul:
Azure

Löscht ein Sicherungsobjekt.

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-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -BackupId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -Backup <Backup>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureStorSimpleDeviceBackup löscht ein einzelnes Sicherungsobjekt. Wenn Sie versuchen, eine bereits gelöschte Sicherung zu löschen, gibt dieses Cmdlet einen Fehler zurück.

Beispiele

Beispiel 1: Entfernen einer Sicherung für ein Gerät

PS C:\>Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -BackupId "dcb5c991-0485-400f-8d0a-03a1341ee989" -Force
The remove job is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId 6c73aff2-f5a1-4b5e-
9a4e-857e128dc216 for tracking the job status

Mit diesem Befehl wird die Sicherung entfernt, die die angegebene ID für das Gerät namens "Contoso63-AppVm" aufweist. Der Befehl startet den Vorgang, der das Sicherungsobjekt 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 Sicherung für ein Gerät mithilfe ihrer ID

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm"
PS C:\> Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso63-AppVm" -BackupId $Backup[0].InstanceId -WaitForComplete
Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 53a656c3-c082-4e1f-afb7-bff3db45c791
JobSteps   : {}
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : f4411f38d07f68b88095682dbeedd9e9

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

Der zweite Befehl löscht eine Sicherung vom Gerät namens Contoso63-AppVm. Der Befehl verwendet die Standardmäßige Punktnotation, um auf die InstanceId-Eigenschaft des ersten Elements des $Backup Arrays zu verweisen. Dieser Befehl gibt den WaitForComplete-Parameter an, und daher wartet der Befehl, bis der Vorgang abgeschlossen ist, und gibt dann ein TaskStatusInfo -Objekt zurück.

Beispiel 3: Entfernen der ersten Sicherung für ein Gerät mithilfe der Pipeline

PS C:\>$Backup = Get-AzureStorSimpleDeviceBackup -DeviceName "Contoso-AppVm" -WaitForComplete
PS C:\> $Backup[0] | Remove-AzureStorSimpleDeviceBackup -DeviceName "Contoso-AppVm" -Force -WaitForComplete
Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 48059fd8-e355-4b91-9385-630d24f31df6
JobSteps   : {}
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : e1753f3bf68e6e44ab719436b5111e41

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

Der zweite Befehl übergibt das erste Objekt, das im $Backup Array gespeichert ist, an das aktuelle Cmdlet. Dieses Cmdlet löscht diese Sicherung vom Gerät namens Contoso63-AppVm. Dieser Befehl gibt den WaitForComplete-Parameter an, und daher wartet der Befehl, bis der Vorgang abgeschlossen ist, und gibt dann ein TaskStatusInfo -Objekt zurück.

Parameter

-Backup

Gibt das zu löschende Sicherungsobjekt an. Verwenden Sie zum Abrufen eines Sicherungsobjekts das Cmdlet Get-AzureStorSimpleDeviceBackup .

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

-BackupId

Gibt die Instanz-ID einer zu löschenden Sicherung 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 eine Sicherung 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

Backup

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.