Remove-AzureStorSimpleDeviceBackupPolicy

  • Referência
Módulo:
Azure

Remove uma política de backup existente.

Observação

Os cmdlets referenciados 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, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

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

Sintaxe

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 todos os agendamentos associados à política excluída.

Exemplos

Exemplo 1: Remover uma política de backup

PS C:\>Remove-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -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 00001111-aaaa-2222-bbbb-3333cccc4444, para que nenhum outro backup seja feito com base nessa política. O comando também exclui todos os agendamentos associados a essa política. O comando inicia a operação que remove o objeto BackupPolicy e, em seguida, 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, em seguida, armazena-as 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, em seguida, 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, em seguida, 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 .

Tipo:BackupPolicyDetails
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-BackupPolicyId

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

BackupPolicyDetails

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

Saídas

TaskStatusInfo, TaskResponse

Esse cmdlet retornará um objeto TaskStatusInfo se você especificar o parâmetro WaitForComplete . Se você não especificar esse parâmetro, ele retornará um objeto TaskResponse .