Partilhar via

Remove-AzureStorSimpleDeviceBackup

  • Referência
Módulo:
Azure

Exclui um objeto de backup.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Syntax

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 uma cópia de segurança 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

Este 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, em seguida, armazena-os na variável $Backup.

O segundo comando exclui um backup do dispositivo chamado Contoso63-AppVm. O comando usa notação de ponto padrão para se referir à propriedade InstanceId do primeiro elemento da matriz $Backup. Este 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, em seguida, armazena-os 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. Este 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
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-BackupId

Especifica o ID da instância de um backup a ser excluído.

Tipo:String
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

Especifica o nome do dispositivo StorSimple no qual excluir um backup.

Tipo:String
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Indica que esse cmdlet não solicita confirmação.

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Especifica um perfil do Azure.

Tipo:AzureSMProfile
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Backup

Saídas

TaskStatusInfo, TaskResponse

Este 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.