Partilhar via

Set-AzureStorSimpleDeviceBackupPolicy

  • Referência
Módulo:
Azure

Atualiza uma política de backup existente.

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.

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

Este comando altera o nome da política de backup que tem a ID especificada para UpdatedGeneralPolicy07. Este comando especifica o parâmetro WaitForComplete para que o comando conclua a tarefa e, em seguida, 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 em $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 o cronograma atualizado armazenado em $UpdateArray.

Parâmetros

-BackupPolicyId

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackupPolicyName

Especifica um novo nome para a política de backup.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackupScheduleIdsToDelete

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

Tipo:PSObject[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackupSchedulesToUpdate

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

Tipo:PSObject[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeviceName

Especifica o nome do dispositivo StorSimple para o qual atualizar a política de backup.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NewName

Especifica um nome para o dispositivo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

Especifica um perfil do Azure.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VolumeIdsToUpdate

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

Tipo:PSObject[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

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 .