New-CMPackageDeployment

模組:

ConfigurationManager

將舊版套件部署至集合。

Syntax

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-Package] <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-Program] <IResultObject>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageName <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageId <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Package] <IResultObject>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Program] <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 可將套件部署至集合中的資源。 您可以依識別碼、名稱或傳遞物件來指定集合。

針對您無法使用此 Cmdlet 進行設定的其他部署設定，請使用 CMPackageDeployment。

如需詳細資訊，請參閱 Configuration Manager 中的套件和程式。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。

範例

範例1：依識別碼部署套件

這個命令會建立 id 為 XYZ00001 的套件部署至具有 id XYZ0003F的集合。

$pkgId = "XYZ00001"
$collId = "XYZ0003F"
New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName "ScanState" -CollectionID $collId -Comment "Use USMT to scan for data" -DeployPurpose Available

範例2：在必要時使用期限部署套件

第一個命令會將截止日期的變數設定為從現在 8:00 PM 開始的10天。 第二個命令會根據每日重複的期限，建立排程物件。 第三個命令會以該排程建立套件部署。

[datetime]$DeadlineTime = (Get-Date -Hour 20 -Minute 0 -Second 0).AddDays(10)

$NewScheduleDeadline = New-CMSchedule -Start $DeadlineTime -Nonrecurring

$pkgId = "XYZ00001"
$progName = "Run"
$collId = "XYZ0003F"

New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName $progName -DeployPurpose Required -CollectionId $collId -FastNetworkOption DownloadContentFromDistributionPointAndRunLocally -SlowNetworkOption DownloadContentFromDistributionPointAndLocally -RerunBehavior RerunIfFailedPreviousAttempt -Schedule $NewScheduleDeadline

參數

-AllowFallback

允許用戶端使用預設網站邊界群組中的散佈點。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowSharedContent

允許用戶端使用鄰居邊界群組中的散佈點。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableDateTime

指定此部署的 _提供_時機。

使用 -DeadlineDateTime可指定部署何時_到期_，以及指定部署指派或_期限_的排程。

若要取得 DateTime 物件，請使用 Get-Date Cmdlet。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

將集合識別碼指定為此套件部署的目標。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

將集合名稱指定為此套件部署的目標。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-Comment

指定此套件部署的選用批註。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 之前，將此參數新增至提示確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineDateTime

使用此參數可指定部署何時 到期。

使用 -AvailableDateTime可指定部署的時機及排程 ，以_指定部署指派或_期限。

若要取得 DateTime 物件，請使用 Get-Date Cmdlet。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

指定此部署是否可供使用者安裝，或在最後期限安裝時必須安裝。

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceProgram

如果您要部署之套件的程式是裝置類型程式，請指定此參數。

否則，請使用 StandardProgram 參數。 標準程式類型適用于具有 Configuration Manager 用戶端的電腦。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributeCollectionName

網站會將內容發佈到與此集合名稱相關聯的發佈點群組。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributeContent

當您建立此部署時，新增此參數以散佈套件內容。 用戶端無法安裝套件，除非您將內容發佈至用戶端可以存取的發佈點。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointGroupName

網站會將內容發佈至此發佈點群組。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointName

網站會將內容發佈至此發佈點。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FastNetworkOption

指定用戶端使用目前邊界群組中的發行點時的行為：

• 從發佈點執行程式
• 從發佈點下載內容，並在本機執行

如果您未指定此參數，則預設會使用它 DownloadContentFromDistributionPointAndRunLocally 。 因為用戶端會在執行程式之前驗證內容雜湊，所以此選項更安全。

Type:	FastNetworkOptionType
Accepted values:	RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageId

使用要部署的程式指定套件的識別碼。 例如，此識別碼為標準套件識別碼 XYZ007E3 。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

使用要部署的程式指定套件的名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistOnWriteFilterDevice

設定用戶端在 Windows 內嵌裝置上處理寫入篩選的方式。

• $true：在截止期限或維護時段內認可變更。 需要重新開機。
• $false：在覆蓋上套用內容，稍後再認可。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramName

指定要部署之套件中的程式名稱。

Type:	String
Aliases:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurUnit

指定定期部署的單位。 使用 RecurValue 參數可指定此單位的值。

Type:	RecurUnitType
Accepted values:	Minutes, Hours, Days
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RecurValue

指定部署的重複頻率。

此參數取決於 RecurUnit 參數中所指定的單位類型：

• 時數：此值可以介於 1 和之間23
• 天：介於 1 和之間 31
• 分鐘：介於 1 和之間 59

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RerunBehavior

指定程式是否要在電腦上重新開啟。

• NeverRerunDeployedProgram：即使部署失敗或檔變更，也不會重新執行。
• AlwaysRerunProgram：即使部署成功，也會以排程方式重新執行。 您可以將此值用於定期部署。 此值為預設值。
• RerunIfFailedPreviousAttempt：若在先前嘗試的部署失敗，請依排程重新執行。
• RerunIfSucceededOnPreviousAttempt：只有在先前嘗試成功時才能重新執行。

Type:	RerunBehaviorType
Accepted values:	NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunFromSoftwareCenter

允許使用者獨立于工作分派執行程式。

Type:	Boolean
Aliases:	AllowUsersRunIndependently
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

使用此參數可指定部署指派或 期限。

使用 -AvailableDateTime 可指定部署何時 可用，以及 -DeadlineDateTime 以指定部署何時 到期。

指定排程物件的陣列。 排程物件會定義部署的強制指派排程。 若要建立排程物件，請使用 CMSchedule Cmdlet。

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScheduleEvent

指定決定何時執行套件部署的事件種類。

Type:	ScheduleEventType
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

會指出是否要在部署開始之前，將喚醒的封包傳送到電腦。 如果此值為 $True ，Configuration Manager 會從睡眠中喚醒電腦。 如果此值為 $False ，則不會從睡眠喚醒電腦。 若要讓電腦喚醒，請先設定 LAN 喚醒。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SlowNetworkOption

指定用戶端使用鄰居邊界群組或預設網站邊界群組中的發行點時的行為：

• 不執行程式
• 從發佈點下載內容，並在本機執行
• 從發佈點執行程式

如果您未指定此參數，則預設會使用它 DoNotRunProgram 。

Type:	SlowNetworkOptionType
Accepted values:	DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareInstallation

當達到安裝期限時，請將此參數設定為，以 $true 允許套件在維護時段外安裝。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardProgram

請將此參數用於標準方案類型。 這種類型適用于具有 Configuration Manager 用戶端的電腦。

如果您要部署之套件的程式是裝置類型程式，請使用 DeviceProgram 參數。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SystemRestart

當達到安裝期限時，將此參數設定為 $true 允許在維護時段外的必要時重新開機系統。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

會指出是否允許依流量計費的網際網路連線上的用戶端在安裝期限後下載內容，這可能會導致較高的成本。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtc

會指出用戶端是否 (UTC) 使用協調通用時間，以判斷程式的可用性。 UTC 時間可讓所有電腦同時進行部署。 如果您未指定此參數，或將其設定為 $false ，用戶端會使用本機時間。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtcForAvailableSchedule

會指出用戶端是否 (UTC) 使用協調通用時間，以判斷程式的可用性。 UTC 時間可讓所有電腦同時進行部署。 如果您未指定此參數，或將其設定為 $false ，用戶端會使用本機時間。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseUtcForExpireSchedule

會指出用戶端是否 (UTC) 使用協調通用時間，以判斷程式何時到期。 UTC 時間會在所有電腦上同時到期部署。 如果您未指定此參數，或將其設定為 $false ，用戶端會使用本機時間。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-封裝

使用要部署的程式指定 package 物件。 若要取得此物件，請使用 CMPackage Cmdlet。

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-程式

指定要部署的 program 物件。 若要取得此物件，請使用 CMProgram Cmdlet。

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-重新執行

指出是否要重新執行部署：

• $True：針對 RerunBehavior 參數中所指定的用戶端，部署會重新執行。 此值為預設值。
• $False：部署不會再次執行。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-集合

指定集合物件做為此套件部署的目標。 若要取得此物件，請使用 CMCollection Cmdlet。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

相關連結

• CMPackageDeployment
• CMPackageDeploymentStatus
• CMPackageDeployment
• Remove-CMPackageDeployment
• CMPackage
• Configuration Manager 中的套件和程式