次の方法で共有


New-CMSchedule

Configuration Manager スケジュール トークンを作成します。

構文

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

説明

New-CMSchedule コマンドレットは、Configuration Manager でスケジュール トークンを作成します。 スケジュール トークンを作成して、毎日、毎週、毎月などの頻度が異なるイベントをスケジュールします。

間隔文字列との間でスケジュール トークンをデコードしてエンコードするには、 Convert-CMSchedule コマンドレットを使用します。 その後、Configuration Manager オブジェクトを定義または変更するときに、間隔文字列を使用してスケジュール プロパティを設定できます。

注:

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例 1: スケジュール トークンを作成する

このコマンドは、指定した日時 (2020 年 8 月 5 日 (水) 17:46:03 太平洋夏時間) にイベントが発生することを指定するスケジュール トークンを作成します。

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

例 2: オフセット スケジュールを作成する

次の例では、次のスケジュールを作成します。

  • 現在の日付から始まる
  • 月の第 2 月曜日
  • 1 回再帰する
$schedToken2 = New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0

例 3: 毎日実行するスケジュールを作成する

この例では、毎日永遠に発生する単純なスケジュールを作成します。 構成基準をデプロイするときに、この種類のスケジュールを使用できます。

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

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DayOfMonth

イベントが発生する月の日を指定します。 有効な値の範囲は 0 ~ 31 です。 既定値は です 0。これは、月の最終日を示します。

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

-DayOfWeek

イベントが発生する曜日を指定します。

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

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-DurationCount

スケジュールされたイベントが発生する日数を指定します。 有効な値の範囲は 0 ~ 31 です。 既定値は です 0。これは、スケジュールされたアクションが無期限に続行されることを示します。

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

-DurationInterval

イベントが発生する時刻を指定します。

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

-End

スケジュールされたイベントが終了する日時を指定します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-IsUtc

時刻が協定世界時 (UTC) であることを示します。

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

-LastDayOfMonth

イベントが月の最終日に毎月発生することを示します。

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

-Nonrecurring

スケジュールされたイベントが再発しないことを示します。

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

-OffsetDay

このパラメーターを使用して、月単位 (平日) などのオフセットを構成します。 パラメーター OffsetDays の範囲は 7 日です。

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

-RecurCount

スケジュールされたイベントの繰り返し数を指定します。

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

-RecurInterval

スケジュールされたイベントが繰り返される時刻を指定します。

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

-ScheduleString

スケジュール トークンが間隔文字列に変換されることを示します。

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

-Start

スケジュールされたイベントが発生する日時を指定します。

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

-WeekOrder

イベントが発生する月の週を指定します。 既定値は (0) です Last

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

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

None

出力

IResultObject

System.String