Start-CMSoftwareUpdateDeployment
(已淘汰) 在 Configuration Manager 中起始軟體更新部署。
語法
Start-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
-CollectionName <String>
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-EnforcementDeadline <DateTime>]
[-EnforcementDeadlineDay <DateTime>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
-InputObject <IResultObject>
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftwareInstallation <Boolean>]
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
-CollectionName <String>
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-EnforcementDeadline <DateTime>]
[-EnforcementDeadlineDay <DateTime>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateName <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
-CollectionName <String>
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-EnforcementDeadline <DateTime>]
[-EnforcementDeadlineDay <DateTime>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateId <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
-CollectionName <String>
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-EnforcementDeadline <DateTime>]
[-EnforcementDeadlineDay <DateTime>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupName <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-CMSoftwareUpdateDeployment
[-AcceptEula]
[-AllowRestart <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
-CollectionName <String>
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentName <String>]
[-DeploymentType <DeploymentType>]
[-Description <String>]
[-DisableOperationsManagerAlert <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-EnforcementDeadline <DateTime>]
[-EnforcementDeadlineDay <DateTime>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-PercentSuccess <Int32>]
[-PersistOnWriteFilterDevice <Boolean>]
[-ProtectedType <ProtectedType>]
[-RestartServer <Boolean>]
[-RestartWorkstation <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftwareInstallation <Boolean>]
-SoftwareUpdateGroupId <String>
[-TimeBasedOn <TimeType>]
[-TimeUnit <TimeUnitType>]
[-TimeValue <Int32>]
[-UnprotectedType <UnprotectedType>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-VerbosityLevel <VerbosityLevelType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
重要事項
此 Cmdlet 已被取代。 請改用 New-CMSoftwareUpdateDeployment 。
Start-CMSoftwareUpdateDeployment Cmdlet 會起始軟體更新部署。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：依軟體更新名稱啟動必要的部署
PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True此命令會使用軟體更新名稱來啟動必要的軟體更新部署。
範例 2：依軟體更新名稱啟動可用的部署
PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True此命令會使用軟體更新名稱來啟動可用的軟體更新部署。
範例 3：依軟體更新組名開始必要的部署
PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True此命令會使用集合名稱和輸入對象來啟動軟體更新部署。
範例 4：依軟體更新組名開始部署
PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True此命令會使用軟體更新組名來啟動軟體更新部署。
參數
-AcceptEula
某些軟體更新包括授權條款。 當您部署軟體更新時，不會顯示授權條款。 新增此參數，以自動部署所有軟體更新，而不論相關聯的授權條款為何。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowRestart
指出是否允許在安裝之後重新啟動。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowUseMeteredNetwork
指出是否允許用戶端使用計量付費網路來下載更新。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
在 Configuration Manager 中指定集合的名稱。 集合是一組客戶端計算機。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentAvailableDay
以 MM/DD/YYYY 格式指定軟體更新部署可用的日期。 根據預設，更新會立即可用。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentAvailableTime
以 HH：MM 格式指定軟體更新部署可用的時間。 根據預設，更新會立即可用。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentName
指定 Configuration Manager 中軟體更新部署的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentType
在 Configuration Manager 中指定部署類型。
| 類型: | DeploymentType |
| 接受的值: | Required, Available |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定軟體更新部署的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableOperationsManagerAlert
指出是否要在軟體更新期間停用 System Center 2012 - Operations Manager 警示。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DownloadFromMicrosoftUpdate
指出用戶端是否直接從 Microsoft Update 下載更新。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnforcementDeadline
| 類型: | DateTime |
| 別名: | DeploymentExpireTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnforcementDeadlineDay
| 類型: | DateTime |
| 別名: | DeploymentExpireDay |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-GenerateOperationsManagerAlert
指出是否要在軟體安裝失敗時產生 Operations Manager 警示。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-GenerateSuccessAlert
指出是否要在軟體安裝成功時產生警示。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
| 類型: | IResultObject |
| 別名: | SoftwareUpdate, SoftwareUpdateGroup |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PercentSuccess
指定百分比成功。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PersistOnWriteFilterDevice
指出是否要在暫時重迭上安裝軟體更新，並在稍後認可變更，或是在安裝期限或維護期間認可變更。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ProtectedType
指定受保護的類型。
| 類型: | ProtectedType |
| 接受的值: | NoInstall, RemoteDistributionPoint |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RestartServer
指出是否允許伺服器在軟體更新之後重新啟動。 將此值設定為 $True可防止伺服器重新啟動。 將此值設定為 $False可讓伺服器重新啟動。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RestartWorkstation
指出是否允許工作站在軟體更新之後重新啟動。 將此值設定為 $True可防止電腦重新啟動。 將此值設定為 $False可讓電腦重新啟動。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SendWakeupPacket
指出是否要在部署開始之前將喚醒封包傳送至電腦。 如果此值$True，Configuration Manager 會喚醒計算機進入睡眠狀態。 如果此值$False，則不會喚醒計算機進入睡眠狀態。 若要讓電腦喚醒，您必須先設定網路喚醒。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareInstallation
指出是否允許安裝軟體更新，即使安裝是在維護期間之外也一樣。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareUpdateGroupId
指定軟體更新群組的識別碼。 軟體更新群組包含個別的軟體更新。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareUpdateGroupName
指定軟體更新群組的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareUpdateId
指定 Configuration Manager 中軟體更新的標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareUpdateName
指定 Configuration Manager 中軟體更新的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TimeBasedOn
指定客戶端電腦使用本機或 UTC 時間來判斷程式的可用性。 UTC 時間可讓所有電腦同時使用軟體更新。
| 類型: | TimeType |
| 接受的值: | LocalTime, Utc |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TimeUnit
指定 Configuration Manager 中的時間單位。 有效值為：
- 天
- 小時
- 月份
- 星期
| 類型: | TimeUnitType |
| 接受的值: | Hours, Days, Weeks, Months |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TimeValue
以 TimeUnit 參數中指定的單位指定時間值。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UnprotectedType
指定未受保護的類型。
| 類型: | UnprotectedType |
| 接受的值: | NoInstall, UnprotectedDistributionPoint |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UseBranchCache
指出是否要使用分支快取作為更新的發佈點。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserNotification
指定使用者通知類型。
| 類型: | UserNotificationType |
| 接受的值: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VerbosityLevel
指定詳細資訊層級。 有效值為：
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
| 類型: | VerbosityLevelType |
| 接受的值: | AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object