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 物件。