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:\> 。 詳細については 、「Getting started」を参照してください。
例
例 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfMonth
イベントが発生する月の日を指定します。 有効な値の範囲は 0 ~ 31 です。 既定値は、 0 月の最終日を示します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DurationCount
スケジュールされたイベントが発生する日数を指定します。 有効な値の範囲は 0 ~ 31 です。 既定値は、 0 スケジュールされたアクションが無期限に続行されます。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DurationInterval
イベントが発生する時刻を指定します。
| Type: | ScheduleInterval |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-End
スケジュールされたイベントが終了する日時を指定します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsUtc
時刻が協定世界時 (UTC) を示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LastDayOfMonth
イベントが月の最終日に毎月発生する場合を示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Nonrecurring
スケジュールされたイベントが再び発生しないかどうかを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OffsetDay
このパラメーターを使用して、平日別の月次などのオフセットを構成します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurCount
スケジュールされたイベントの定期的な回数を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurInterval
スケジュールされたイベントが再帰する時刻を指定します。
| Type: | ScheduleInterval |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleString
スケジュール トークンが間隔文字列に変換されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Start
スケジュールされたイベントが発生する日時を指定します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WeekOrder
イベントが発生する月の週を指定します。 既定値は Last (0) です。
| Type: | ScheduleWeekOrder |
| Accepted values: | Last, First, Second, Third, Fourth |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
なし
出力
IResultObject
System.String