Remove-AzureStorSimpleDeviceBackup

Referência

Módulo:: Azure

Exclui um objeto de backup.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

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 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, em seguida, 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, em seguida, 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 .

Type:	Backup
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-BackupId

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Especifica um perfil do Azure.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Get-AzureStorSimpleDeviceBackup