共用方式為


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

Description

New-CMAutoDeploymentRuleDeployment Cmdlet 會建立自動部署規則的部署, (ADR) 。

注意事項

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

範例

範例 1:依名稱建立自動部署規則的部署

此命令會建立自動部署規則 TestDepRule01All 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,以建立自動部署規則 TestDepRule02All 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

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

類型: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
別名:AutoDeploymentID
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InputObject

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

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

-Name

指定要新增此部署的自動部署規則名稱。

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

-NoInstallOnRemote

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

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

-NoInstallOnUnprotected

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

類型:Boolean
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

指定用戶視覺體驗的通知行為。

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

-UseUtc

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

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

-VerboseLevel

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

類型: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