New-AzureRMAutomationSchedule
Cria uma agenda de automação.
Aviso
O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Sintaxe
New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
-DayInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfWeek <DayOfWeek[]>]
[-ExpiryTime <DateTimeOffset>]
-WeekInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfMonth <DaysOfMonth[]>]
[-ExpiryTime <DateTimeOffset>]
-MonthInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DayOfWeek <DayOfWeek>]
[-DayOfWeekOccurrence <DayOfWeekOccurrence>]
[-ExpiryTime <DateTimeOffset>]
-MonthInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-OneTime]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
-HourInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
O cmdlet New-AzureRmAutomationSchedule cria uma agenda na Automação do Azure.
Exemplos
Exemplo 1: Criar um horário único na hora local
PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZoneO primeiro comando obtém o ID de fuso horário do sistema e o armazena na variável $TimeZone. O segundo comando cria uma agenda que é executada uma vez na data atual às 23:00 no fuso horário especificado..
Exemplo 2: Criar uma agenda recorrente
PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"O primeiro comando cria um objeto date usando o cmdlet Get-Date e, em seguida, 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 date usando o cmdlet Get-Date e, em seguida, 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 horário armazenado no $StartDate e expirar no momento armazenado no $EndDate.
Exemplo 3: Criar uma agenda recorrente semanal
PS C:\> $StartTime = (Get-Date "13:00:00").AddDays(1)
PS C:\> [System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime - WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"O primeiro comando cria um objeto date usando o cmdlet Get-Date e, em seguida, armazena o objeto na variável $StartDate. O segundo comando cria uma matriz de dias da semana que contém segunda-feira, terça-feira, quarta-feira, quinta-feira e sexta-feira. O comando final cria uma programação diária chamada Schedule03 que será executada de segunda a sexta-feira todas as semanas às 13:00. O cronograma nunca expirará.
Parâmetros
-AutomationAccountName
Especifica o nome de uma conta de automação para a qual esse cmdlet cria uma agenda.
| Tipo: | String |
| Position: | 1 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DayInterval
Especifica um intervalo, em dias, para a agenda. Se você não especificar esse parâmetro e não especificar o parâmetro OneTime , o valor padrão será um (1).
| Tipo: | Byte |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DayOfWeek
Especifica uma lista de dias da semana para a programação semanal.
| Tipo: | Nullable<T>[DayOfWeek] |
| Valores aceites: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DayOfWeekOccurrence
Especifica a ocorrência da semana dentro do mês em que a agenda é executada. psdx_paramvalues
- 1
- 2
- 3
- 4
- -1
- First
- Second
- Terceiro
- Quarta
- Último Dia
| Tipo: | DayOfWeekOccurrence |
| Valores aceites: | First, Second, Third, Fourth, Last |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DaysOfMonth
Especifica uma lista de dias do mês para a programação mensal.
| Tipo: | DaysOfMonth[] |
| Valores aceites: | 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DaysOfWeek
Especifica uma lista de dias da semana para a programação semanal.
| Tipo: | DayOfWeek[] |
| Valores aceites: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Description
Especifica uma descrição para a agenda.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-ExpiryTime
Especifica a hora de expiração de uma agenda como um objeto DateTimeOffest . Você pode especificar uma cadeia de caracteres que pode ser convertida em um DateTimeOffset válido.
| Tipo: | DateTimeOffset |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ForUpdateConfiguration
Indica que esse objeto de agendamento será usado para agendar uma configuração de atualização de software
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-HourInterval
Especifica um intervalo, em horas, para a agenda.
| Tipo: | Byte |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-MonthInterval
Especifica um intervalo, em Meses, para a agenda.
| Tipo: | Byte |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Name
Especifica um nome para a agenda.
| Tipo: | String |
| Position: | 2 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-OneTime
Especifica que o cmdlet cria uma agenda única.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ResourceGroupName
Especifica o nome de um grupo de recursos para o qual esse cmdlet cria uma agenda.
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-StartTime
Especifica a hora de início de uma agenda como um objeto DateTimeOffset . Você pode especificar uma cadeia de caracteres que pode ser convertida em um DateTimeOffset válido. Se o parâmetro TimeZone for especificado, o deslocamento será ignorado e o fuso horário especificado será usado.
| Tipo: | DateTimeOffset |
| Position: | 3 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-TimeZone
Especifica o fuso horário para a agenda. Essa cadeia de caracteres pode ser a ID IANA ou a ID de Fuso Horário do Windows.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-WeekInterval
Especifica um intervalo, em semanas, para a agenda.
| Tipo: | Byte |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |