New-CMSchedule
Crie um token de agendamento Configuration Manager.
Sintaxe
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DayOfWeek
Especifica o dia da semana em que o evento ocorre.
Tipo: | DayOfWeek |
Valores aceitos: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DurationInterval
Especifica a hora em que o evento ocorre.
Tipo: | ScheduleInterval |
Valores aceitos: | Minutes, Hours, Days |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-End
Especifica a data e a hora em que o evento agendado termina.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsUtc
Indica que a hora é UTC (Tempo Universal Coordenado).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-LastDayOfMonth
Indica que o evento ocorre mensalmente no último dia do mês.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Nonrecurring
Indica que o evento agendado não se repetirá.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RecurCount
Especifica o número de recorrências do evento agendado.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RecurInterval
Especifica a hora em que o evento agendado se repetirá.
Tipo: | ScheduleInterval |
Valores aceitos: | Minutes, Hours, Days |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScheduleString
Indica que o token de agendamento é convertido em uma cadeia de caracteres de intervalo.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Start
Especifica a data e a hora em que o evento agendado ocorre.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WeekOrder
Especifica a semana do mês em que o evento ocorre. O valor padrão é Last
(0).
Tipo: | ScheduleWeekOrder |
Valores aceitos: | Last, First, Second, Third, Fourth |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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