New-AzureRMAutomationSchedule
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 |