New-CMApplicationDeployment

模組:

ConfigurationManager

建立應用程式部署。

語法

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMApplicationDeployment Cmdlet 會建立應用程式部署。 如需詳細資訊，請 參閱使用 Configuration Manager 部署應用程式。

注意事項

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

範例

範例 1：安裝應用程式

此命令會建立 Visual Studio 2019 對集合 開發人員工作站的新部署。 它會安裝應用程式，且為必要專案。 可用的日期和期限都是過去的相同時間，因此一旦用戶端收到此原則，就會安裝應用程式。

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

參數

-AllowRepairApp

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

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

-ApprovalRequired

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

類型:	Boolean
別名:	AppRequiresApproval
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeadlineDateTime

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

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

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

-DeployAction

指定要安裝或卸載應用程式的部署動作。 如果競爭部署以相同的裝置為目標， 安裝 動作會優先。

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

-DeployPurpose

指定部署目的：

• Available：使用者在軟體中心看到應用程式。 他們可以視需要安裝它。

• Required：客戶端會根據您設定的排程自動安裝應用程式。 如果應用程式未隱藏，用戶可以追蹤其部署狀態。 他們也可以使用軟體中心在期限之前安裝應用程式。

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

-DisableContentDependencyDetection

新增此參數，不自動發佈相依應用程式的內容。

類型:	SwitchParameter
別名:	DisableDetectAssociatedContentDependencies
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	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

-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

-GenerateScomAlertOnFailure

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

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

-Id

指定要部署之應用程式的識別碼。

類型:	Int32
別名:	CIId, CI_ID, ApplicationId
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

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

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

-Name

指定要部署的應用程式名稱。

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

-OverrideServiceWindow

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

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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

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

-SendWakeupPacket

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

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

-Simulation

新增此參數以建立部署模擬。 如需詳細資訊，請 參閱使用 Configuration Manager 模擬應用程式部署。

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

-UpdateSupersedence

針對可用的部署，請使用此參數來指定安裝期限，以升級已安裝已取代應用程式的使用者或裝置。 使用 DeadlineDateTime 指定特定時間，否則會在 AvailableDateTime 之後儘快完成。

類型:	Boolean
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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

相關連結

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