你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Remove-AzureStorSimpleDeviceBackup

删除备份对象。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

IdentifyById (默认值)

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

IdentifyByObject

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

说明

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 的设备指定 ID 的备份。 该命令启动删除 Backup 对象的操作,然后返回 TaskResponse 对象。 若要查看任务的状态,请使用 Get-AzureStorSimpleTask cmdlet。

示例 2:使用设备的 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

第一个命令获取名为 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
默认值:None
支持通配符:False
不显示:False

参数集

IdentifyByObject
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-BackupId

指定要删除的备份的实例 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

IdentifyById
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DeviceName

指定要在其中删除备份的 StorSimple 设备的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

指示此 cmdlet 不会提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Profile

指定 Azure 配置文件。

参数属性

类型:AzureSMProfile
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WaitForComplete

指示此 cmdlet 等待操作完成,然后再将控制权返回到 Windows PowerShell 控制台。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Backup

输出

TaskStatusInfo, TaskResponse

如果指定 WaitForComplete 参数(如果未指定该参数),则此 cmdlet 返回 TaskStatusInfo 对象。如果未指定该参数,则返回 TaskResponse 对象。