Set-AzureStorSimpleDeviceBackupPolicy

  • Referência
Módulo:
Azure

Atualiza uma política de backup existente.

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

Set-AzureStorSimpleDeviceBackupPolicy
   -DeviceName <String>
   -BackupPolicyId <String>
   -BackupPolicyName <String>
   [-BackupSchedulesToAdd <PSObject[]>]
   [-BackupSchedulesToUpdate <PSObject[]>]
   [-BackupScheduleIdsToDelete <PSObject[]>]
   [-VolumeIdsToUpdate <PSObject[]>]
   [-WaitForComplete]
   [-NewName <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureStorSimpleDeviceBackupPolicy atualiza uma política de backup existente. Você pode renomear a política, adicionar, atualizar ou excluir agendas e atualizar os volumes associados à política.

Exemplos

Exemplo 1: Alterar o nome de uma política de backup

PS C:\>Set-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -BackupPolicyName "UpdatedGeneralPolicy07" -WaitForComplete
VERBOSE: ClientRequestId: f4465b46-26cc-40ff-88da-7a28df88c35c_PS
VERBOSE: ClientRequestId: 5e33a35c-e089-47c1-b760-474635b1ead8_PS
VERBOSE: About to run a task to update your backuppolicy! 
VERBOSE: ClientRequestId: e379ebdb-667f-45a9-aafa-a6cd61e5f6f6_PS


JobId        : 9d621bfd-3faa-4d1c-b28b-45c5f4a96975
JobResult    : Succeeded
JobStatus    : Completed
ErrorCode    : 
ErrorMessage : 
JobSteps     : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The job created for your update operation has completed successfully. 
VERBOSE: ClientRequestId: 4fe965ea-4e12-4869-9d67-e42a24b6c5d8_PS
BackupSchedules          : {58e9cd7c-4c6a-4e33-9109-5ec0b8fcb2cc, b10e1bf4-ef0a-4ad3-8fde-eecfc9971dd2}
Volumes                  : {testvolume03}
BackupPolicyCreationType : BySaaS
LastBackup               : 12/16/2014 2:13:28 PM
NextBackup               : 12/16/2014 3:13:43 PM
SchedulesCount           : 2
SSMHostName              : 
VolumesCount             : 1
InstanceId               : 00001111-aaaa-2222-bbbb-3333cccc4444
Name                     : UpdatedGeneralPolicy07
OperationInProgress      : None

Esse comando altera o nome da diretiva de backup que tem a ID especificada para UpdatedGeneralPolicy07. Esse comando especifica o parâmetro WaitForComplete , portanto, o comando conclui a tarefa e retorna um objeto TaskStatusInfo para a tarefa.

Exemplo 2: Atualizar o agendamento de uma política de backup

PS C:\>$UpdateConfig = New-AzureStorSimpleDeviceBackupScheduleUpdateConfig -Id "3a6c6247-6b4d-42e2-aa87-16f4f21476ea" -BackupType CloudSnapshot -RecurrenceType Daily -RecurrenceValue 3 -RetentionCount 2 -Enabled $True
PS C:\> $UpdateArray = @()
PS C:\> $UpdateArray += $UpdateConfig
PS C:\> Set-AzureStorSimpleDeviceBackupPolicy -DeviceName "Contoso63-AppVm" -BackupPolicyId "00001111-aaaa-2222-bbbb-3333cccc4444" -BackupSchedulesToUpdate $UpdateArray
Error      : Microsoft.WindowsAzure.Management.StorSimple.Models.ErrorDetails
JobId      : 7b265417-a5f1-45ad-8fbc-33bad4f63ec9
JobSteps   : {Microsoft.WindowsAzure.Management.StorSimple.Models.JobStep, 
             Microsoft.WindowsAzure.Management.StorSimple.Models.JobStep, 
             Microsoft.WindowsAzure.Management.StorSimple.Models.JobStep, 
             Microsoft.WindowsAzure.Management.StorSimple.Models.JobStep...} 
Result     : Succeeded
Status     : Completed
TaskResult : Succeeded
StatusCode : OK
RequestId  : d2e10d44e699b371a84db44d19daf1c3

O primeiro comando cria um objeto de configuração de atualização usando o cmdlet New-AzureStorSimpleDeviceBackupScheduleUpdateConfig e o armazena na variável $UpdateConfig.

O segundo comando cria uma nova variável de matriz, chamada $UpdateArray. O próximo comando adiciona a atualização armazenada no $UpdateConfig a essa matriz. Você pode adicionar mais de uma atualização à matriz.

O comando final atualiza a política de backup que tem a ID especificada no dispositivo chamado Contoso63-AppVm. A política agora tem a agenda atualizada armazenada em $UpdateArray.

Parâmetros

-BackupPolicyId

Especifica a ID da instância do objeto BackupPolicy a ser atualizado.

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

-BackupPolicyName

Especifica um novo nome para 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

-BackupScheduleIdsToDelete

Especifica uma matriz de IDs de instância de objetos BackupSchedule a serem excluídos.

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

-BackupSchedulesToAdd

Especifica uma matriz de objetos BackupScheduleBase a serem adicionados à política. Para obter um objeto BackupScheduleBase , use o cmdlet New-AzureStorSimpleDeviceBackupScheduleAddConfig .

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

-BackupSchedulesToUpdate

Especifica uma matriz de objetos BackupScheduleUpdateRequest a serem atualizados. Para obter um objeto BackupScheduleUpdateRequest , use o cmdlet New-AzureStorSimpleDeviceBackupScheduleUpdateConfig .

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

-DeviceName

Especifica o nome do dispositivo StorSimple para o qual atualizar a diretiva de backup.

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

-NewName

Especifica um nome para o dispositivo.

Tipo:String
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

-VolumeIdsToUpdate

Especifica uma matriz de IDs de volumes para os quais atualizar as políticas de backup.

Tipo:PSObject[]
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

None

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 .