New-CMSchedule

Erstellen Sie ein Configuration Manager Zeitplantoken.

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>]

Beschreibung

Das Cmdlet New-CMSchedule erstellt ein Zeitplantoken in Configuration Manager. Erstellen Sie Zeitplantoken, um Ereignisse mit unterschiedlichen Häufigkeiten zu planen, z. B. täglich, wöchentlich und monatlich.

Verwenden Sie das Cmdlet Convert-CMSchedule , um Zeitplantoken in und aus einer Intervallzeichenfolge zu decodieren und zu codieren. Sie können dann die Intervallzeichenfolgen verwenden, um Zeitplaneigenschaften festzulegen, wenn Sie Configuration Manager Objekte definieren oder ändern.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erstellen eines Zeitplantokens

Dieser Befehl erstellt ein Zeitplantoken, das angibt, dass das Ereignis am letzten Tag des Monats zum angegebenen Datum und zur angegebenen Uhrzeit (Mittwoch, 5. August 2020, 17:46:03 Pacific Daylight Time) auftritt.

$schedToken1 = New-CMSchedule -DayOfMonth 0 -Start "2020-08-05T17:46:03.7236084-07:00"

Beispiel 2: Erstellen eines Offsetzeitplans

Im folgenden Beispiel wird der folgende Zeitplan erstellt:

  • Beginnt am aktuellen Datum
  • Am zweiten Montag des Monats
  • Einmal rekursieren
$schedToken2 = New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0

Beispiel 3: Erstellen eines Zeitplans für die tägliche Ausführung

In diesem Beispiel wird ein einfacher Zeitplan erstellt, der täglich für immer ausgeführt wird. Sie können diesen Zeitplantyp verwenden, wenn Sie eine Konfigurationsbaseline bereitstellen.

New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DayOfMonth

Gibt den Tag des Monats an, an dem das Ereignis auftritt. Gültige Werte reichen von 0 bis 31. Der Standardwert ist 0, was den letzten Tag des Monats angibt.

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

-DayOfWeek

Gibt den Wochentag an, an dem das Ereignis auftritt.

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

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-DurationCount

Gibt die Anzahl der Tage an, in denen das geplante Ereignis auftritt. Gültige Werte reichen von 0 bis 31. Der Standardwert ist 0, was angibt, dass die geplante Aktion unbegrenzt fortgesetzt wird.

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

-DurationInterval

Gibt den Zeitpunkt an, zu dem das Ereignis eintritt.

Type:ScheduleInterval
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-End

Gibt das Datum und die Uhrzeit des Endes des geplanten Ereignisses an.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-IsUtc

Gibt an, dass die Zeit koordinierte Weltzeit (UTC) ist.

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

-LastDayOfMonth

Gibt an, dass das Ereignis monatlich am letzten Tag des Monats auftritt.

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

-Nonrecurring

Gibt an, dass das geplante Ereignis nicht wiederholt wird.

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

-OffsetDay

Verwenden Sie diesen Parameter, um einen Offset zu konfigurieren, z. B. monatlich nach Wochentag. Der Bereich für den OffsetDays-Parameter beträgt 7 Tage.

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

-RecurCount

Gibt die Anzahl der Wiederholungen des geplanten Ereignisses an.

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

-RecurInterval

Gibt die Zeit an, zu der das geplante Ereignis wiederholt wird.

Type:ScheduleInterval
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleString

Gibt an, dass das Zeitplantoken in eine Intervallzeichenfolge konvertiert wird.

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

-Start

Gibt das Datum und die Uhrzeit des Auftretens des geplanten Ereignisses an.

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

-WeekOrder

Gibt die Woche des Monats an, in der das Ereignis auftritt. Der Standardwert ist 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

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

IResultObject

System.String