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 參數中指定的單位類型:
-
小時:此值可以介於 和 之間
1
23
-
天數:介於 和 之間
1
31
-
分鐘:介於 和 之間
1
59
類型: | 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