Compartilhar via

Remove-AzureStorSimpleDeviceBackup

  • Referência
Módulo:
Azure

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.