New-AzAutomationSchedule
Crea una programación de Automation.
Sintaxis
ByDaily (valor predeterminado)
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
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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 1 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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).
Propiedades de parámetro
Tipo: Byte
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByDaily
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DayOfWeek
Especifica una lista de días de la semana para la programación semanal.
Propiedades de parámetro
Tipo: Nullable<T> [ DayOfWeek ]
Valor predeterminado: None Valores aceptados: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByMonthlyDayOfWeek
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: 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
Propiedades de parámetro
Tipo: DayOfWeekOccurrence
Valor predeterminado: None Valores aceptados: First, Second, Third, Fourth, Last Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByMonthlyDayOfWeek
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DaysOfMonth
Especifica una lista de días del mes para la programación mensual.
Propiedades de parámetro
Tipo: DaysOfMonth [ ]
Valor predeterminado: None 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 Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByMonthlyDaysOfMonth
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DaysOfWeek
Especifica una lista de días de la semana para la programación semanal.
Propiedades de parámetro
Tipo: DayOfWeek [ ]
Valor predeterminado: None Valores aceptados: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByWeekly
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Description
Especifica una descripción de la programación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: DateTimeOffset
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByDaily
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
ByWeekly
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
ByMonthlyDaysOfMonth
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
ByMonthlyDayOfWeek
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
ByHourly
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ForUpdateConfiguration
Indica que este objeto schedule se usará para programar una configuración de actualización de software.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-HourInterval
Especifica un intervalo, en horas, para la programación.
Propiedades de parámetro
Tipo: Byte
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByHourly
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-MonthInterval
Especifica un intervalo, en Meses, para la programación.
Propiedades de parámetro
Tipo: Byte
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByMonthlyDaysOfMonth
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
ByMonthlyDayOfWeek
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Name
Especifica un nombre para la programación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 2 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-OneTime
Especifica que el cmdlet crea una programación única.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByOneTime
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ResourceGroupName
Especifica el nombre de un grupo de recursos para el que este cmdlet crea una programación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 0 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: DateTimeOffset
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 3 Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-WeekInterval
Especifica un intervalo, en semanas, para la programación.
Propiedades de parámetro
Tipo: Byte
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
ByWeekly
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas