New-CMAutoDeploymentRuleDeployment
自動展開ルールの展開を作成します。
構文
New-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>]
[-Name] <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-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>]
New-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>]
[-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>]
New-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>]
[-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>]
説明
New-CMAutoDeploymentRuleDeploymentコマンドレットは、自動展開ルール (ADR) の展開を作成します。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: 名前で自動展開ルールの展開を作成する
このコマンドは、自動展開ルール TestDepRule01 および All Systems コレクションの 展開を作成 します。
New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -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
例 2: オブジェクト別の自動展開ルールの展開を作成する
このコマンドは 、TestDepRule02 という名前の自動展開ルール オブジェクトを取得します。 次に、パイプライン演算子を使用してオブジェクトを New-CMAutoDeploymentRuleDeploymentに渡し、自動展開ルール TestDepRule02 および All Systems コレクションの展開を作成します。
Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -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
パラメーター
-AlertTime
期限からのオフセットの時間単位の数を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
期限からのオフセットの時間単位の種類を指定します。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowDownloadFromMicrosoftUpdate
このパラメーターを使用して、ADR 展開設定の [設定のダウンロード] ページで次のオプションを設定します。現在の、近隣、またはサイトの境界グループの配布ポイントでソフトウェア更新プログラムを使用できない場合は 、Microsoft Updatesからコンテンツをダウンロードします。
Type: | Boolean |
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
このパラメーターを使用して、ADR 展開設定の [設定のダウンロード] ページで次のオプションを設定します。従量課金インターネット接続上のクライアントがインストール期限後にコンテンツをダウンロードし、追加コストが発生する可能性があります。
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 コマンドレットを使用 します。
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 |
-DisableOperationsManager
ソフトウェア更新プログラムの実行中に Operations Manager の通知を無効にするかどうかを示します。
Type: | Boolean |
Aliases: | DisableOperationManager |
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 |
-EnableDeployment
関連付けられたソフトウェア グループに対してこのルールを実行した後で展開を有効にするかどうかを示します。 に設定されている $False
場合は、ソフトウェア更新プログラム グループを手動で展開します。
Type: | Boolean |
Aliases: | Enable, EnabledAfterCreate, EnableAfterCreate |
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 |
-GenerateOperationsManagerAlert
ソフトウェア更新プログラムのインストールが失敗した場合に Operations Manager の警告が生成されるかどうかを示します。
Type: | Boolean |
Aliases: | GenerateOperationManagerAlert |
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 |
-Id
この展開を追加する自動展開ルールの ID を指定します。
Type: | Int32 |
Aliases: | AutoDeploymentID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
この展開を追加する自動展開ルール オブジェクトを指定します。 自動展開ルール オブジェクトを取得するには 、Get-CMSoftwareUpdateAutoDeploymentRule コマンドレットを使用 します。
Type: | IResultObject |
Aliases: | AutoDeploymentRule |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
この展開を追加する自動展開ルールの名前を指定します。
Type: | String |
Aliases: | AutoDeploymentName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnRemote
リモート配布ポイントで更新プログラムを使用できない場合に、ソフトウェア更新プログラムをインストールするかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnUnprotected
保護されていない配布ポイントで更新プログラムを使用できない場合に、ソフトウェア更新プログラムをインストールするかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
このパラメーターを使用して、ADR 展開**** 設定の [ユーザー エクスペリエンス] ページで次のオプションを設定します。この展開の更新プログラムでシステムの再起動が必要な場合は、再起動後に更新プログラムの展開評価サイクルを実行します。
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Wake-on-LAN を使用して、必要な展開のクライアントをウェイクアップするかどうかを示します。
Type: | Boolean |
Aliases: | EnableWakeOnLan |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftDeadlineEnabled
このパラメーターを使用して、ADR 展開**** 設定の [展開スケジュール] ページで次のオプションを設定します。クライアント設定で定義されている猶予期間まで、ユーザーの好みに応じてこの展開の適用を遅延します。
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessPercentage
パーセントをクライアントコンプライアンスの整数として指定します。 クライアントのコンプライアンスがこの割合を下回った場合、アラートが生成されます。
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 |
-UseBranchCache
クライアントが同じサブネット上の他のクライアントとコンテンツを共有できるかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
ユーザーの視覚効果の通知動作を指定します。
Type: | UserNotificationOption |
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
このルールによって作成された展開に対してクライアントが報告する状態の詳細を指定します。
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 |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject