New-CMApplicationDeployment
建立應用程式部署。
語法
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