Set-CMPackageDeployment
變更定義 Configuration Manager 如何部署軟體套件的值。
語法
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-InputObject <IResultObject>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageId <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-InputObject <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-CMPackageDeployment Cmdlet 會變更定義 Configuration Manager 如何部署軟體套件的值。 部署包含裝置或使用者的集合、要部署的套件,以及裝置程式名稱或標準程式名稱。 若要指定要修改的部署,請指定集合名稱、套件和程序名稱。 您可以依名稱或識別碼指定套件,也可以使用 Get-CMPackage Cmdlet 來取得套件物件。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:設定週期屬性
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True
此命令會變更名為 All Systems 的集合、名為 DPM 的裝置程式,以及名為 User State Migration Tool for Windows 8 的套件所指定的部署。 命令會將 UseRecurrencePattern 參數設定為 $True的值。 命令會指定 [時數] 的遞歸單位,並指定 7 個遞歸值。 因此,部署會每隔七小時重複一次。
範例 2:設定可用性日期和時間
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False
此命令會變更名為 All Systems 的集合、名為 User State Migration Tool for Windows 8 的套件,以及名為 SPM 的標準程式所指定的部署。 命令會指定部署可用的日期和時間。 命令也會指定部署不會針對可用性排程使用UTC。 排程是指當地時區。
參數
-AllowFallback
{{ 填入 AllowFallback 描述 }}
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-AllowSharedContent
指出用戶端是否使用共享內容。 如果$True此值,用戶端會嘗試從下載該內容的其他用戶端下載內容。 如果此值$False,用戶端就不會嘗試從其他用戶端下載。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Collection
指定使用者集合。
類型: | 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 |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentAvailableDateTime
指定作為 DateTime 物件的部署可用的日期和時間。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentExpireDateTime
將部署到期的日期和時間指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentStartDateTime
指定作為 DateTime 物件的部署開始日期和時間。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeviceProgramName
指定裝置程式的名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-EnableExpireSchedule
指出是否要讓排程讓部署過期。
類型: | Boolean |
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 |
-InputObject
指定封裝物件。
類型: | IResultObject |
別名: | Package, DeploymentSummary, Advertisement |
Position: | Named |
預設值: | 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 |
-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, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RunFromSoftwareCenter
指出是否要從軟體中心執行。
類型: | Boolean |
別名: | AllowUsersRunIndependently |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Schedule
指定 CMSchedule 物件。 排程會指定維護期間的發生時間。 若要建立 CMSchedule 物件,請使用 New-CMSchedule Cmdlet。
類型: | 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 |
-StandardProgramName
指定標準程式名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-SystemRestart
指出系統是否在維護期間外重新啟動。 維護期間是用於計算機維護和更新的指定時間週期。 如果此值$True,則會進行任何必要的重新啟動,而不考慮維護時段。 如果$False此值,計算機就不會在維護期間外重新啟動。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UseRecurrencePattern
指出是否要使用週期模式。
類型: | 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