Share via


New-CMSchedule

SYNOPSIS

Maak een Configuration Manager-token.

SYNTAX

RecurrenceNone (standaard)

New-CMSchedule [-IsUtc] [-Nonrecurring] [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceMonthlyByDate

New-CMSchedule -DayOfMonth <Int32> [-IsUtc] [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceMonthlyByDateWithDuration

New-CMSchedule -DayOfMonth <Int32> -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc]
 [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceMonthlyByDateWithEnd

New-CMSchedule -DayOfMonth <Int32> -End <DateTime> [-IsUtc] [-RecurCount <Int32>] [-ScheduleString]
 [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurrenceWeekly

New-CMSchedule -DayOfWeek <DayOfWeek> [-IsUtc] [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceWeeklyWithDuration

New-CMSchedule -DayOfWeek <DayOfWeek> -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc]
 [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceWeeklyWithEnd

New-CMSchedule -DayOfWeek <DayOfWeek> -End <DateTime> [-IsUtc] [-RecurCount <Int32>] [-ScheduleString]
 [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurMonthlyByWeekday

New-CMSchedule -DayOfWeek <DayOfWeek> [-IsUtc] [-OffsetDay <Int32>] [-RecurCount <Int32>] [-ScheduleString]
 [-Start <DateTime>] -WeekOrder <ScheduleWeekOrder> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

RecurMonthlyByWeekdayWithDuration

New-CMSchedule -DayOfWeek <DayOfWeek> -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc]
 [-OffsetDay <Int32>] [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>]
 -WeekOrder <ScheduleWeekOrder> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurMonthlyByWeekdayWithEnd

New-CMSchedule -DayOfWeek <DayOfWeek> -End <DateTime> [-IsUtc] [-OffsetDay <Int32>] [-RecurCount <Int32>]
 [-ScheduleString] [-Start <DateTime>] -WeekOrder <ScheduleWeekOrder> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceNoneWithDuration

New-CMSchedule -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc] [-Nonrecurring]
 [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurMonthlyLastDayOfMonthWithDuration

New-CMSchedule -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc] [-LastDayOfMonth]
 [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceIntervalWithDuration

New-CMSchedule -DurationCount <Int32> -DurationInterval <ScheduleInterval> [-IsUtc] -RecurCount <Int32>
 -RecurInterval <ScheduleInterval> [-ScheduleString] [-Start <DateTime>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceNoneWithEnd

New-CMSchedule -End <DateTime> [-IsUtc] [-Nonrecurring] [-ScheduleString] [-Start <DateTime>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurMonthlyLastDayOfMonthWithEnd

New-CMSchedule -End <DateTime> [-IsUtc] [-LastDayOfMonth] [-RecurCount <Int32>] [-ScheduleString]
 [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurrenceIntervalWithEnd

New-CMSchedule -End <DateTime> [-IsUtc] -RecurCount <Int32> -RecurInterval <ScheduleInterval> [-ScheduleString]
 [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

RecurMonthlyLastDayOfMonth

New-CMSchedule [-IsUtc] [-LastDayOfMonth] [-RecurCount <Int32>] [-ScheduleString] [-Start <DateTime>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

RecurrenceInterval

New-CMSchedule [-IsUtc] -RecurCount <Int32> -RecurInterval <ScheduleInterval> [-ScheduleString]
 [-Start <DateTime>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Met de cmdlet New-CMSchedule maakt u een schema-token in Configuration Manager. Maak planningstokens om gebeurtenissen te plannen met verschillende frequenties, zoals dagelijks, wekelijks en maandelijks.

Als u planningstokens in en van een intervalreeks wilt decoderen en coderen, gebruikt u de cmdlet Convert-CMSchedule. U kunt vervolgens de intervalreeksen gebruiken om planningseigenschappen in te stellen wanneer u de objecten Configuration Manager wijzigen.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: een planning-token maken

Met deze opdracht maakt u een schedule-token dat aangeeft dat de gebeurtenis plaatsvindt op de laatste dag van de maand op de opgegeven datum en tijd (woensdag 5 augustus 2020 17:46:03 Pacific Daylight Time).

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

Voorbeeld 2: een offsetschema maken

In het volgende voorbeeld wordt het volgende schema gemaakt:

  • Begint op de huidige datum
  • Op de tweede maandag van de maand
  • Wordt eenmaal recurseert
$schedToken2 = New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0

Voorbeeld 3: een schema maken dat dagelijks wordt uitgevoerd

In dit voorbeeld wordt een eenvoudige planning gemaakt die voor altijd dagelijks plaatsvindt. U kunt dit type planning gebruiken wanneer u een configuratiebasislijn implementeert.

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

PARAMETERS

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DayOfMonth

Hiermee geeft u de dag van de maand op waarop de gebeurtenis plaatsvindt. Geldige waarden variƫren van 0 tot en met 31. De standaardwaarde is 0 , waarmee de laatste dag van de maand wordt aangegeven.

Type: Int32
Parameter Sets: RecurrenceMonthlyByDate, RecurrenceMonthlyByDateWithDuration, RecurrenceMonthlyByDateWithEnd
Aliases:

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

-DayOfWeek

Hiermee geeft u de dag van de week wanneer de gebeurtenis plaatsvindt.

Type: DayOfWeek
Parameter Sets: RecurrenceWeekly, RecurrenceWeeklyWithDuration, RecurrenceWeeklyWithEnd, RecurMonthlyByWeekday, RecurMonthlyByWeekdayWithDuration, RecurMonthlyByWeekdayWithEnd
Aliases:
Accepted values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DurationCount

Hiermee geeft u het aantal dagen op waarin de geplande gebeurtenis plaatsvindt. Geldige waarden variƫren van 0 tot en met 31. De standaardwaarde is 0 , wat aangeeft dat de geplande actie voor onbepaalde tijd wordt voortgezet.

Type: Int32
Parameter Sets: RecurrenceMonthlyByDateWithDuration, RecurrenceWeeklyWithDuration, RecurMonthlyByWeekdayWithDuration, RecurrenceNoneWithDuration, RecurMonthlyLastDayOfMonthWithDuration, RecurrenceIntervalWithDuration
Aliases:

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

-DurationInterval

Hiermee geeft u het tijdstip waarop de gebeurtenis plaatsvindt.

Type: ScheduleInterval
Parameter Sets: RecurrenceMonthlyByDateWithDuration, RecurrenceWeeklyWithDuration, RecurMonthlyByWeekdayWithDuration, RecurrenceNoneWithDuration, RecurMonthlyLastDayOfMonthWithDuration, RecurrenceIntervalWithDuration
Aliases:
Accepted values: Minutes, Hours, Days

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

-End

Hiermee geeft u de datum en tijd waarop de geplande gebeurtenis eindigt.

Type: DateTime
Parameter Sets: RecurrenceMonthlyByDateWithEnd, RecurrenceWeeklyWithEnd, RecurMonthlyByWeekdayWithEnd, RecurrenceNoneWithEnd, RecurMonthlyLastDayOfMonthWithEnd, RecurrenceIntervalWithEnd
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IsUtc

Geeft aan dat de tijd is Coordinated Universal Time (UTC).

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LastDayOfMonth

Geeft aan dat de gebeurtenis maandelijks plaatsvindt op de laatste dag van de maand.

Type: SwitchParameter
Parameter Sets: RecurMonthlyLastDayOfMonthWithDuration, RecurMonthlyLastDayOfMonthWithEnd, RecurMonthlyLastDayOfMonth
Aliases:

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

-Niet-curring

Geeft aan dat de geplande gebeurtenis niet wordt herhalingen.

Type: SwitchParameter
Parameter Sets: RecurrenceNone, RecurrenceNoneWithDuration, RecurrenceNoneWithEnd
Aliases:

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

-OffsetDay

Vanaf versie 1906 gebruikt u deze parameter om een offset te configureren, zoals maandelijks op weekdag.

Type: Int32
Parameter Sets: RecurMonthlyByWeekday, RecurMonthlyByWeekdayWithDuration, RecurMonthlyByWeekdayWithEnd
Aliases:

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

-RecurCount

Hiermee geeft u het aantal terugkeerpatroon van de geplande gebeurtenis.

Type: Int32
Parameter Sets: RecurrenceMonthlyByDate, RecurrenceMonthlyByDateWithDuration, RecurrenceMonthlyByDateWithEnd, RecurrenceWeekly, RecurrenceWeeklyWithDuration, RecurrenceWeeklyWithEnd, RecurMonthlyByWeekday, RecurMonthlyByWeekdayWithDuration, RecurMonthlyByWeekdayWithEnd, RecurMonthlyLastDayOfMonthWithDuration, RecurMonthlyLastDayOfMonthWithEnd, RecurMonthlyLastDayOfMonth
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Int32
Parameter Sets: RecurrenceIntervalWithDuration, RecurrenceIntervalWithEnd, RecurrenceInterval
Aliases:

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

-RecurInterval

Hiermee geeft u het tijdstip waarop de geplande gebeurtenis wordt opnieuw.

Type: ScheduleInterval
Parameter Sets: RecurrenceIntervalWithDuration, RecurrenceIntervalWithEnd, RecurrenceInterval
Aliases:
Accepted values: Minutes, Hours, Days

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

-ScheduleString

Geeft aan dat het schema-token wordt geconverteerd naar een intervalreeks.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Start

Hiermee geeft u de datum en tijd waarop de geplande gebeurtenis plaatsvindt.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-WeekOrder

Hiermee geeft u de week van de maand wanneer de gebeurtenis plaatsvindt. De standaardwaarde is Last (0).

Type: ScheduleWeekOrder
Parameter Sets: RecurMonthlyByWeekday, RecurMonthlyByWeekdayWithDuration, RecurMonthlyByWeekdayWithEnd
Aliases:
Accepted values: Last, First, Second, Third, Fourth

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

IResultObject#SMS_ScheduleToken

System.String

OPMERKINGEN

Convert-CMSchedule