New-AzureRMAutomationSchedule

Módulo:

AzureRM.Automation

Crea una programación de Automation.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

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

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

Ejemplos

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

PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -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 periódica

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"

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

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.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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).

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DayOfWeek

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

Type:	Nullable<T>[DayOfWeek]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	DayOfWeekOccurrence
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfMonth

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

Type:	DaysOfMonth[]
Accepted values:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfWeek

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

Type:	DayOfWeek[]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Especifica una descripción de la programación.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExpiryTime

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

Type:	DateTimeOffset
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForUpdateConfiguration

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-HourInterval

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

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthInterval

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

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifica un nombre para la programación.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OneTime

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 especifica el parámetro TimeZone , se omitirá el desplazamiento y se usará la zona horaria especificada.

Type:	DateTimeOffset
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WeekInterval

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

Type:	Byte
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

DateTimeOffset

Salidas

Schedule

Vínculos relacionados

• Get-AzureRmAutomationSchedule
• Remove-AzureRmAutomationSchedule
• Set-AzureRmAutomationSchedule