New-AzAutomationSchedule

Módulo:

Az.Automation

Crea una programación de Automation.

Sintaxis

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-ExpiryTime <DateTimeOffset>]
   -WeekInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfMonth <DaysOfMonth[]>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-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-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzAutomationSchedule crea una programación en Azure Automation.

Ejemplos

Ejemplo 1: Crear una programación única en la hora local

$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

El primer comando obtiene el identificador de zona horaria del sistema y lo almacena en la variable $TimeZone. El segundo comando crea una programación que se ejecuta una vez en la fecha actual a las 11:00 p. m. en la zona horaria especificada.

Ejemplo 2: Crear una programación única en otra zona horaria

$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

El primer comando inicializa una variable $TimeZone con el valor Europe/Paris El segundo comando crea una programación que se ejecuta una vez en la fecha actual a las 23:00 UTC en la zona horaria especificada.

Nota: La programación startTime se calcula agregando el desplazamiento de zona horaria de a la StartTime proporcionada

Ejemplo 3: Crear una programación periódica

$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"

El primer comando crea un objeto date mediante el cmdlet Get-Date y, a continuación, almacena el objeto en la variable $StartDate. Especifique un tiempo que sea de al menos cinco minutos en el futuro. El segundo comando crea un objeto date mediante el cmdlet Get-Date y, a continuación, almacena el objeto en la variable $EndDate. El comando especifica una hora futura. El comando final crea una programación diaria denominada Schedule02 para comenzar en el momento almacenado en $StartDate y expirar en el momento almacenado en $EndDate.

Ejemplo 4: Crear una programación periódica 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"

El primer comando crea un objeto date mediante el cmdlet Get-Date y, a continuación, almacena el objeto en la variable $StartDate. El segundo comando crea una matriz de días de semana que contiene lunes, martes, miércoles, jueves y viernes. El comando final crea una programación diaria denominada Schedule03 que se ejecutará de lunes a viernes cada semana a las 13:00. La programación nunca expirará.

Parámetros

-AutomationAccountName

Especifica el nombre de una cuenta de Automation para la que este cmdlet crea una programación.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DayInterval

Especifica un intervalo, en días, para la programación. Si no especifica este parámetro y no especifica el parámetro OneTime, el valor predeterminado es uno (1).

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DayOfWeek

Especifica una lista de días de la semana para la programación semanal.

Tipo:	Nullable<T>[DayOfWeek]
Valores aceptados:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DayOfWeekOccurrence

Especifica la aparición de la semana dentro del mes en el que se ejecuta la programación. psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• Primero
• Segundo
• Tercero
• Cuarto
• LastDay

Tipo:	DayOfWeekOccurrence
Valores aceptados:	First, Second, Third, Fourth, Last
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DaysOfMonth

Especifica una lista de días del mes para la programación mensual.

Tipo:	DaysOfMonth[]
Valores aceptados:	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
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DaysOfWeek

Especifica una lista de días de la semana para la programación semanal.

Tipo:	DayOfWeek[]
Valores aceptados:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Especifica una descripción de la programación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ExpiryTime

Especifica la hora de expiración de una programación como un objeto DateTimeOffset. Puede especificar una cadena que se pueda convertir en una DateTimeOffset válida.

Tipo:	DateTimeOffset
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForUpdateConfiguration

Indica que este objeto schedule se usará para programar una configuración de actualización de software.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-HourInterval

Especifica un intervalo, en horas, para la programación.

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MonthInterval

Especifica un intervalo, en Meses, para la programación.

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

Especifica un nombre para la programación.

Tipo:	String
Posición:	2
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-OneTime

Especifica que el cmdlet crea una programación única.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Especifica el nombre de un grupo de recursos para el que este cmdlet crea una programación.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-StartTime

Especifica la hora de inicio de una programación como un objeto DateTimeOffset. Puede especificar una cadena que se pueda convertir en una DateTimeOffset válida. Si se proporciona el timeZone, StartTime se calcula agregando el desplazamiento de la zona horaria de entrada.

Tipo:	DateTimeOffset
Posición:	3
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-TimeZone

Especifica la zona horaria de la programación. Esta cadena puede ser el identificador de IANA o el identificador de zona horaria de Windows.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WeekInterval

Especifica un intervalo, en semanas, para la programación.

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

DateTimeOffset

SwitchParameter

Salidas

Schedule

Vínculos relacionados

• Get-AzAutomationSchedule
• Remove-AzAutomationSchedule
• Set-AzAutomationSchedule