New-CMWindowsServicingPlan
Windows 10 サービス プランを作成します。
構文
New-CMWindowsServicingPlan
-Name <String>
[-Description <String>]
-CollectionName <String>
[-Enable <Boolean>]
[-SendWakeupPacket <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-Language <String[]>]
[-Required <String[]>]
[-Title <String[]>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-UseUtc <Boolean>]
[-AvailableTime <Int32>]
[-AvailableImmediately <Boolean>]
[-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-SuccessPercentage <Int32>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>]
[-DownloadFromInternet <Boolean>]
[-Location <String>]
[-DeploymentRing <DeploymentRing>]
[-UpdateDeploymentWaitDay <Int32>]
[-LanguageSelection <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMWindowsServicingPlan
-Name <String>
[-Description <String>]
-Collection <IResultObject>
[-Enable <Boolean>]
[-SendWakeupPacket <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-Language <String[]>]
[-Required <String[]>]
[-Title <String[]>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-UseUtc <Boolean>]
[-AvailableTime <Int32>]
[-AvailableImmediately <Boolean>]
[-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-SuccessPercentage <Int32>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>]
[-DownloadFromInternet <Boolean>]
[-Location <String>]
[-DeploymentRing <DeploymentRing>]
[-UpdateDeploymentWaitDay <Int32>]
[-LanguageSelection <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMWindowsServicingPlan
-Name <String>
[-Description <String>]
-CollectionId <String>
[-Enable <Boolean>]
[-SendWakeupPacket <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-Language <String[]>]
[-Required <String[]>]
[-Title <String[]>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-UseUtc <Boolean>]
[-AvailableTime <Int32>]
[-AvailableImmediately <Boolean>]
[-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-SuccessPercentage <Int32>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>]
[-DownloadFromInternet <Boolean>]
[-Location <String>]
[-DeploymentRing <DeploymentRing>]
[-UpdateDeploymentWaitDay <Int32>]
[-LanguageSelection <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-CMWindowsServicingPlan コマンドレットは、Windows 10 サービス プランを作成します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: コレクション ID でサービス プランを作成する
PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")
最初のコマンドは、言語のリストを作成し、リストを $Lang 変数に格納します。
2 番目のコマンドは、検索文字列のリストを作成し、そのリストを $Required 変数に格納します。 この検索文字列は、少なくとも 1 台のコンピューターと最大 100 台のコンピューターで必要なソフトウェア更新プログラムを検索します。
3 番目のコマンドは、ソフトウェア更新プログラムのタイトルの一覧を作成し、そのリストを $Title 変数に格納します。
最後のコマンドは、SUDP01 という名前のソフトウェア更新プログラム展開パッケージを取得し、ID MP40001Aを持つターゲット コレクションの Test という名前の Windows サービス プランを作成します。 コマンドは、$Langに格納されているアップグレード フィルター言語、$Requiredに格納されている必要なフィルター、および$Titleに格納されているソフトウェア更新タイトル フィルターを追加します。
例 2: コレクション名でサービス プランを作成する
PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect
最初のコマンドは、言語選択言語のリストを作成し、リストを $LangSelect 変数に格納します。
2 番目のコマンドは、SUP02 という名前のソフトウェア更新プログラム展開パッケージを取得し、ColName02 という名前のターゲット コレクションの Test02 という名前の Windows サービス プランを作成します。 コマンドは、$LangSelectに格納されている言語選択言語を追加します。
パラメーター
-AlertTime
更新プログラムの展開期限からの整数オフセットを指定します。 ルールでは、この値を使用して、ルールがアラートを生成するタイミングを指定します。 AlertTimeUnit パラメーターを使用して時間単位を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AlertTimeUnit
AlertTime パラメーターの時間単位を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowRestart
インストール期限に達したときに、定義されたメンテナンス期間外でシステムの再起動を実行できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
インストール期限に達したときに、定義されているメンテナンス期間外でソフトウェアのインストールを実行できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowUseMeteredNetwork
期限後に従量制課金インターネット接続経由でクライアントがコンテンツをダウンロードすることを許可するかどうかを示します。これにより、追加の費用が発生する可能性があります。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableImmediately
ルールの実行後にソフトウェア更新プログラムをできるだけ早くインストールできるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTime
ソフトウェア更新プログラムを使用できるタイミングを指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTimeUnit
ソフトウェアの使用可能時間の時間単位の種類を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Collection
サービス プランに使用するターゲット デバイス コレクション オブジェクトを指定します。 デバイス コレクション オブジェクトを取得するには、 Get-CMCollection コマンドレットまたは Get-CMDeviceCollection コマンドレットを使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionId
サービス プランに使用するターゲット デバイス コレクションの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionName
サービス プランに使用するターゲット デバイス コレクションの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineImmediately
期限に達したときに、必要なソフトウェア更新プログラムをできるだけ早くインストールするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTime
期限の時間単位数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTimeUnit
期限の時間単位の種類を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeploymentPackage
ソフトウェア更新プログラムの展開パッケージを指定します。 ソフトウェア更新プログラムの展開パッケージを取得するには、 Get-CMSoftwareUpdateDeploymentPackage コマンドレットを 使用します。
型: | IResultObject |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeploymentRing
サービス プランを適用する Windows の準備状態を指定します。 有効な値は次のとおりです。
- CB
- リリース
- BusinessMainstream
- Cbb
- Ltsb
型: | DeploymentRing |
指定可能な値: | CB, Release, BusinessMainstream, Cbb, Ltsb |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
サービス プランの説明を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableOperationManager
ソフトウェアの更新中に System Center Operations Manager アラートを無効にするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DownloadFromInternet
インターネットからソフトウェア更新プログラムをダウンロードするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DownloadFromMicrosoftUpdate
ソフトウェア更新プログラムが優先配布ポイントまたはリモート配布ポイントで使用できない場合に、コンピューターが Microsoft Update からコンテンツをダウンロードするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Enable
サービス プランが有効かどうかを示します。
型: | Boolean |
Aliases: | Enabled, EnableDeployment |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateOperationManagerAlert
ソフトウェアの更新中に Operations Manager アラートを生成するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateSuccessAlert
デプロイを成功させるためにアラートを生成するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Language
サービス プランに追加されるソフトウェアのアップグレードをフィルター処理するために使用される言語の配列を指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LanguageSelection
言語の配列を文字列として指定します。 コンピューターは、言語固有以外の更新プログラムに加えて、指定された言語で利用可能なソフトウェア更新プログラムをダウンロードします。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
ダウンロードした更新プログラムが配置されるネットワークの場所を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
サービス プランの名前を指定します。 名前は一意である必要があります。ルールの目的を説明し、Configuration Manager サイト内の他のユーザーから識別するのに役立ちます。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoInstallOnRemote
リモート システムへの更新プログラムのインストールを許可するかどうかを示します。 $Trueの値を指定した場合、クライアントが低速または信頼性の低いネットワーク境界内にある場合、またはクライアントがコンテンツにフォールバック ソースの場所を使用している場合、Configuration Manager はソフトウェア更新プログラムをインストールしません。 $Falseの値を指定すると、インストールが続行されます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoInstallOnUnprotected
保護されていないシステムへの更新プログラムのインストールを許可するかどうかを示します。 $Trueの値を指定した場合、優先配布ポイントでソフトウェア更新プログラムを使用できない場合、Configuration Manager はソフトウェア更新プログラムをダウンロードしてインストールしません。 $Falseの値を指定すると、インストールが続行されます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Required
サービス プランに追加されるソフトウェアのアップグレードをフィルター処理するために使用される検索文字列の配列を指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunType
更新プログラムを実行するモードを指定します。 有効な値は次のとおりです。
- DoNotRunThisRuleAutomatically
- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
- RunTheRuleOnSchedule
型: | RunType |
指定可能な値: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Schedule
(デプロイの使用可能時間から) 期限を指定します。 スケジュールを作成するには、 New-CMSchedule コマンドレットを 使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SendWakeupPacket
展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が$True場合、Configuration Manager はコンピューターをスリープ解除します。 この値が$Falseされている場合、コンピューターはスリープ状態から復帰しません。 コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuccessPercentage
クライアントコンプライアンスのパーセンテージを 0 から 99 の整数で指定します。 コンプライアンスがこの割合を下回ると、Configuration Manager によってオプションのアラートが生成されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartServer
ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、サーバーでシステムの再起動が抑制されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartWorkstation
ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、ワークステーションでシステムの再起動が抑制されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Title
サービス プランに追加されるソフトウェア更新プログラム タイトルのフィルター処理に使用される検索文字列の配列を指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UpdateDeploymentWaitDay
Microsoft が新しいアップグレードを発行してから環境にデプロイするまでに待機する日数を指定します。
型: | Int32 |
Aliases: | UpdateDeploymentWaitDays |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseBranchCache
ブランチ キャッシュを使用するかどうかを示します。 $Trueの値を指定すると、クライアントは同じサブネット上のコンテンツを共有します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserNotification
ユーザー ビジュアル エクスペリエンスの通知動作を指定します。 有効な値は次のとおりです。
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
型: | UserNotificationType |
指定可能な値: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseUtc
このデプロイのスケジュールが世界協定時刻 (UTC) に基づいて評価されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VerboseLevel
このルールによって作成される展開についてクライアントがレポートする詳細レベルを指定します。 有効な値は次のとおりです。
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
型: | VerboseLevelType |
指定可能な値: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WriteFilterHandling
変更が期限またはメンテナンス期間中にコミットされる (再起動が必要) かどうかを示します。 $Falseに設定すると、コンテンツがオーバーレイに適用され、後でコミットされます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object