Set-CMApplicationDeployment

模組:

ConfigurationManager

設定應用程式部署

語法

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMApplicationDeployment Cmdlet 會修改 Configuration Manager 中應用程式部署的屬性。 如需詳細資訊，請 參閱使用 Configuration Manager 部署應用程式。

若要指定要修改的應用程式部署，請指定集合名稱和應用程式。 您可以依名稱或識別子指定應用程式。 您也可以使用 Get-CMApplication Cmdlet 來取得要修改的應用程式。

注意事項

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

範例

範例 1：修改應用程式部署的可用性和期限

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

此命令會針對名為 Track System 2011 的集合，修改名為 Track System 2011 之應用程式的 應用程式部署。 命令會指定應用程式可用的目前日期。 它也會設定未來 30 天的部署期限。

參數

-AllowRepairApp

建立應用程式的部署時，請使用此參數來設定修復應用程式選項。

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

-ApplicationId

指定應用程式的識別碼。

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

-ApplicationName

指定應用程式的名稱。

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

-AutoCloseExecutable

從 2107 版開始，將此參數設定為 $true ，以啟用安裝行為的應用程式部署設定。 然後使用 Add-CMDeploymentTypeInstallBehavior Cmdlet 來新增可執行檔，以檢查安裝是否未執行，以成功安裝。

將此參數設定為 $false ，以在下列情況下停用此選項：

• 當您使用 Remove-CMDeploymentTypeInstallBehavior Cmdlet 移除所有可執行檔時
• 您不想讓部署檢查執行中的可執行檔。

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

-AvailableDateTime

指定此部署可用時的 DateTime 物件。 若要取得此物件，請使用 Get-Date 內建 Cmdlet。

使用 DeadlineDateTime 指定部署指派或 期限。

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

-Collection

指定要部署應用程式的集合物件。 若要取得此物件，請使用 Get-CMCollection Cmdlet。

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

-CollectionId

指定要部署應用程式之集合的識別碼。 例如，"SMS00004"。

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

-CreateAlertBaseOnPercentFailure

指出是否要針對無法部署的應用程式百分比建立警示。 若要指定百分比值，請使用 FailParameterValue 參數。

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

-CreateAlertBaseOnPercentSuccess

指出是否要針對成功部署的應用程式百分比建立警示。 若要指定百分比值，請使用 SuccessParameterValue 參數。

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

-DeadlineDateTime

指定指派此部署時的 DateTime 物件，也稱為 期限。 若要取得此物件，請使用 Get-Date 內建 Cmdlet。

使用 -AvailableDateTime 指定部署 可用的時間。

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

-DisableWildcardHandling

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

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

-EnableMomAlert

將此參數設定為 ， $true 以啟用此部署的 System Center Operations Manager 維護模式。

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

-EnableSoftDeadline

將此參數設定為 ， $true 以啟用延遲強制執行。

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

-FailParameterValue

指定造成警示的應用程式安裝失敗百分比。 指定從 1 到 100 的整數。 若要啟用此警示，請將 CreatAlertBaseOnPercentFailure 參數設定為 $True。

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

-ForceWildcardHandling

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

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

-InputObject

指定要設定的應用程式部署物件。 若要取得此物件，請使用 Get-CMApplicationDeployment Cmdlet。

類型:	IResultObject
別名:	Application, DeploymentSummary, Assignment
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-OverrideServiceWindow

指出即使排程在維護期間之外，還是會進行部署。 維護期間是用於計算機維護和更新的指定時間週期。 如果此值為 $True，Configuration Manager 會部署應用程式，即使排程的時間落在維護期間之外也一樣。 如果此值為 $False，Configuration Manager 就不會在視窗外部署應用程式。 它會等候，直到可以在可用的視窗中部署為止。

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

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

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

-PersistOnWriteFilterDevice

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

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

-PostponeDateTime

當您將 CreateAlertBaseOnPercentSuccess 設定為 $true時，請使用此參數來指定 DateTime 物件。 當閾值低於這個日期之後的 SuccessParameterValue 時，Configuration Manager 會建立部署警示。

若要取得此物件，請使用 Get-Date 內建 Cmdlet。

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

-PreDeploy

指出是否要將應用程式預先部署至使用者的主要裝置。

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

-RaiseMomAlertsOnFailure

指出客戶端無法安裝應用程式時，是否要建立 Operations Manager 警示。

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

當用戶端上有必要的軟體可用時，請將此參數設定為 $true ，以對話框視窗取代預設快顯通知。 默認為 false。 如需詳細資訊，請參閱 使用對話框視窗取代快顯通知。

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

-RequireApproval

如果您將此參數設定為 $true，系統管理員必須在裝置上核准此應用程式的要求。

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

-SendWakeUpPacket

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

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

-SuccessParameterValue

指定造成警示之成功應用程式安裝的百分比。 指定從 0 到 99 的整數。 若要啟用此警示，請將 CreateAlertBaseOnPercentSuccess 參數設定為 $True。

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

-TimeBaseOn

指定要使用的時區：

• LocalTime：使用當地時間。
• UTC：使用國際標準時間 (UTC) 。

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

-UseMeteredNetwork

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

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

-UserNotification

指定使用者通知的類型。

• DisplayAll：在軟體中心顯示並顯示所有通知。
• DisplaySoftwareCenterOnly：顯示在軟體中心，且只會顯示計算機重新啟動的通知。
• HideAll：在軟體中心和所有通知中隱藏。

類型:	UserNotificationType
接受的值:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

備註

如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_ApplicationAssignment伺服器 WMI 類別。

相關連結

• Get-CMApplication
• Get-CMApplicationDeployment
• New-CMApplicationDeployment
• Remove-CMApplicationDeployment
• 使用 Configuration Manager 部署應用程式