New-CMSoftwareUpdatePhase
このコマンドレットを使用して、ソフトウェア更新プログラムの展開フェーズを作成します。
構文
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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AlertThresholdPercentage
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [クライアントのコンプライアンス] が次の (パーセント) を下回る設定と同じです。 パーセンテージの整数値を指定します。 この値を設定するには、 EnableAlert パラメーターを使用する必要があります。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AlertUnit
期間の種類を指定します。 AlertDelta でこのパラメーターを使用します。
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowMeteredConnection
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。従量制課金インターネット接続のクライアントがインストール期限後にコンテンツをダウンロードできるようにすると、追加のコストが発生する可能性があります。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSystemRestart
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの [システムの再起動] (インストールを完了するために必要な場合) の設定と同じです。 この設定は、インストール期限に達したときに適用され、メンテナンス期間外でこのアクティビティを実行できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowWumuFallback
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。現在、近隣、またはサイト境界グループの配布ポイントでソフトウェア更新プログラムを使用できない場合は、Microsoft 更新からコンテンツをダウンロードします。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BeginCondition
前のフェーズの成功後に、このデプロイフェーズを開始するためのオプションを指定します。
AfterPeriod: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。 この値を指定する場合は、 DaysAfterPreviousPhaseSuccess を使用して期間を構成します。Manually: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。展開のこのフェーズを手動で開始します。
| Type: | BeginConditionType |
| Accepted values: | AfterPeriod, Manually |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
ターゲット コレクションのオブジェクトを指定します。
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
ID でターゲット コレクションを指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
名前でターゲット コレクションを指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CriteriaOption
前のフェーズの成功条件を選択するオプションを指定します。
Compliance: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [展開の成功率] の設定と同じです。 CriteriaValue パラメーターを使用してパーセンテージ値を指定します。Number: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの設定と同じです。正常に展開されたデバイスの数です。 CriteriaValue パラメーターを使用してデバイスの数を指定します。
| Type: | CriteriaType |
| Accepted values: | Compliance, Number |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CriteriaValue
この整数値は、 CriteriaOption に指定する値によって異なります。
Compliance: パーセンテージを指定します。Number: デバイスの数を指定します
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
前のフェーズが成功してからこのフェーズを開始する日数の整数値を指定します。 このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [フェーズ設定] ページの設定と同じです。遅延期間 (日数) 後にこのフェーズを自動的に開始します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineUnit
期限期間の種類を指定します。 このパラメーターは DeadlineValue と共に使用します。
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineValue
このパラメーターは、InstallationChoice パラメーターを指定AfterPeriodした場合にのみ使用されます。
期限の期間に整数値を指定します。 DeadlineUnit パラメーターを使用して、期間の種類を指定します。 HoursDaysWeeksMonths このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールが必要です] の設定と同じです。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableScomAlert
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [ソフトウェア更新プログラムの実行中に Operations Manager アラートを無効にする] の設定と同じです。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAlert
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [アラート] 設定と同じです。次の条件が満たされたときにアラートを生成します。 このパラメーターを に $true設定すると、次のパラメーターも設定されます。
- AlertThresholdPercentage
- AlertDelta
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableWakeOnLan
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [展開設定] ページの設定と同じです。Wake-on-LAN を使用して、必要な展開のクライアントをウェイクアップします。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作につながる可能性があります。 これはお勧めしません。 DisableWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [アラート] ページの [ソフトウェア更新プログラムのインストールが失敗したときに Operations Manager アラートを生成する] の設定と同じです。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstallationChoice
ソフトウェアが使用可能になったときに相対的な動作のオプションを指定します。
AsSoonAsPossible: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールができるだけ早く必要] の設定と同じです。AfterPeriod: このパラメーターは、コンソールの [フェーズの追加ウィザード] の [フェーズ設定] ページの [インストールが必要です] の設定と同じです。 この値を指定する場合は、 DeadlineUnit と DeadlineValue を使用して期間を構成します。
| Type: | InstallationChoiceType |
| Accepted values: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhaseDescription
フェーズの説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhaseName
説明の名前を指定します。
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequirePostRebootFullScan
このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。この展開の更新プログラムでシステムの再起動が必要な場合は、再起動後に更新プログラムの展開評価サイクルを実行します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServerRestartSuppression
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの次の設定と同じです。 次のデバイスでシステムの再起動を抑制する: サーバー。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareInstallation
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの [ソフトウェアのインストール] の設定と同じです。 この設定は、インストール期限に達したときに適用され、メンテナンス期間外でこのアクティビティを実行できます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StateMessageVerbosity
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [展開設定] ページの [状態メッセージの詳細レベル] の設定と同じです。値は次のとおりです。
AllMessages: すべてのメッセージOnlySuccessAndErrorMessages: 成功メッセージとエラー メッセージのみOnlyErrorMessages: エラー メッセージのみ
| Type: | VerbosityLevelType |
| Accepted values: | AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottlingDays
このソフトウェアを徐々に使用できるようにする日数の整数値を指定します。 このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [フェーズ設定] ページの設定と同じです。この期間 (日数) にわたってこのソフトウェアを段階的に使用できるようにします。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseNeighborDP
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [設定のダウンロード] ページの設定と同じです。クライアントが近隣境界グループまたは既定のサイト境界グループの配布ポイントを使用するときに使用する展開オプションを選択します。 次の値を指定します。
$true: 配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールする$false: ソフトウェア更新プログラムをインストールしない
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserNotificationOption
このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。この展開のユーザー エクスペリエンス設定を次の値で指定します。
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 |
-UseSiteDefaultDP
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ダウンロード設定] ページの設定と同じです。現在または近隣の境界グループの配布ポイントでソフトウェア更新プログラムを使用できない場合、クライアントはサイトの既定の境界グループの配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールできます。 次の値を指定します。
$true: サイトの既定の境界グループの配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールする$false: ソフトウェア更新プログラムをインストールしない
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkstationRestartSuppression
このパラメーターは、コンソールの [フェーズの追加ウィザード] の [ユーザー エクスペリエンス] ページの次の設定と同じです。 ワークステーション: 次のデバイスでシステムの再起動 を抑制します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WriteFilterCommit
このパラメーターは、コンソールの [フェーズの追加ウィザード] ページの [ユーザー エクスペリエンス] ページの設定と同じです。期限またはメンテナンス期間中に変更をコミットする (再起動が必要)。 この設定は、Windows Embedded デバイスの書き込みフィルター処理に適用されます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示