Set-CMAutoDeploymentRuleDeployment
自動展開規則のデプロイを設定します。
構文
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMAutoDeploymentRuleDeployment コマンドレットは、自動デプロイ規則のデプロイを更新します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ID でデプロイを設定する
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False
このコマンドは、展開ルールの展開の設定をアクション ID 348 と All Systems という名前のコレクションで更新します。
例 2: 変数を使用してデプロイを設定する
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False
最初のコマンドは、TestADR01 という名前の自動デプロイ 規則オブジェクトを取得し、そのオブジェクトを $ReferenceADR 変数に格納します。
2 番目のコマンドは、$ReferenceADRに格納されている自動デプロイ ルール オブジェクトに関連付けられたデプロイを取得し、デプロイを $Deployment 変数に格納します。
最後のコマンドは、$Deploymentに格納されている最初のデプロイの設定を更新します。
パラメーター
-AlertTime
期限からのオフセットの時間単位数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AlertTimeUnit
期限からのオフセットの時間単位の種類を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowDownloadFromMicrosoftUpdate
このパラメーターを使用して、ADR 展開 設定の [ダウンロード設定] ページで次のオプションを設定します。 ソフトウェア更新プログラムが現在、近隣、またはサイト境界グループの配布ポイントで使用できない場合は、Microsoft Updates からコンテンツをダウンロードします。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowRestart
インストール期限に達したときに、定義されたメンテナンス期間外でシステムの再起動を実行できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
インストール期限に達したときに、定義されているメンテナンス期間外でソフトウェアのインストールを実行できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowUseMeteredNetwork
このパラメーターを使用して、ADR 展開 設定の [ダウンロード設定] ページで次のオプションを設定します。 従量制課金インターネット接続のクライアントがインストール期限後にコンテンツをダウンロードすることを許可します。これにより、追加コストが発生する可能性があります
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableImmediately
ルールの実行後にソフトウェア更新プログラムをできるだけ早くインストールできるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTime
ソフトウェアの使用可能時間の時間単位数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTimeUnit
ソフトウェアの使用可能時間の時間単位の種類を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Collection
ソフトウェア更新プログラムの展開のターゲット コレクション オブジェクトを指定します。 コレクション オブジェクトを取得するには、 Get-CMCollection コマンドレットを使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionId
ソフトウェア更新プログラムの展開のターゲット コレクションの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionName
ソフトウェア更新プログラムの展開のターゲット コレクションの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineImmediately
期限に達したときに、必要なソフトウェア更新プログラムをできるだけ早くインストールするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTime
期限の時間単位数を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTimeUnit
期限の時間単位の種類を指定します。 有効な値は次のとおりです。
- 時間
- 日数
- 週
- 月
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableOperationsManager
ソフトウェア更新プログラムの実行中に Operations Manager アラートが無効かどうかを示します。
型: | Boolean |
Aliases: | DisableOperationManager |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableDeployment
関連付けられているソフトウェア グループに対してこのルールを実行した後に展開を有効にするかどうかを示します。 $Falseに設定されている場合は、ソフトウェア更新プログラム グループを手動で展開する必要があります。
型: | Boolean |
Aliases: | Enable, EnabledAfterCreate, EnableAfterCreate |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateOperationsManagerAlert
ソフトウェア更新プログラムのインストールが失敗したときに Operations Manager アラートが生成されるかどうかを示します。
型: | Boolean |
Aliases: | GenerateOperationManagerAlert |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateSuccessAlert
このルールが正常に実行されたときにアラートが生成されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
自動展開規則の展開のアクション ID を指定します。
型: | Int32 |
Aliases: | ActionID |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
自動展開ルール オブジェクトを指定します。 自動デプロイ 規則オブジェクトを取得するには、 Get-CMSoftwareUpdateAutoDeploymentRule コマンドレットを 使用します。
型: | IResultObject |
Aliases: | AutoDeploymentRuleDeployment |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NoInstallOnRemote
リモート配布ポイントで更新プログラムを使用できない場合にソフトウェア更新プログラムをインストールするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoInstallOnUnprotected
保護されていない配布ポイントで更新プログラムを使用できない場合にソフトウェア更新プログラムをインストールするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RequirePostRebootFullScan
このパラメーターを使用して、ADR 展開設定の [ユーザー エクスペリエンス ] ページで次のオプションを設定します。 この展開の更新プログラムでシステムの再起動が必要な場合は、再起動後に更新プログラムの展開評価サイクルを実行します。
型: | Boolean |
Aliases: | RunEvaluationAfterRestart |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SendWakeupPacket
Wake-on-LAN を使用して、必要な展開のクライアントをウェイクアップするかどうかを示します。
型: | Boolean |
Aliases: | EnableWakeOnLan |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SoftDeadlineEnabled
このパラメーターを使用して、ADR 展開設定の [展開スケジュール ] ページで次のオプションを設定します。 クライアント設定で定義されている猶予期間まで、ユーザー設定に従ってこのデプロイを延期します。
型: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuccessPercentage
クライアントコンプライアンスのパーセントを整数で指定します。 クライアントのコンプライアンスがこの割合を下回ると、アラートが生成されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartServer
ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、サーバーでシステムの再起動が抑制されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartWorkstation
ソフトウェア更新プログラムでインストール プロセスを完了するためにシステムの再起動が必要な場合に、ワークステーションでシステムの再起動が抑制されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseBranchCache
クライアントが同じサブネット上の他のクライアントとコンテンツを共有できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserNotification
ユーザー ビジュアル エクスペリエンスの通知動作を指定します。 有効な値は次のとおりです。
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
型: | UserNotificationOption |
指定可能な値: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseUtc
このデプロイのスケジュールが世界協定時刻 (UTC) に基づいて評価されるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VerboseLevel
このルールによって作成されたデプロイに対してクライアントが報告する状態の詳細を指定します。 有効な値は次のとおりです。
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
型: | VerboseLevelType |
指定可能な値: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WriteFilterHandling
変更が期限またはメンテナンス期間中にコミットされる (再起動が必要) かどうかを示します。 $Falseに設定すると、コンテンツがオーバーレイに適用され、後でコミットされます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject