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 パラメーターを使用する必要 があります。

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

-AlertThresholdPercentage

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

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

-AlertUnit

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

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

-AllowMeteredConnection

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

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

-AllowSystemRestart

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

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

-AllowWumuFallback

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

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

-BeginCondition

前のフェーズの成功後にこの展開フェーズを開始するオプションを指定します。

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

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

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-CriteriaOption

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

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

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

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

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

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

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

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

-DaysAfterPreviousPhaseSuccess

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

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

-DeadlineUnit

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

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

-DeadlineValue

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

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

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

-DisableScomAlert

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

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

-DisableWildcardHandling

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

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

-EnableAlert

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

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします。 お勧めできません。 DisableWildcardHandling と組み合わせは使用できない。

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

-GenerateScomAlertOnFailure

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

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

-InstallationChoice

ソフトウェアを使用できる場合の動作に対するオプションを指定します。

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

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

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PhaseDescription

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

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

-PhaseName

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

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

-RequirePostRebootFullScan

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

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

-ServerRestartSuppression

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

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

-SoftwareInstallation

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

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

-StateMessageVerbosity

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

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

Type:	VerbosityLevelType
Accepted values:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottlingDays

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

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

-UseNeighborDP

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

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

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

-UserNotificationOption

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

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

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

-UseSiteDefaultDP

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

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkstationRestartSuppression

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

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

-WriteFilterCommit

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

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

入力

None

出力

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase