New-CMSoftwareUpdateDeployment
建立軟體更新部署。
Syntax
New-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Comment <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
-InputObject <IResultObject>
[-PercentSuccess <Int32>]
[-ProtectedType <ProtectedType>]
[-DeployWithNoPackage <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SavedPackageId <String>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-DeadlineDateTime <DateTime>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Comment <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-ProtectedType <ProtectedType>]
[-DeployWithNoPackage <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SavedPackageId <String>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupId <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-DeadlineDateTime <DateTime>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Comment <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-ProtectedType <ProtectedType>]
[-DeployWithNoPackage <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SavedPackageId <String>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupName <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-DeadlineDateTime <DateTime>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Comment <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-ProtectedType <ProtectedType>]
[-DeployWithNoPackage <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SavedPackageId <String>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateId <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-DeadlineDateTime <DateTime>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Comment <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-ProtectedType <ProtectedType>]
[-DeployWithNoPackage <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SavedPackageId <String>]
[-SoftDeadlineEnabled <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateName <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-DeadlineDateTime <DateTime>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 將軟體更新部署至目標集合。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1
New-CMSoftwareUpdateDeployment -DeploymentName "updates deployment" -SoftwareUpdateGroupName "software update group" -CollectionName "Desktop clients for SUM" -Description "a more detailed description of this deployment" -DeploymentType Required -VerbosityLevel AllMessages -AvailableDateTime "2020/08/25 02:00AM" -DeadlineDateTime "2020/08/26 02:00AM" -UserNotification DisplaySoftwareCenterOnly -SoftwareInstallation $True -AllowRestart $True -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -RequirePostRebootFullScan $True -ProtectedType RemoteDistributionPoint
參數
-AcceptEula
某些軟體更新包括授權條款。 當您部署軟體更新時,不會顯示授權條款。 新增此參數,以自動部署所有軟體更新,而不論相關聯的授權條款為何。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRestart
達到安裝期限時,請將此參數設定為 $true
,以在必要時段外允許系統重新開機。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableDateTime
指定軟體更新可用的時機。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
在部署目標Configuration Manager指定集合物件。 使用 Get-CMCollection Cmdlet 取得此物件。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
指定集合識別碼作為此軟體更新部署的目標。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定集合名稱作為此軟體更新部署的目標。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
指定軟體更新部署的選擇性描述。
Type: | String |
Aliases: | Description |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineDateTime
指定必要軟體更新的安裝期限。 當達到期限時,用戶端會在裝置上安裝必要的軟體更新,並在必要時重新開機裝置。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentName
指定軟體更新部署的名稱。
Type: | String |
Aliases: | UpdateGroupDeploymentName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentType
指定此部署是否可供使用者安裝,或是否為指定期限排程的必要安裝。
Type: | DeploymentType |
Accepted values: | Required, Available |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployWithNoPackage
將此參數設定為 $true
不使用部署套件。 用戶端會從對等或 Microsoft 雲端下載軟體更新內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationsManagerAlert
指出是否要在軟體更新期間停用 Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeCollectionName
網站會將內容發佈至與此集合名稱相關聯的發佈點群組。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
新增此參數,以在建立此部署時發佈軟體更新內容。 在您將內容發佈至用戶端可存取的發佈點之前,用戶端無法安裝軟體更新。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
網站會將內容發佈至此發佈點群組。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
網站會將內容發佈至此發佈點。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadFromMicrosoftUpdate
如果目前、鄰近或月臺界限群組中的發佈點上無法使用軟體更新內容,請從 Microsoft Update 下載內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateOperationsManagerAlert
指出是否要在軟體安裝失敗時產生 Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
如果部署的合規性低於指定的閾值,部署會在 Configuration Manager 主控台中產生警示。 預設閾值為 95%。 若要變更閾值,請使用 PercentSuccess 參數。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定要部署的軟體更新物件。
Type: | IResultObject |
Aliases: | SoftwareUpdate, SoftwareUpdateGroup |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PercentSuccess
如果您將-GenerateSuccessAlert設定為 $true
,請使用此參數來指定月臺產生Configuration Manager主控台警示的合規性閾值百分比。 如果未指定,如果部署未在指定期限前達到 95% 的合規性,月臺就會產生警示。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
指出是否要在暫時重迭上安裝軟體更新,並在稍後認可變更,或是在安裝期限或維護期間認可變更。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProtectedType
指定用戶端是否可以使用鄰近界限群組或預設月臺界限群組中的發佈點。
Type: | ProtectedType |
Accepted values: | NoInstall, RemoteDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
此參數控制下列主控台選項: 軟體會在重新開機時更新部署重新評估行為。 如果您將此選項設定為 $true
,當用戶端從此部署安裝更新時重新開機之後,用戶端就會執行完整更新部署評估週期。
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestartServer
指出是否允許伺服器在軟體更新之後重新開機。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestartWorkstation
指出是否允許工作站在軟體更新之後重新開機。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SavedPackageId
Type: | String |
Aliases: | SavedDeploymentPackageId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
指出是否要在部署開始之前將喚醒封包傳送至電腦。
$True
:Configuration Manager從睡眠狀態喚醒電腦。$False
:它不會喚醒電腦進入睡眠狀態。
若要喚醒電腦,請先設定網路喚醒。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftDeadlineEnabled
使用此參數可在 ADR 部署設定的 [ 部署排程 ] 頁面上設定下列選項: 根據使用者喜好設定延遲強制執行此部署,最多可達用戶端設定中定義的寬限期。
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
達到安裝期限時,請將此參數設定為 $true
,以允許在維護期間外安裝軟體更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
指定要部署之軟體更新群組的識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupName
指定要部署之軟體更新群組的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateId
指定要部署之軟體更新的識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateName
指定要部署的軟體更新名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBasedOn
指定用戶端使用本機或 UTC 時間來判斷部署的可用性。 UTC 時間可讓所有電腦同時使用軟體更新。
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeUnit
指定 -TimeValue 參數的數值型別。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeValue
指定時間的整數值。 使用 -TimeUnit 參數來判斷這個值的時間類型。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnprotectedType
當目前或鄰近界限群組中的任何發佈點上都無法使用軟體更新時,請指定用戶端是否可以從月臺預設界限群組中的發佈點下載並安裝軟體更新。
Type: | UnprotectedType |
Accepted values: | NoInstall, UnprotectedDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseBranchCache
指出是否使用 Windows BranchCache 下載軟體更新內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
指出是否允許用戶端使用計量付費網路來下載更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
指定使用者通知體驗。
DisplayAll
:在軟體中心顯示並顯示所有通知DisplaySoftwareCenterOnly
:顯示在軟體中心,只顯示電腦重新開機的通知HideAll
:在軟體中心和所有通知中隱藏
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerbosityLevel
指定用戶端針對此軟體更新部署所傳回的狀態訊息詳細資料層級。
Type: | VerbosityLevelType |
Accepted values: | AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應