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:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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
Accept pipeline input:False
Accept wildcard characters:False
-AlertTimeUnit

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

  • 時間
  • 日数
  • 週
  • 月
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowRestart

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

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

インストール期限に達した場合に、定義済みのメンテナンス ウィンドウの外側でソフトウェア インストールを実行できるかどうかを示します。

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

期限が過ぎた後に、メーターで管理されたインターネット接続を使用してクライアントがコンテンツをダウンロードできるかどうかを示します。追加の費用が発生する可能性があります。

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

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

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

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

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

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

  • 時間
  • 日数
  • 週
  • 月
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Collection

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 時間
  • 日数
  • 週
  • 月
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentPackage

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

Type:IResultObject
Aliases:InputObject
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-Description

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

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

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

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

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

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

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

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

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

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

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

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

展開が成功した場合にアラートを生成するかどうかを示します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ユーザーの視覚効果の通知動作を指定します。 有効な値は次のとおりです。

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

この展開のスケジュールを、世界協定時刻 (UTC) に基づいて評価するかどうかを示します。

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

このルールが作成する展開についてクライアントが報告する詳細レベルを指定します。 有効な値は次のとおりです。

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Type:VerboseLevelType
Accepted values:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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
-WriteFilterHandling

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-必須

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

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

入力

なし

出力

System.Object