共用方式為


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>]

Description

Set-CMAutoDeploymentRuleDeployment Cmdlet 會更新自動部署規則的部署。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:依標識符設定部署

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 的動作識別碼和名為 [所有系統] 的集合,更新部署規則部署的設定。

範例 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變數中。

第二個命令會取得與儲存在 $ReferenceADR 中的自動部署規則對象相關聯的部署,並將部署儲存在 $Deployment 變數中。

最後一個命令會更新儲存在 $Deployment 中之第一個部署的設定。

參數

-AlertTime

指定從期限位移的時間單位數目。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AlertTimeUnit

指定從期限位移的時間單位類型。 有效值為:

  • 小時
  • 星期
  • 月份
類型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AllowDownloadFromMicrosoftUpdate

使用此參數可在 ADR 部署設定的 [ 下載設定 ] 頁面上設定下列選項: 如果目前、鄰近或月臺界限群組的發佈點上無法使用軟體更新,請從Microsoft更新下載內容

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AllowRestart

指出當達到安裝期限時,是否允許在任何已定義的維護期間之外執行系統重新啟動。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

指出當達到安裝期限時,是否允許在任何已定義的維護期間之外執行軟體安裝。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AllowUseMeteredNetwork

使用此參數可在 ADR 部署設定的 [ 下載設定 ] 頁面上設定下列選項: 允許計量付費因特網連線上的用戶端在安裝期限之後下載內容,這可能會產生載入成本

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AvailableImmediately

指出執行規則之後,是否可以儘快安裝軟體更新。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AvailableTime

指定軟體可用時間的時間單位數目。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AvailableTimeUnit

指定軟體可用時間的時間單位類型。 有效值為:

  • 小時
  • 星期
  • 月份
類型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Collection

指定軟體更新部署的目標集合物件。 若要取得集合物件,請使用 Get-CMCollection Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CollectionId

指定軟體更新部署的目標集合識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CollectionName

指定軟體更新部署的目標集合名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DeadlineImmediately

指出是否在達到期限時儘快安裝必要的軟體更新。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DeadlineTime

指定期限的時間單位數目。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DeadlineTimeUnit

指定期限的時間單位類型。 有效值為:

  • 小時
  • 星期
  • 月份
類型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableOperationsManager

指出是否在執行軟體更新時停用 Operations Manager 警示。

類型:Boolean
別名:DisableOperationManager
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EnableDeployment

指出是否要在針對相關聯的軟體群組執行此規則之後啟用部署。 如果設定為 $False,您必須手動部署軟體更新群組。

類型:Boolean
別名:Enable, EnabledAfterCreate, EnableAfterCreate
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GenerateOperationsManagerAlert

指出軟體更新安裝失敗時,是否產生 Operations Manager 警示。

類型:Boolean
別名:GenerateOperationManagerAlert
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GenerateSuccessAlert

指出此規則成功執行時,是否產生警示。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定自動部署規則部署的動作識別碼。

類型:Int32
別名:ActionID
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InputObject

指定自動部署規則物件。 若要取得自動部署規則物件,請使用 Get-CMSoftwareUpdateAutoDeploymentRule Cmdlet。

類型:IResultObject
別名:AutoDeploymentRuleDeployment
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-NoInstallOnRemote

指出在任何遠端發佈點上無法使用更新時,是否要安裝軟體更新。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NoInstallOnUnprotected

指出在任何未受保護的發佈點上無法使用更新時,是否要安裝軟體更新。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RequirePostRebootFullScan

使用此參數可在 ADR 部署設定的 [ 用戶體驗 ] 頁面上設定下列選項: 如果此部署中的任何更新需要系統重新啟動,請在重新啟動之後執行更新部署評估週期

類型:Boolean
別名:RunEvaluationAfterRestart
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SendWakeupPacket

指出是否要使用網路喚醒來喚醒需要部署的用戶端。

類型:Boolean
別名:EnableWakeOnLan
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SoftDeadlineEnabled

使用此參數可在 ADR 部署設定的 [ 部署排程 ] 頁面上設定下列選項: 根據使用者喜好設定延遲強制執行此部署,最多可達客戶端設定中定義的寬限期

類型:Boolean
別名:DelayEnforcementAndUpToGracePeriod
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SuccessPercentage

指定客戶端合規性百分比,以整數表示。 當客戶端合規性低於此百分比時,就會產生警示。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SuppressRestartServer

指出當軟體更新需要系統重新啟動才能完成安裝程式時,伺服器上是否抑制系統重新啟動。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SuppressRestartWorkstation

指出當軟體更新需要系統重新啟動才能完成安裝程式時,工作站上是否抑制系統重新啟動。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseBranchCache

指出是否允許用戶端與相同子網上的其他用戶端共享內容。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UserNotification

指定用戶視覺體驗的通知行為。 有效值為:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
類型:UserNotificationOption
接受的值:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseUtc

指出此部署的排程是否根據通用國際標準時間 (UTC) 進行評估。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VerboseLevel

指定客戶端針對此規則所建立的部署回報多少狀態詳細數據。 有效值為:

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
類型:VerboseLevelType
接受的值:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-WriteFilterHandling

指出變更是在期限或維護期間認可, (需要重新啟動) 。 如果設定為 $False,則會在重疊上套用內容,並在稍後認可。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject