Set-CMApplicationDeployment

模組:

ConfigurationManager

設定應用程式部署

Syntax

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

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

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

-ApplicationId

指定應用程式的識別碼。

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

-ApplicationName

指定應用程式的名稱。

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

-AutoCloseExecutable

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

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

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

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

-AvailableDateTime

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

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

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

指定應用程式部署至其中的集合名稱。

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

-Comment

指定部署的選擇性批註。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-CreateAlertBaseOnPercentFailure

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

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

-CreateAlertBaseOnPercentSuccess

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

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

-DeadlineDateTime

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

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

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

-DisableWildcardHandling

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

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

-EnableMomAlert

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

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

-EnableSoftDeadline

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

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

-FailParameterValue

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

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

-ForceWildcardHandling

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Application, DeploymentSummary, Assignment
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

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

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-PostponeDateTime

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

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

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

-PreDeploy

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

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

-RaiseMomAlertsOnFailure

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

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-RequireApproval

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

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

-SendWakeUpPacket

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

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

-SuccessParameterValue

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

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

-TimeBaseOn

指定要使用的時區：

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

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

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

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

-UserNotification

指定使用者通知的類型。

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

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

備註

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

相關連結

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