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: Schedule StartTime se calcula agregando el desplazamiento de zona horaria a startTime proporcionado .

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
• Cuarta
• 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 un valor DateTimeOffset válido.

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 un valor DateTimeOffset válido. Si se proporciona 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