New-CMWindowsServicingPlan

モジュール:

ConfigurationManager

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サービス プランを作成します。

注:

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

例

例 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 パラメーターを使用して時間単位を指定します。

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

-AlertTimeUnit

AlertTime パラメーターの時間単位を指定します。 有効な値は次のとおりです。

• 時間
• 日数
• 週
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowRestart

インストール期限に達したときに、定義されたメンテナンス期間外でシステムの再起動を実行できるかどうかを示します。

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

インストール期限に達したときに、定義されたメンテナンス期間外でソフトウェアのインストールを実行できるかどうかを示します。

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

-AllowUseMeteredNetwork

期限後に従量制課金インターネット接続経由でクライアントがコンテンツをダウンロードできるかどうかを示します。これにより、追加の費用が発生する可能性があります。

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

-AvailableImmediately

ルールの実行後にソフトウェア更新プログラムをできるだけ早くインストールできるかどうかを示します。

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

-AvailableTime

ソフトウェア更新プログラムを使用できるタイミングを指定します。

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

-AvailableTimeUnit

ソフトウェアの使用可能時間の時間単位の種類を指定します。 有効な値は次のとおりです。

• 時間
• 日数
• 週
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

サービス プランに使用するターゲット デバイス コレクション オブジェクトを指定します。 デバイス コレクション オブジェクトを取得するには、 Get-CMCollection コマンドレットまたは Get-CMDeviceCollection コマンドレットを使用します。

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

-CollectionId

サービス プランに使用するターゲット デバイス コレクションの ID を指定します。

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

-CollectionName

サービス プランに使用するターゲット デバイス コレクションの名前を指定します。

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

-Confirm

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

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

-DeadlineImmediately

期限に達したときに、必要なソフトウェア更新プログラムをできるだけ早くインストールするかどうかを示します。

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

-DeadlineTime

期限の時間単位数を指定します。

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

-DeadlineTimeUnit

期限の時間単位の種類を指定します。 有効な値は次のとおりです。

• 時間
• 日数
• 週
• 月

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentPackage

ソフトウェア更新プログラムの展開パッケージを指定します。 ソフトウェア更新プログラムの展開パッケージを取得するには、 Get-CMSoftwareUpdateDeploymentPackage コマンドレットを 使用します。

Type:	IResultObject
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentRing

サービス プランを適用する Windows の準備状態を指定します。 有効な値は次のとおりです。

• CB
• Release
• BusinessMainstream
• Cbb
• Ltsb

Type:	DeploymentRing
Accepted values:	CB, Release, BusinessMainstream, Cbb, Ltsb
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

サービス プランの説明を指定します。

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

-DisableOperationManager

ソフトウェアの更新中に System Center Operations Manager アラートを無効にするかどうかを示します。

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

-DownloadFromInternet

インターネットからソフトウェア更新プログラムをダウンロードするかどうかを示します。

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

-DownloadFromMicrosoftUpdate

ソフトウェア更新プログラムが優先配布ポイントまたはリモート配布ポイントで使用できない場合に、コンピューターが Microsoft Update からコンテンツをダウンロードするかどうかを示します。

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

-Enable

サービス プランが有効かどうかを示します。

Type:	Boolean
Aliases:	Enabled, EnableDeployment
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GenerateOperationManagerAlert

ソフトウェアの更新中に Operations Manager アラートを生成するかどうかを示します。

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

-GenerateSuccessAlert

デプロイを成功させるためにアラートを生成するかどうかを示します。

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

-Language

サービス プランに追加されるソフトウェアのアップグレードをフィルター処理するために使用される言語の配列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LanguageSelection

言語の配列を文字列として指定します。 コンピューターは、言語固有以外の更新プログラムに加えて、指定された言語で利用可能なソフトウェア更新プログラムをダウンロードします。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

ダウンロードした更新プログラムが配置されるネットワークの場所を指定します。

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

-Name

サービス プランの名前を指定します。 名前は一意である必要があります。ルールの目的を説明し、Configuration Manager サイト内の他のユーザーから識別するのに役立ちます。

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

-NoInstallOnRemote

リモート システムへの更新プログラムのインストールを許可するかどうかを示します。 $Trueの値を指定した場合、クライアントが低速または信頼性の低いネットワーク境界内にある場合、またはクライアントがコンテンツにフォールバック ソースの場所を使用している場合、Configuration Managerソフトウェア更新プログラムはインストールされません。 $Falseの値を指定すると、インストールが続行されます。

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

-NoInstallOnUnprotected

保護されていないシステムへの更新プログラムのインストールを許可するかどうかを示します。 $Trueの値を指定した場合、ソフトウェア更新プログラムが優先配布ポイントで使用できない場合、Configuration Managerはソフトウェア更新プログラムをダウンロードしてインストールしません。 $Falseの値を指定すると、インストールが続行されます。

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

-Required

サービス プランに追加されるソフトウェアのアップグレードをフィルター処理するために使用される検索文字列の配列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunType

更新プログラムを実行するモードを指定します。 有効な値は次のとおりです。

• DoNotRunThisRuleAutomatically
• RunTheRuleAfterAnySoftwareUpdatePointSynchronization
• RunTheRuleOnSchedule

Type:	RunType
Accepted values:	DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

(デプロイの使用可能時間から) 期限を指定します。 スケジュールを作成するには、 New-CMSchedule コマンドレットを 使用します。

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

-SendWakeupPacket

展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が$Trueされている場合は、Configuration Managerはコンピューターをスリープ状態から復帰します。 この値が$Falseされている場合、コンピューターはスリープ状態から復帰しません。 コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。

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

-SuccessPercentage

クライアントコンプライアンスのパーセンテージを 0 から 99 の整数で指定します。 コンプライアンスがこの割合を下回ると、Configuration Managerはオプションのアラートを生成します。

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

-SuppressRestartServer

ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、サーバーでシステムの再起動が抑制されるかどうかを示します。

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

-SuppressRestartWorkstation

ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、ワークステーションでシステムの再起動が抑制されるかどうかを示します。

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

-Title

サービス プランに追加されるソフトウェア更新プログラム タイトルのフィルター処理に使用される検索文字列の配列を指定します。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateDeploymentWaitDay

お使いの環境に展開する前に、Microsoft が新しいアップグレードを発行してから待機する日数を指定します。

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

-UseBranchCache

ブランチ キャッシュを使用するかどうかを示します。 $Trueの値を指定すると、クライアントは同じサブネット上のコンテンツを共有します。

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

-UserNotification

ユーザー ビジュアル エクスペリエンスの通知動作を指定します。 有効な値は次のとおりです。

• DisplayAll
• DisplaySoftwareCenterOnly
• HideAll

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtc

このデプロイのスケジュールが世界協定時刻 (UTC) に基づいて評価されるかどうかを示します。

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

-VerboseLevel

このルールによって作成されるデプロイについてクライアントがレポートする詳細レベルを指定します。 有効な値は次のとおりです。

• AllMessages
• OnlyErrorMessages
• OnlySuccessAndErrorMessages

Type:	VerboseLevelType
Accepted values:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:	Named
Default value:	None
Required:	False
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

-WriteFilterHandling

変更が期限またはメンテナンス期間中にコミットされる (再起動が必要) かどうかを示します。 $Falseに設定すると、コンテンツがオーバーレイに適用され、後でコミットされます。

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

入力

None

出力

System.Object

関連リンク

• Get-CMCollection
• Get-CMDeviceCollection
• Get-CMSoftwareUpdateDeploymentPackage
• Get-CMWindowsServicingPlan