New-CMSoftwareUpdatePhase

モジュール:

ConfigurationManager

このコマンドレットを使用して、ソフトウェア更新プログラムの展開フェーズを作成します。

構文

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、ソフトウェア更新プログラムの展開フェーズを作成します。

例

例 1: ソフトウェア更新フェーズを作成する

この例では、MyCollection という名前のコレクションの MySUPhase という名前のソフトウェア更新フェーズを作成します。これは、ソフトウェア センターにのみ表示されます。

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

パラメーター

-AlertDelta

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [期限からのオフセット] 設定と同じです。 オフセットの整数値を指定し、 AlertUnit パラメーターを使用してピリオドの種類を指定します。

この値を設定するには、 EnableAlert パラメーターを使用する必要があります。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AlertThresholdPercentage

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [クライアントのコンプライアンス] が次の (パーセント) を下回る設定と同じです。 パーセンテージの整数値を指定します。 この値を設定するには、 EnableAlert パラメーターを使用する必要があります。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AlertUnit

期間の種類を指定します。 AlertDelta でこのパラメーターを使用します。

型:	TimeUnitType
指定可能な値:	Hours, Days, Weeks, Months
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowMeteredConnection

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。従量制課金インターネット接続のクライアントがインストール期限後にコンテンツをダウンロードできるようにすると、追加のコストが発生する可能性があります。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowSystemRestart

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの [システムの再起動] (インストールを完了するために必要な場合) の設定と同じです。 この設定は、インストール期限に達したときに適用され、メンテナンス期間外にこのアクティビティを実行できます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowWumuFallback

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。現在、近隣、またはサイト境界グループの配布ポイントでソフトウェア更新プログラムを使用できない場合は、Microsoft Updates からコンテンツをダウンロードします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BeginCondition

前のフェーズの成功後に、このデプロイフェーズを開始するためのオプションを指定します。

• AfterPeriod: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。 この値を指定する場合は、 DaysAfterPreviousPhaseSuccess を使用して期間を構成します。

• Manually: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。展開のこのフェーズを手動で開始します。

型:	BeginConditionType
指定可能な値:	AfterPeriod, Manually
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Collection

ターゲット コレクションのオブジェクトを指定します。

型:	IResultObject
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionId

ID でターゲット コレクションを指定します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionName

名前でターゲット コレクションを指定します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CriteriaOption

前のフェーズの成功条件を選択するオプションを指定します。

• Compliance: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [展開の成功率] の設定と同じです。 CriteriaValue パラメーターを使用してパーセンテージ値を指定します。

• Number: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。正常に展開されたデバイスの数です。 CriteriaValue パラメーターを使用してデバイスの数を指定します。

型:	CriteriaType
指定可能な値:	Compliance, Number
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CriteriaValue

この整数値は、 CriteriaOption に指定する値によって異なります。

• Compliance: パーセンテージを指定します。

• Number: デバイスの数を指定します

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DaysAfterPreviousPhaseSuccess

前のフェーズが成功してからこのフェーズを開始する日数の整数値を指定します。 このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [フェーズ設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeadlineUnit

期限期間の種類を指定します。 このパラメーターは DeadlineValue と共に使用します。

型:	TimeUnitType
指定可能な値:	Hours, Days, Weeks, Months
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeadlineValue

このパラメーターは、InstallationChoice パラメーターでAfterPeriodを指定した場合にのみ使用されます。

期限の期間に整数値を指定します。 DeadlineUnit パラメーターを使用して、期間の種類 (Hours、Days、Weeks、Months) を指定します。 このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールが必要です] の設定と同じです。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableScomAlert

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [ソフトウェア更新プログラムの実行中に Operations Manager アラートを無効にする] の設定と同じです。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableAlert

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [アラート] 設定と同じです。次の条件が満たされたときにアラートを生成します。 このパラメーターを $true に設定する場合は、次のパラメーターも設定します。

• AlertThresholdPercentage
• AlertDelta

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableWakeOnLan

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [展開設定] ページの設定と同じです。Wake-on-LAN を使用して、必要な展開のクライアントをウェイクアップします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作につながる可能性があります。 これはお勧めしません。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GenerateScomAlertOnFailure

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [ソフトウェア更新プログラムのインストールが失敗したときに Operations Manager アラートを生成する] の設定と同じです。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InstallationChoice

ソフトウェアが使用可能になったときに相対的な動作のオプションを指定します。

• AsSoonAsPossible: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールができるだけ早く必要] の設定と同じです。

• AfterPeriod: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールが必要です] の設定と同じです。 この値を指定する場合は、 DeadlineUnit と DeadlineValue を使用して期間を構成します。

型:	InstallationChoiceType
指定可能な値:	AsSoonAsPossible, AfterPeriod
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PhaseDescription

フェーズの説明を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PhaseName

説明の名前を指定します。

型:	String
Aliases:	Name
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RequirePostRebootFullScan

このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。この展開の更新プログラムでシステムの再起動が必要な場合は、再起動後に更新プログラムの展開評価サイクルを実行します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerRestartSuppression

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの次の設定と同じです。 次のデバイスでシステムの再起動を抑制する: サーバー。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SoftwareInstallation

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの [ソフトウェアのインストール] の設定と同じです。 この設定は、インストール期限に達したときに適用され、メンテナンス期間外にこのアクティビティを実行できます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StateMessageVerbosity

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [展開設定] ページの [状態メッセージの詳細レベル] の設定と同じです。値は次のとおりです。

• AllMessages：全てのメッセージ
• OnlySuccessAndErrorMessages: 成功メッセージとエラー メッセージのみ
• OnlyErrorMessages: エラー メッセージのみ

型:	VerbosityLevelType
指定可能な値:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ThrottlingDays

このソフトウェアを徐々に使用できるようにする日数の整数値を指定します。 このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [フェーズ設定] ページの設定と同じです。この期間 (日数) にわたってこのソフトウェアを段階的に使用できるようにします。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseNeighborDP

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [設定のダウンロード] ページの設定と同じです。クライアントが近隣境界グループまたは既定のサイト境界グループの配布ポイントを使用するときに使用する展開オプションを選択します。 次の値を指定します。

• $true: 配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールする
• $false: ソフトウェア更新プログラムをインストールしない

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserNotificationOption

このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。この展開のユーザー エクスペリエンス設定を次の値で指定します。

• DisplayAll: ソフトウェア センターに表示し、すべての通知を表示する
• DisplaySoftwareCenterOnly: ソフトウェア センターに表示し、コンピューターの再起動に関する通知のみを表示する
• HideAll: ソフトウェア センターとすべての通知で非表示にする

型:	UserNotificationType
指定可能な値:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseSiteDefaultDP

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。現在または近隣の境界グループ内の配布ポイントでソフトウェア更新プログラムを使用できない場合、クライアントはサイトの既定の境界グループの配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールできます。 次の値を指定します。

• $true: サイトの既定の境界グループの配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールする
• $false: ソフトウェア更新プログラムをインストールしない

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WorkstationRestartSuppression

このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの次の設定と同じです。 ワークステーション: 次のデバイスでシステムの再起動 を抑制します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WriteFilterCommit

このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。期限またはメンテナンス期間中に変更をコミットする (再起動が必要)。 この設定は、Windows Embedded デバイスの書き込みフィルター処理に適用されます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase