共用方式為


Remove-AzureStorSimpleDeviceBackup

刪除備份物件。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。

語法

Remove-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -BackupId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackup
      -DeviceName <String>
      -Backup <Backup>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

Remove-AzureStorSimpleDeviceBackup Cmdlet 會刪除單一備份物件。 如果您嘗試刪除已刪除的備份,此 Cmdlet 會傳回錯誤。

範例

範例 1:移除裝置的備份

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

此命令會移除具有名為 Contoso63-AppVm 之裝置之指定標識碼的備份。 命令會啟動移除 Backup 對象的作業,然後傳 回TaskResponse 物件。 若要查看工作的狀態,請使用 Get-AzureStorSimpleTask Cmdlet。

範例 2:使用裝置標識碼移除裝置的第一個備份

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

第一個命令會取得名為 Contoso63-AppVm 之裝置的備份,然後將備份儲存在 $Backup 變數中。

第二個命令會從名為 Contoso63-AppVm 的裝置中刪除備份。 此命令會使用標準點表示法來參考 $Backup陣列第一個專案的 InstanceId 屬性。 此命令會 指定 WaitForComplete 參數,因此命令會等候作業完成,然後傳 回 TaskStatusInfo 物件。

範例 3:使用管線移除裝置的第一個備份

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

第一個命令會取得名為 Contoso63-AppVm 之裝置的備份,然後將備份儲存在 $Backup 變數中。

第二個命令會將儲存在$Backup陣列中的第一個對象傳遞至目前的 Cmdlet。 該 Cmdlet 會從名為 Contoso63-AppVm 的裝置中刪除該備份。 此命令會 指定 WaitForComplete 參數,因此命令會等候作業完成,然後傳 回 TaskStatusInfo 物件。

參數

-Backup

指定要刪除的 Backup 物件。 若要取得 Backup 物件,請使用 Get-AzureStorSimpleDeviceBackup Cmdlet。

類型:Backup
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-BackupId

指定要刪除之備份的實例標識碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DeviceName

指定要刪除備份的 StorSimple 裝置名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Force

表示此 Cmdlet 不會提示您進行確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Profile

指定 Azure 設定檔。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WaitForComplete

表示此 Cmdlet 會先等候作業完成,再將控制權傳回 Windows PowerShell 控制台。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Backup

輸出

TaskStatusInfo, TaskResponse

如果您指定 WaitForComplete 參數如果您未指定該參數,此 Cmdlet 會傳回 TaskStatusInfo 物件,它會傳回 TaskResponse 物件。