Remove-AzureStorSimpleDeviceBackup
Exclui um objeto de backup.
Observação
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
Remove-AzureStorSimpleDeviceBackup
-DeviceName <String>
-BackupId <String>
[-Force]
[-WaitForComplete]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Remove-AzureStorSimpleDeviceBackup
-DeviceName <String>
-Backup <Backup>
[-Force]
[-WaitForComplete]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
O cmdlet Remove-AzureStorSimpleDeviceBackup exclui um único objeto de backup. Se você tentar excluir um backup que já foi excluído, esse cmdlet retornará um erro.
Exemplos
Exemplo 1: Remover um backup de um dispositivo
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
Esse comando remove o backup que tem a ID especificada para o dispositivo chamado Contoso63-AppVm. O comando inicia a operação que remove o objeto Backup e retorna um objeto TaskResponse . Para ver o status da tarefa, use o cmdlet Get-AzureStorSimpleTask .
Exemplo 2: Remover o primeiro backup de um dispositivo usando sua 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
O primeiro comando obtém os backups para o dispositivo chamado Contoso63-AppVm e os armazena na variável $Backup.
O segundo comando exclui um backup do dispositivo chamado Contoso63-AppVm. O comando usa a notação de ponto padrão para se referir à propriedade InstanceId do primeiro elemento da matriz $Backup. Esse comando especifica o parâmetro WaitForComplete e, portanto, o comando aguarda até que a operação seja concluída e, em seguida, retorna um objeto TaskStatusInfo .
Exemplo 3: Remover o primeiro backup de um dispositivo usando o 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
O primeiro comando obtém os backups para o dispositivo chamado Contoso63-AppVm e os armazena na variável $Backup.
O segundo comando passa o primeiro objeto armazenado na matriz $Backup para o cmdlet atual. Esse cmdlet exclui esse backup do dispositivo chamado Contoso63-AppVm. Esse comando especifica o parâmetro WaitForComplete e, portanto, o comando aguarda até que a operação seja concluída e, em seguida, retorna um objeto TaskStatusInfo .
Parâmetros
-Backup
Especifica o objeto Backup a ser excluído. Para obter um objeto Backup , use o cmdlet Get-AzureStorSimpleDeviceBackup .
Tipo: | Backup |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-BackupId
Especifica a ID da instância de um backup a ser excluído.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeviceName
Especifica o nome do dispositivo StorSimple no qual excluir um backup.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force
Indica que esse cmdlet não solicita confirmação.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Profile
Especifica um perfil do Azure.
Tipo: | AzureSMProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WaitForComplete
Indica que esse cmdlet aguarda a conclusão da operação antes de retornar o controle ao console do Windows PowerShell.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Backup
Saídas
TaskStatusInfo, TaskResponse
Esse cmdlet retorna um objeto TaskStatusInfo se você especificar o parâmetro WaitForComplete Se você não especificar esse parâmetro, ele retornará um objeto TaskResponse.