Start-CMPackageDeployment

參考

模組:: ConfigurationManager

(已淘汰) 開始將軟體套件部署至 Configuration Manager 集合。

語法

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-Package] <IResultObject>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageName <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageId <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-Program] <IResultObject>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageName <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageId <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-Package] <IResultObject>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-PassThru]
     [-Program] <IResultObject>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

重要事項

此 Cmdlet 已被取代。請改用 New-CMPackageDeployment 。

Start-CMPackageDeployment Cmdlet 會開始將指定的軟體套件部署到屬於 Configuration Manager 集合的計算機。您可以選擇套件可供使用的時間，以及套件部署到期的時間。您可以指定 Configuration Manager 只部署一次或重複部署套件，以及電腦安裝失敗時會發生什麼情況。

注意事項

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

範例

範例 1：啟動週期性部署

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True

此命令會針對名為 DPM 的裝置程式，開始將具名套件部署至名為 All Systems 的集合。命令會指定開始日期和開始時間。命令包含描述性批注。 Rerun 參數的值為 $True，而命令會指定 7 個週期值和一個週期單位 Days，因此部署每七天會重新執行一次。部署會使用計量付費網路。部署會使用UTC時間。

範例 2：針對可用的套件開始週期性部署

PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True

此命令會針對名為 DPM 的裝置程式，開始將具名套件部署至名為 Western Computers 的集合。命令包含描述性批注。命令會指定 [可用] 作為 DeployPurpose，讓使用者可以決定是否要安裝此軟體。 Rerun 參數的值為 $True。部署會使用UTC時間。

範例 3：開始部署標準程式

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False

此命令會針對名為 SPM 的標準程式，開始將名為 User State Migration Tool for Windows 8 的套件部署至名為 All Systems 的集合。命令不允許電腦使用共享內容。

參數

-AllowSharedContent

指出用戶端是否使用共享內容。如果$True此值，用戶端會嘗試從下載該內容的其他用戶端下載內容。如果此值$False，用戶端就不會嘗試從其他用戶端下載。

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

-CollectionName

指定裝置或使用者集合的識別碼。

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

-Comment

指定部署的批注。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeploymentAvailableDateTime

指定作為 DateTime 物件的部署可用的日期和時間。若要取得 DateTime 物件，請使用 Get-Date Cmdlet。

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

-DeploymentAvailableDay

已過時。使用 DeploymentAvailableDateTime。

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

-DeploymentAvailableTime

已過時。請改用 DeploymentAvailableDateTime 。

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

-DeploymentExpireDateTime

將部署到期的日期和時間指定為 DateTime 物件。若要取得 DateTime 物件，請使用 Get-Date Cmdlet。

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

-DeploymentExpireDay

已過時。請改用 DeploymentExpireDateTime 。

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

-DeploymentExpireTime

已過時。使用 DeploymentExpireDateTime。

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

-DeploymentStartDateTime

指定作為 DateTime 物件的部署開始日期和時間。若要取得 DateTime 物件，請使用 Get-Date Cmdlet。

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

-DeploymentStartDay

已過時。使用 DeploymentStartDateTime。

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

-DeploymentStartTime

已過時。使用 DeploymentStartDateTime。

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

-DeployPurpose

指定部署的目的。此參數可接受的值為：

可以使用
必要

類型:	DeployPurposeType
接受的值:	Available, Required
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeviceProgram

指定裝置程式。

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

-DisableWildcardHandling

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

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

-FastNetworkOption

指定快速網路上的客戶端行為。此參數可接受的值為：

DownloadContentFromDistributionPointAndRunLocally
RunProgramFromDistributionPoint

類型:	FastNetworkOptionType
接受的值:	RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

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

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

-Package

指定封裝物件。若要取得封裝物件，請使用 Get-CMPackage Cmdlet。

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

-PackageId

指定封裝的識別碼。

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

-PackageName

指定封裝的名稱。

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

-PassThru

傳回目前的工作物件。根據預設，這個 Cmdlet 不會產生任何輸出。

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

-PersistOnWriteFilterDevice

指出是否啟用內嵌裝置的寫入篩選。針對$True值，裝置會在維護期間認可變更。此動作需要重新啟動。針對$False值，裝置會將變更儲存在重疊中，並在稍後認可。

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

-Program

指定程式。

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

-ProgramName

指定程序的名稱。

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

-RecurUnit

指定週期性部署的單位。此參數可接受的值為：

天
小時
分鐘

類型:	RecurUnitType
接受的值:	Minutes, Hours, Days
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RecurValue

指定部署周期的頻率。此參數取決於 RecurUnit 參數中指定的單位類型。如果單位為 Hours，此值可以介於 1 到 23 之間，如果單位為 Days，則介於 1 到 31 之間;如果單位為 Minutes，則介於 1 到 59 之間。

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

-Rerun

指出部署是否重新執行。如果此值$True，則會如 RerunBehavior 參數中所指定，針對用戶端再次執行部署。如果此值$False，則不會再次執行部署。

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

-RerunBehavior

指定如何在用戶端上重新執行部署。此參數可接受的值為：

AlwaysRerunProgram。如已排程重新執行，即使部署成功也一樣。您可以將此值用於週期性部署。
NeverRerunDeployedProgram。即使部署失敗或檔案變更，也不會重新執行。
RerunIfFailedPreviousAttempt。如果在上一次嘗試時部署失敗，請依排程重新執行。
RerunIfSucceededOnpreviousAttempt。只有在上一次嘗試成功時才重新執行。您可以將此值用於相依於先前更新的更新。

類型:	RerunBehaviorType
接受的值:	NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RunFromSoftwareCenter

指出是否要從軟體中心執行。

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

-Schedule

指定部署的排程物件。

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

-ScheduleEvent

指定排程事件類型的陣列。此參數可接受的值為：

AsSoonAsPossible
註銷
LogOn
SendWakeUpPacket

類型:	ScheduleEventType
接受的值:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SendWakeupPacket

指出是否要在部署開始之前將喚醒封包傳送至電腦。如果此值$True，Configuration Manager 會喚醒計算機進入睡眠狀態。如果此值$False，則不會喚醒計算機進入睡眠狀態。若要讓電腦喚醒，您必須先設定網路喚醒。

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

-SlowNetworkOption

指定 Configuration Manager 如何在慢速網路中部署此套件。此參數可接受的值為：

DoNotRunProgram
DownloadContentFromDistributionPointAndLocally
RunProgramFromDistributionPoint

類型:	SlowNetworkOptionType
接受的值:	DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SoftwareInstallation

指出是否要在維護期間以外安裝已部署的軟體。維護期間是用於計算機維護和更新的指定時間週期。如果此值$True，Configuration Manager 會根據排程安裝軟體，即使排程落在維護期間之外也一樣。如果此值$False，Configuration Manager 不會在任何視窗外安裝已部署的軟體，但會等候維護期間。

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

-StandardProgram

指出部署套件中的程式類型是標準程式。

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

-SystemRestart

指出系統是否在維護期間外重新啟動。維護期間是用於計算機維護和更新的指定時間週期。如果此值$True，則會進行任何必要的重新啟動，而不考慮維護時段。如果$False此值，計算機就不會在維護期間外重新啟動。

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

-UseMeteredNetwork

指出是否允許用戶端在期限之後透過計量付費因特網連線下載內容，這可能會產生額外費用。

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

-UseUtc

指出是否要使用國際標準時間 (UTC) ，也稱為 Greenwich 平均時間。如果此值$True，Configuration Manager 會針對此部署使用 UTC。如果此值$False，Configuration Manager 會使用當地時間。

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

-UseUtcForAvailableSchedule

指出是否要針對可用的排程使用UTC。如果此值$True，Configuration Manager 會使用 UTC。如果此值$False，Configuration Manager 會使用當地時間。

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

-UseUtcForExpireSchedule

指出是否要針對到期排程使用UTC。如果此值$True，Configuration Manager 會使用 UTC。如果此值$False，Configuration Manager 會使用當地時間。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

共用方式為