New-CMSchedule
Cree un token de programación de Configuration Manager.
Syntax
New-CMSchedule
[-IsUtc]
[-Nonrecurring]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfMonth <Int32>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfMonth <Int32>
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfMonth <Int32>
-End <DateTime>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
-End <DateTime>
[-IsUtc]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
[-IsUtc]
[-OffsetDay <Int32>]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
-WeekOrder <ScheduleWeekOrder>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
[-OffsetDay <Int32>]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
-WeekOrder <ScheduleWeekOrder>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DayOfWeek <DayOfWeek>
-End <DateTime>
[-IsUtc]
[-OffsetDay <Int32>]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
-WeekOrder <ScheduleWeekOrder>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
[-Nonrecurring]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
[-LastDayOfMonth]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-DurationCount <Int32>
-DurationInterval <ScheduleInterval>
[-IsUtc]
-RecurCount <Int32>
-RecurInterval <ScheduleInterval>
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-End <DateTime>
[-IsUtc]
[-Nonrecurring]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-End <DateTime>
[-IsUtc]
[-LastDayOfMonth]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
-End <DateTime>
[-IsUtc]
-RecurCount <Int32>
-RecurInterval <ScheduleInterval>
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
[-IsUtc]
[-LastDayOfMonth]
[-RecurCount <Int32>]
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSchedule
[-IsUtc]
-RecurCount <Int32>
-RecurInterval <ScheduleInterval>
[-ScheduleString]
[-Start <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-CMSchedule crea un token de programación en Configuration Manager. Cree tokens de programación para programar eventos con frecuencias diferentes, como diaria, semanal y mensual.
Para descodificar y codificar tokens de programación en y desde una cadena de intervalo, use el cmdlet Convert-CMSchedule . A continuación, puede usar las cadenas de intervalo para establecer las propiedades de programación al definir o modificar Configuration Manager objetos.
Nota:
Ejecute Configuration Manager cmdlets desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Creación de un token de programación
Este comando crea un token de programación que especifica que el evento se produce el último día del mes en la fecha y hora especificadas (miércoles, 5 de agosto de 2020 17:46:03 Hora del Pacífico).
$schedToken1 = New-CMSchedule -DayOfMonth 0 -Start "2020-08-05T17:46:03.7236084-07:00"
Ejemplo 2: Creación de una programación de desplazamiento
En el ejemplo siguiente se crea la siguiente programación:
- Comienza en la fecha actual
- El segundo lunes del mes
- Se repite una vez
$schedToken2 = New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0
Ejemplo 3: Creación de una programación para ejecutarse diariamente
En este ejemplo se crea una programación sencilla que se produce diariamente para siempre. Puede usar este tipo de programación al implementar una línea base de configuración.
New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
Parámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DayOfMonth
Especifica el día del mes en el que se produce el evento. Los valores válidos oscilan entre 0 y 31. El valor predeterminado es 0
, que indica el último día del mes.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DayOfWeek
Especifica el día de la semana en que se produce el evento.
Type: | DayOfWeek |
Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DurationCount
Especifica el número de días durante los que se produce el evento programado. Los valores válidos oscilan entre 0 y 31. El valor predeterminado es 0
, que indica que la acción programada continúa indefinidamente.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DurationInterval
Especifica la hora en que se produce el evento.
Type: | ScheduleInterval |
Accepted values: | Minutes, Hours, Days |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Especifica la fecha y hora en que finaliza el evento programado.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUtc
Indica que la hora es hora universal coordinada (UTC).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LastDayOfMonth
Indica que el evento tiene lugar mensualmente el último día del mes.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Nonrecurring
Indica que el evento programado no se repite.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OffsetDay
Use este parámetro para configurar un desplazamiento, como mensual por día de la semana. El intervalo del parámetro OffsetDays es de 7 días.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurCount
Especifica el número de periodicidades del evento programado.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurInterval
Especifica la hora en que se repite el evento programado.
Type: | ScheduleInterval |
Accepted values: | Minutes, Hours, Days |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleString
Indica que el token de programación se convierte en una cadena de intervalo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
Especifica la fecha y hora en que se produce el evento programado.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WeekOrder
Especifica la semana del mes en que se produce el evento. El valor predeterminado es Last
(0).
Type: | ScheduleWeekOrder |
Accepted values: | Last, First, Second, Third, Fourth |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Salidas
IResultObject
System.String
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de