Remove-AzureStorSimpleDeviceBackupPolicy

  • Referência
Módulo:
Azure

Remove uma política de backup existente.

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-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicyId <String>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]
Remove-AzureStorSimpleDeviceBackupPolicy
      -DeviceName <String>
      -BackupPolicy <BackupPolicyDetails>
      [-Force]
      [-WaitForComplete]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

O cmdlet Remove-AzureStorSimpleDeviceBackupPolicy remove um objeto BackupPolicy existente. Depois de remover uma política de backup, nenhum outro backup ocorrerá com base nessa política. Esse cmdlet também exclui todas as agendas associadas à política excluída.

Exemplos

Exemplo 1: Remover uma política de backup

PS C:\>Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "03710b4c-82c1-40ca-be5c-40289dc49642" -Force
VERBOSE: ClientRequestId: b3e4d485-eae4-4cf4-a43b-815f3abcd2dd_PS
VERBOSE: ClientRequestId: a260ee98-46aa-49e0-91ac-31d4155f4cae_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: 92a9c264-90df-4345-a495-92767dd266f2_PS
695be190-ac81-4cf2-b1c5-03ef6b08d005
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
695be190-ac81-4cf2-b1c5-03ef6b08d005 for tracking the task's status

Esse comando remove o BackupPolicy que tem o ID da instância 03710b4c-82c1-40ca-be5c-40289dc49642, para que não sejam feitos mais backups com base nessa política. O comando também exclui todas as agendas associadas a essa política. O comando inicia a operação que remove o objeto BackupPolicy e retorna um objeto TaskResponse . Para ver o status da tarefa, use o cmdlet Get-AzureStorSimpleTask .

Exemplo 2: Remover a primeira das políticas de backup de um dispositivo

PS C:\>$Policies = Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm"
PS C:\> Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId $Policies[0].InstanceId -Force -WaitForComplete
VERBOSE: ClientRequestId: db3b49fa-cffa-446d-ba52-daa6802e00f7_PS
VERBOSE: ClientRequestId: 70e2b56f-c2df-40d0-a1e5-d7a4d7e25962_PS
VERBOSE: About to run a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: f8eb3d4d-2c57-4fc9-9f40-79d0f2ea1b6a_PS


JobId        : 820a246e-54b6-41a9-bdd5-15d5daea9b0a
JobResult    : Succeeded
JobStatus    : Completed
ErrorCode    : 
ErrorMessage : 
JobSteps     : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep, 
               Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The job created for your remove operation has completed successfully.

O primeiro comando obtém as políticas de backup para o dispositivo chamado Contoso63-AppVm e as armazena na variável $Policies.

O segundo comando remove a primeira política de backup de Contoso63-AppVm. O comando usa a sintaxe de ponto padrão para identificar a propriedade InstanceId do primeiro item em $Policies. Esse comando especifica o parâmetro WaitForComplete, portanto, o comando conclui a tarefa e retorna um objeto TaskStatusInfo para a tarefa.

Exemplo 3: Remover uma política de backup usando o pipeline

PS C:\>Get-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyName "TSQAVolume01_Default" | Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -Force -WaitForComplete
VERBOSE: ClientRequestId: 60080fb1-2f88-4c17-bfd7-21aa73440a9c_PS
VERBOSE: ClientRequestId: 04c91121-50d7-4796-9af6-fc6a7d6b6a0e_PS
VERBOSE: ClientRequestId: 47ceb37c-672f-42e8-bd19-1190925c46cd_PS
VERBOSE: ClientRequestId: cbc39757-f2cc-4cc5-93ea-4ec0fbfb0ca8_PS
VERBOSE: ClientRequestId: 3614d47a-51fc-4500-a5f1-5401301ca4e3_PS
VERBOSE: About to create a job to remove your backuppolicy! 
VERBOSE: ClientRequestId: dbd7166e-1888-4b11-9af9-8d49712a8c8b_PS
702ad240-5730-4015-b051-56055bd2c2d3
VERBOSE: The remove task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
702ad240-5730-4015-b051-56055bd2c2d3 for tracking the task's status
VERBOSE: BackupPolicy with id bfe0bf8a-2d09-4690-93da-38a4f24e9f4f found!

Esse comando obtém um objeto BackupPolicyDetails usando Get-AzureStorSimpleDeviceBackupPolicy e o passa para o cmdlet atual usando o operador de pipeline. O cmdlet atual remove a política de backup chamada TSQAVolume01_Default.

Parâmetros

-BackupPolicy

Especifica o objeto BackupPolicyDetails a ser excluído. Para obter um objeto BackupPolicyDetails , use o cmdlet Get-AzureStorSimpleDeviceBackupPolicy .

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

-BackupPolicyId

Especifica a ID da instância do objeto BackupPolicy 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 a diretiva de 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

BackupPolicyDetails

Esse cmdlet aceita um objeto BackupPolicyDetails a ser excluído.

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 .