New-CMSchedule
Crie um token de agendamento 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
O cmdlet New-CMSchedule cria um token de agendamento no Configuration Manager. Crie tokens de agendamento para agendar eventos com frequências diferentes, como diárias, semanais e mensais.
Para decodificar e codificar tokens de agendamento em uma cadeia de caracteres de intervalo, use o cmdlet Convert-CMSchedule . Em seguida, você pode usar as cadeias de caracteres de intervalo para definir propriedades de agendamento ao definir ou modificar objetos Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: criar um token de agendamento
Esse comando cria um token de agendamento que especifica que o evento ocorre no último dia do mês na data e hora especificadas (quarta-feira, 5 de agosto de 2020 17:46:03 Horário de Verão do Pacífico).
$schedToken1 = New-CMSchedule -DayOfMonth 0 -Start "2020-08-05T17:46:03.7236084-07:00"
Exemplo 2: criar um agendamento de deslocamento
O exemplo a seguir cria o seguinte agendamento:
- Começa na data atual
- Na segunda segunda-feira do mês
- Recurs uma vez
$schedToken2 = New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0
Exemplo 3: criar uma agenda para executar diariamente
Este exemplo cria uma agenda simples que ocorre diariamente para sempre. Você pode usar esse tipo de agenda ao implantar uma linha de base de configuração.
New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DayOfMonth
Especifica o dia do mês em que o evento ocorre. Os valores válidos variam de 0 a 31. O valor padrão é 0
, o que indica o último dia do mês.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DayOfWeek
Especifica o dia da semana em que o evento ocorre.
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
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DurationCount
Especifica o número de dias durante os quais o evento agendado ocorre. Os valores válidos variam de 0 a 31. O valor padrão é 0
, o que indica que a ação agendada continua indefinidamente.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DurationInterval
Especifica a hora em que o evento ocorre.
Type: | ScheduleInterval |
Accepted values: | Minutes, Hours, Days |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Especifica a data e a hora em que o evento agendado termina.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUtc
Indica que a hora é UTC (Tempo Universal Coordenado).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LastDayOfMonth
Indica que o evento ocorre mensalmente no último dia do mês.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Nonrecurring
Indica que o evento agendado não se repetirá.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OffsetDay
Use esse parâmetro para configurar um deslocamento, como mensal por dia da semana. O intervalo do parâmetro OffsetDays é de 7 dias.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurCount
Especifica o número de recorrências do evento agendado.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurInterval
Especifica a hora em que o evento agendado se repetirá.
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 o token de agendamento é convertido em uma cadeia de caracteres de intervalo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
Especifica a data e a hora em que o evento agendado ocorre.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WeekOrder
Especifica a semana do mês em que o evento ocorre. O valor padrão é 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
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
IResultObject
System.String
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de