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
相關連結
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應