共用方式為


New-CMPackageDeployment

將舊版套件部署至集合。

語法

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 設定的其他部署設定,請使用 Set-CMPackageDeployment

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

注意事項

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

範例

範例 1:依標識碼部署套件

此命令會建立套件的部署,其標識 碼XYZ00001 至標識 碼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 的 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

允許用戶端使用預設月台界限群組中的發佈點。

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

-AllowSharedContent

允許用戶端使用鄰近界限群組中的發佈點。

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

-AvailableDateTime

指定此部署可用的 時機

使用 -DeadlineDateTime 指定部署 到期時間,並 使用 -Schedule 指定部署指派或 期限

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

類型:DateTime
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
接受萬用字元:True

-Comment

指定此套件部署的選擇性批注。

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

-Confirm

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

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

-DeadlineDateTime

使用此參數來指定部署 到期的時間

使用 -AvailableDateTime 指定部署 可用的時間,並 使用 -Schedule 來指定部署指派或 期限

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

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

-DeployPurpose

指定此部署是否可供使用者安裝,或是否需要在期限安裝。

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

-DeviceProgram

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

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

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

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

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

-DistributeContent

新增此參數,以在建立此部署時發佈套件內容。 在您將內容發佈至用戶端可存取的發佈點之前,客戶端無法安裝套件。

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

-DistributionPointGroupName

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

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

-DistributionPointName

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

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

-FastNetworkOption

指定用戶端使用目前界限群組中的發佈點時的行為:

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

如果您未指定此參數,預設會使用 DownloadContentFromDistributionPointAndRunLocally 。 此選項較安全,因為用戶端會在執行程式之前驗證內容哈希。

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

使用要部署的程式指定封裝的標識碼。 這個識別碼是標準套件識別碼,例如 XYZ007E3

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

-PackageName

使用要部署的程式指定封裝的名稱。

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

-PersistOnWriteFilterDevice

設定用戶端如何處理 Windows Embedded 裝置上的寫入篩選器。

  • $true:在期限或維護期間認可變更。 需要重新啟動。
  • $false:在重迭上套用內容,稍後再認可。
類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Program

指定要部署的程序物件。 若要取得此物件,請使用 Get-CMProgram Cmdlet。

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

-ProgramName

指定要部署之封裝中的程序名稱。

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

-RecurUnit

指定週期性部署的單位。 使用 RecurValue 參數來指定此單元的值。

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

-RecurValue

指定部署周期的頻率。

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

  • 小時:此值可以介於 和 之間123
  • 數:介於 和 之間131
  • 分鐘:介於 和 之間159
類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Rerun

指出部署是否重新執行:

  • $True:部署會針對 RerunBehavior 參數中指定的用戶端再次執行。 此值為預設值。
  • $False:部署不會再次執行。
類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RerunBehavior

指定程式是否在電腦上重新執行。

  • NeverRerunDeployedProgram:即使部署失敗或檔案變更,也不會重新執行。
  • AlwaysRerunProgram:如已排程重新執行,即使部署成功也一樣。 您可以將此值用於週期性部署。 此值為預設值。
  • RerunIfFailedPreviousAttempt:如果在上一次嘗試時部署失敗,請依排程重新執行。
  • RerunIfSucceededOnPreviousAttempt:只有在上一次嘗試成功時才重新執行。
類型:RerunBehaviorType
接受的值:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunFromSoftwareCenter

允許用戶獨立於指派執行程式。

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

-Schedule

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

使用 -AvailableDateTime 指定部署 可用的時間,並使用 -DeadlineDateTime 指定部署 到期時間

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

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

-ScheduleEvent

指定決定封裝部署執行時間的事件類型。

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

-SendWakeupPacket

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

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

-SlowNetworkOption

指定客戶端從鄰近界限群組或預設站台界限群組使用發佈點時的行為:

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

如果您未指定此參數,預設會使用 DoNotRunProgram

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

-SoftwareInstallation

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

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

-StandardProgram

針對標準程式類型使用此參數。 此類型適用於具有 Configuration Manager 用戶端的電腦。

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

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

-SystemRestart

達到安裝期限時,請將此參數設定為 $true ,以在必要時段外允許系統重新啟動。

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

-UseMeteredNetwork

指出是否允許計量付費因特網連線上的用戶端在安裝期限之後下載內容,這可能會產生更多成本。

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

-UseUtc

指出用戶端是否使用國際標準時間 (UTC) 來判斷程式的可用性。 UTC 時間可讓所有電腦同時使用部署。 如果您未指定此參數,或將其設定為 $false,則用戶端會使用其當地時間。

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

-UseUtcForAvailableSchedule

指出用戶端是否使用國際標準時間 (UTC) 來判斷程式的可用性。 UTC 時間可讓所有電腦同時使用部署。 如果您未指定此參數,或將其設定為 $false,則用戶端會使用其當地時間。

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

-UseUtcForExpireSchedule

指出用戶端是否使用國際標準時間 (UTC) 來判斷程式何時過期。 UTC 時間會讓所有電腦的部署同時過期。 如果您未指定此參數,或將其設定為 $false,則用戶端會使用其當地時間。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object