New-CMMaintenanceWindow
コレクションのメンテナンス ウィンドウを作成します。
構文
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-InputObject] <IResultObject>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionId] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionName] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、コレクションのメンテナンス ウィンドウを作成します。 メンテナンス ウィンドウは、Configuration Manager クライアントがタスクを実行できる定期的な期間です。 たとえば、ソフトウェア更新プログラムを適用したり、ソフトウェアをインストールしたりします。 このウィンドウでは、大幅なシステム変更が、生産性やアップタイムに影響しない場合にのみ発生します。
メンテナンス ウィンドウの詳細については 、「Configuration Manager でメンテナンス ウィンドウを使用する方法」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1: メンテナンス ウィンドウの作成
最初のコマンドでは 、New-CMSchedule コマンドレットを使用してスケジュール オブジェクトを作成し、変数に格納 $MWSchedule します。
2 番目のコマンドは、指定したコレクションの MonthlySchedule という名前 のメンテナンス ウィンドウを作成します。
メンテナンス ウィンドウでは、変数に格納されているスケジュールが使用 $MWSchedule されます。
$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule例 2: コレクション間でメンテナンス ウィンドウをコピーする
最初のコマンドは、ID XYZ0003Fを持つコレクションからメンテナンス ウィンドウを取得します。 次に、ID XYZ0005D を使用して、同じ名前、同じスケジュール、およびソフトウェア更新プログラムの場合のみ、コレクションにメンテナンス ウィンドウを作成します。
$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnlyパラメーター
作成するメンテナンス ウィンドウの種類を指定します。
Any: メンテナンス ウィンドウはすべての展開に適用されます。SoftwareUpdatesOnly: メンテナンス ウィンドウは、ソフトウェア更新プログラムの展開にのみ適用されます。TaskSequencesOnly: メンテナンス ウィンドウは、タスク シーケンスの展開にのみ適用されます。
このパラメーターを指定しない場合は Any 、既定値です。
| Type: | MaintenanceWindowApplyTo |
| Accepted values: | Any, SoftwareUpdatesOnly, TaskSequencesOnly |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは非推奨です。 SoftwareUpdatesOnly値と一緒に ApplyTo パラメーターを使用します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは非推奨です。 TaskSequencesOnly 値と一緒に ApplyTo パラメーターを使用します。 ****
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
メンテナンス ウィンドウを追加するコレクションの ID を指定します。 この ID は、たとえば、標準のコレクション ID です XYZ0003F 。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
メンテナンス ウィンドウを追加するコレクションの名前を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットを実行する前に確認を求めるメッセージを表示するには、このパラメーターを追加します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
メンテナンス ウィンドウを追加するコレクションのオブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレットを使用 します。
| Type: | IResultObject |
| Aliases: | Collection, Site |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
コレクションにメンテナンス ウィンドウを作成し、アクティブにしない場合は、このパラメーターをに設定します $false 。 このパラメーターを含めなかった場合、このコマンドレットはメンテナンス ウィンドウを有効にします。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
協定世界時 (UTC) を使用するメンテナンス ウィンドウのスケジュールを構成するには、このパラメーターをに設定します $true 。 このパラメーターを含めなかった場合、スケジュールは現地時間を使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
メンテナンス ウィンドウの名前を指定します。
| Type: | String |
| Aliases: | MaintenanceWindowName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
メンテナンス ウィンドウが発生する日時のスケジュール オブジェクトを指定します。 このオブジェクトを取得するには 、New-CMSchedule コマンドレットを使用 します。
メンテナンス ウィンドウ オブジェクトは、スケジュールをトークン文字列として格納します。 別のオブジェクトからスケジュールをコピーするには 、Convert-CMSchedule コマンドレットを使用 します。 たとえば、Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules などです。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_ServiceWindow WMI クラス」を参照してください。