Set-CMAutoDeploymentRuleDeployment

  • リファレンス
モジュール:
ConfigurationManager

自動展開ルールの展開を設定します。

構文

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コマンドレットは、自動展開ルールの展開を更新します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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

このコマンドは、展開ルールの展開の設定を 348 のアクション ID と 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します。

最後のコマンドは、新しいアプリケーションに格納されている最初の展開の$Deployment。

パラメーター

-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:ActionID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

自動展開ルール オブジェクトを指定します。 自動展開ルール オブジェクトを取得するには 、Get-CMSoftwareUpdateAutoDeploymentRule コマンドレットを使用 します。

Type:IResultObject
Aliases:AutoDeploymentRuleDeployment
Position:0
Default value:None
Accept pipeline input:True
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
-PassThru

このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

Type:SwitchParameter
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

ユーザーの視覚効果の通知動作を指定します。 有効な値は次のとおりです。

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
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

このルールによって作成された展開に対してクライアントが報告する状態の詳細を指定します。 有効な値は次のとおりです。

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
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