Get-AzRecoveryServicesBackupSchedulePolicyObject

  • Referência
Módulo:
Az.RecoveryServices

Obtém um objeto de política de agendamento base.

Sintaxe

Get-AzRecoveryServicesBackupSchedulePolicyObject
   [-WorkloadType] <WorkloadType>
   [[-BackupManagementType] <BackupManagementType>]
   [-DefaultProfile <IAzureContextContainer>]
   [[-ScheduleRunFrequency] <ScheduleRunType>]
   [[-PolicySubType] <PSPolicyType>]
   [<CommonParameters>]

Description

O cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject obtém um AzureRMRecoveryServicesSchedulePolicyObject base. Esse objeto não é persistido no sistema. É um objeto temporário que você pode manipular e usar com o cmdlet New-AzRecoveryServicesBackupProtectionPolicy para criar uma nova política de proteção de backup.

Exemplos

Exemplo 1: Definir a frequência da programação como semanal

$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM" 
$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM" 
$SchPol.ScheduleRunFrequency = "Weekly"
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

O primeiro comando obtém o objeto de política de retenção e, em seguida, o armazena na variável $RetPol. O segundo comando obtém o objeto de política de agendamento e o armazena na variável $SchPol. O terceiro comando altera a frequência da política de agendamento para semanal. O último comando cria uma política de proteção de backup com o agendamento atualizado.

Exemplo 2: Definir o tempo de backup

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM" 
$SchPol.ScheduleRunTimes.RemoveAll()
$DT = Get-Date
$SchPol.ScheduleRunTimes.Add($DT.ToUniversalTime())
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

O primeiro comando obtém o objeto de política de agendamento e, em seguida, o armazena na variável $SchPol. O segundo comando remove todos os tempos de execução agendados do $SchPol. O terceiro comando obtém a data e a hora atuais e as armazena na variável $DT. O quarto comando substitui os tempos de execução agendados pela hora atual. Você só pode fazer backup do AzureVM uma vez por dia, portanto, para redefinir o tempo de backup, você deve substituir o agendamento original. O último comando cria uma política de proteção de backup usando o novo agendamento.

Exemplo 3: Obter agendamento por hora para a política de compartilhamento de arquivos

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$timeZone = Get-TimeZone
$schedulePolicy.ScheduleRunTimeZone = $timeZone.Id
$startTime = Get-Date -Date "2021-12-22T06:00:00.00+00:00"
$schedulePolicy.ScheduleWindowStartTime = $startTime.ToUniversalTime()
$schedulePolicy.ScheduleInterval = 6
$schedulePolicy.ScheduleWindowDuration = 14

O primeiro comando obtém um SchedulePolicyObject por hora base e, em seguida, armazena-o na variável $schedulePolicy. O segundo e o terceiro comandos buscam o fuso horário e atualizam o fuso horário no $schedulePolicy. O quarto e quinto comando inicializa a hora de início da janela de agendamento e atualiza o $schedulePolicy. Observe que a hora de início deve estar em UTC, mesmo que o fuso horário não seja UTC. O sexto e sétimo comando atualiza o intervalo (em horas) após o qual o backup será repetido no mesmo dia, duração (em horas) para o qual o agendamento será executado.

Exemplo 4: Obter agendamento por hora aprimorado para a política do AzureVM

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureVM -BackupManagementType AzureVM -PolicySubType Enhanced -ScheduleRunFrequency Hourly
$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "India" }
$schedulePolicy.ScheduleRunTimeZone = $timeZone.Id
$windowStartTime = (Get-Date -Date "2022-04-14T08:00:00.00+00:00").ToUniversalTime()
$schPol.HourlySchedule.WindowStartTime = $windowStartTime
$schedulePolicy.HourlySchedule.ScheduleInterval = 4
$schedulePolicy.HourlySchedule.ScheduleWindowDuration = 23

O primeiro comando obtém um SchedulePolicyObject por hora aprimorado base para WorkloadType AzureVM e, em seguida, armazena-o na variável $schedulePolicy. O segundo e terceiro comando busca o fuso horário da Índia e atualiza o fuso horário no $schedulePolicy. O quarto e quinto comando inicializa a hora de início da janela de agendamento e atualiza o $schedulePolicy. Observe que a hora de início deve estar em UTC, mesmo que o fuso horário não seja UTC. O sexto e sétimo comando atualiza o intervalo (em horas) após o qual o backup será repetido no mesmo dia, duração (em horas) para o qual o agendamento será executado.

Parâmetros

-BackupManagementType

A classe de recursos que está sendo protegida. Os valores aceitáveis para esse parâmetro são:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Tipo:Nullable<T>[BackupManagementType]
Valores aceitos:AzureVM, AzureStorage, AzureWorkload
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PolicySubType

Tipo de política de agendamento a ser buscada: Padrão, Avançado

Tipo:PSPolicyType
Valores aceitos:Standard, Enhanced
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleRunFrequency

Agendar a frequência de execução para o agendamento da política.

Tipo:ScheduleRunType
Valores aceitos:Daily, Hourly, Weekly
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkloadType

Tipo de carga de trabalho do recurso. Os valores aceitáveis para esse parâmetro são:

  • AzureVM
  • AzureFiles
  • MSSQL
Tipo:WorkloadType
Valores aceitos:AzureVM, AzureFiles, MSSQL
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

SchedulePolicyBase