New-AzAutomationSchedule
Cria um agendamento de Automação.
Sintaxe
ByDaily (Default)
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-DayInterval <Byte>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByWeekly
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-WeekInterval <Byte>
[-Description <String>]
[-DaysOfWeek <DayOfWeek[]>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByMonthlyDaysOfMonth
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-MonthInterval <Byte>
[-Description <String>]
[-DaysOfMonth <DaysOfMonth[]>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByMonthlyDayOfWeek
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-MonthInterval <Byte>
[-Description <String>]
[-DayOfWeek <DayOfWeek>]
[-DayOfWeekOccurrence <DayOfWeekOccurrence>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByOneTime
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-Description <String>]
[-OneTime]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByHourly
New-AzAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
-HourInterval <Byte>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet New-AzAutomationSchedule cria um agendamento na Automação do Azure.
Exemplos
Exemplo 1: criar um agendamento único no horário local
$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
O primeiro comando obtém a ID do fuso horário do sistema e a armazena na variável $TimeZone.
O segundo comando cria um agendamento que é executado uma vez na data atual às 23h no fuso horário especificado.
Exemplo 2: criar um agendamento único em outro fuso horário
$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone
O primeiro comando inicializa uma variável $TimeZone com valor Europe/Paris O segundo comando cria um agendamento que é executado uma vez na data atual às 23:00 UTC no fuso horário especificado.
Observação: Schedule StartTime é calculado adicionando o Deslocamento de Fuso Horário ao StartTime fornecido
Exemplo 3: Criar um agendamento recorrente
$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"
O primeiro comando cria um objeto de data usando o cmdlet Get-Date e armazena o objeto na variável $StartDate.
Especifique um tempo que seja de pelo menos cinco minutos no futuro.
O segundo comando cria um objeto de data usando o cmdlet Get-Date e armazena o objeto na variável $EndDate.
O comando especifica uma hora futura.
O comando final cria uma agenda diária chamada Schedule02 para começar no momento armazenado em $StartDate e expirar no momento armazenado em $EndDate.
Exemplo 4: Criar um agendamento recorrente semanal
$StartTime = (Get-Date "13:00:00").AddDays(1)
[System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime -WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"
O primeiro comando cria um objeto de data usando o cmdlet Get-Date e armazena o objeto na variável $StartDate.
O segundo comando cria uma matriz de dias de semana que contém segunda, terça, quarta, quinta e sexta-feira.
O comando final cria uma agenda diária chamada Schedule03 que será executada de segunda a sexta-feira a cada semana às 13:00. A agenda nunca expirará.
Parâmetros
-AutomationAccountName
Especifica o nome de uma conta de Automação para a qual esse cmdlet cria um agendamento.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-DayInterval
Especifica um intervalo, em dias, para o agendamento.
Se você não especificar esse parâmetro e não especificar o parâmetro OneTime , o valor padrão será um (1).
Propriedades do parâmetro
Tipo: Byte
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByDaily
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DayOfWeek
Especifica uma lista de dias da semana para o agendamento semanal.
Propriedades do parâmetro
Tipo: Nullable<T> [ DayOfWeek ]
Valor padrão: None Valores aceitos: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByMonthlyDayOfWeek
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DayOfWeekOccurrence
Especifica a ocorrência da semana no mês em que o agendamento é executado.
psdx_paramvalues
1
2
3
4
-1
Primeiro
Segundo
Terceiro
Quarto
LastDay
Propriedades do parâmetro
Tipo: DayOfWeekOccurrence
Valor padrão: None Valores aceitos: First, Second, Third, Fourth, Last Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByMonthlyDayOfWeek
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DaysOfMonth
Especifica uma lista de dias do mês para a agenda mensal.
Propriedades do parâmetro
Tipo: DaysOfMonth [ ]
Valor padrão: None Valores aceitos: One, Two, Three, Four, Five, Six, Seventh, Eighth, Ninth, Tenth, Eleventh, Twelfth, Thirteenth, Fourteenth, Fifteenth, Sixteenth, Seventeenth, Eighteenth, Nineteenth, Twentieth, TwentyFirst, TwentySecond, TwentyThird, TwentyFourth, TwentyFifth, TwentySixth, TwentySeventh, TwentyEighth, TwentyNinth, Thirtieth, ThirtyFirst, LastDay Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByMonthlyDaysOfMonth
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DaysOfWeek
Especifica uma lista de dias da semana para o agendamento semanal.
Propriedades do parâmetro
Tipo: DayOfWeek [ ]
Valor padrão: None Valores aceitos: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByWeekly
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Description
Especifica uma descrição para o agendamento.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ExpiryTime
Especifica a hora de expiração de um agendamento como um objeto DateTimeOffset .
Você pode especificar uma cadeia de caracteres que pode ser convertida em um DateTimeOffset válido.
Propriedades do parâmetro
Tipo: DateTimeOffset
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByDaily
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ByWeekly
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ByMonthlyDaysOfMonth
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ByMonthlyDayOfWeek
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ByHourly
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ForUpdateConfiguration
Indica que esse objeto de agendamento será usado para agendar uma configuração de atualização de software
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-HourInterval
Especifica um intervalo, em horas, para o agendamento.
Propriedades do parâmetro
Tipo: Byte
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByHourly
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-MonthInterval
Especifica um intervalo, em Meses, para o agendamento.
Propriedades do parâmetro
Tipo: Byte
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByMonthlyDaysOfMonth
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ByMonthlyDayOfWeek
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Name
Especifica um nome para o agendamento.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-OneTime
Especifica que o cmdlet cria um agendamento único.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByOneTime
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
Especifica o nome de um grupo de recursos para o qual esse cmdlet cria um agendamento.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-StartTime
Especifica a hora de início de um agendamento como um objeto DateTimeOffset .
Você pode especificar uma cadeia de caracteres que pode ser convertida em um DateTimeOffset válido.
Se o Fuso Horário for fornecido, StartTime será calculado adicionando o Deslocamento do Fuso Horário de Entrada.
Propriedades do parâmetro
Tipo: DateTimeOffset
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-TimeZone
Especifica o fuso horário para o agendamento.
Essa cadeia de caracteres pode ser a ID IANA ou a ID do Fuso Horário do Windows.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-WeekInterval
Especifica um intervalo, em semanas, para o agendamento.
Propriedades do parâmetro
Tipo: Byte
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ByWeekly
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
