Partilhar via

New-AzAutomationSchedule

Módulo:
Az.Automation Module

Cria uma agenda de automação.

Sintaxe

ByDaily (Padrão) 

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>]

Descrição

O cmdlet New-AzAutomationSchedule cria uma agenda na Automação do Azure.

Exemplos

Exemplo 1: Criar um horário único na hora 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 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 programação única 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 uma agenda que é executada uma vez na data atual às 23:00 UTC no fuso horário especificado.

Nota: Schedule StartTime é calculado adicionando o TimeZone Offset ao StartTime fornecido

Exemplo 3: Criar uma agenda 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 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 4: Criar uma agenda 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 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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes: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).

Propriedades dos parâmetros

Tipo:Byte
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByDaily
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DayOfWeek

Especifica uma lista de dias da semana para a programação semanal.

Propriedades dos parâmetros

Tipo:

Nullable<T>[DayOfWeek]

Valor padrão:None
Valores aceites:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByMonthlyDayOfWeek
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes: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
  • Quarto
  • Último Dia

Propriedades dos parâmetros

Tipo:DayOfWeekOccurrence
Valor padrão:None
Valores aceites:First, Second, Third, Fourth, Last
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByMonthlyDayOfWeek
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DaysOfMonth

Especifica uma lista de dias do mês para a programação mensal.

Propriedades dos parâmetros

Tipo:

DaysOfMonth[]

Valor padrão:None
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
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByMonthlyDaysOfMonth
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DaysOfWeek

Especifica uma lista de dias da semana para a programação semanal.

Propriedades dos parâmetros

Tipo:

DayOfWeek[]

Valor padrão:None
Valores aceites:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByWeekly
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica uma descrição para a agenda.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ExpiryTime

Especifica a hora de expiração de uma agenda como um objeto DateTimeOffset . Você pode especificar uma cadeia de caracteres que pode ser convertida em um DateTimeOffset válido.

Propriedades dos parâmetros

Tipo:DateTimeOffset
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByDaily
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ByWeekly
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ByMonthlyDaysOfMonth
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ByMonthlyDayOfWeek
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ByHourly
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-HourInterval

Especifica um intervalo, em horas, para a agenda.

Propriedades dos parâmetros

Tipo:Byte
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByHourly
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-MonthInterval

Especifica um intervalo, em Meses, para a agenda.

Propriedades dos parâmetros

Tipo:Byte
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByMonthlyDaysOfMonth
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
ByMonthlyDayOfWeek
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica um nome para a agenda.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-OneTime

Especifica que o cmdlet cria uma agenda única.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByOneTime
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome de um grupo de recursos para o qual esse cmdlet cria uma agenda.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes: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 Fuso Horário for fornecido, StartTime será calculado adicionando o Deslocamento do Fuso Horário de Entrada.

Propriedades dos parâmetros

Tipo:DateTimeOffset
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WeekInterval

Especifica um intervalo, em semanas, para a agenda.

Propriedades dos parâmetros

Tipo:Byte
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ByWeekly
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por 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.

Entradas

String

DateTimeOffset

SwitchParameter

Saídas

Schedule