New-CMApplicationDeployment

模組:

ConfigurationManager

建立應用程式部署。

Syntax

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

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

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

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

-ApprovalRequired

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

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

-AutoCloseExecutable

從2107版開始，將此參數設定為， $true 以啟用安裝行為的應用程式部署設定。 然後使用 CMDeploymentTypeInstallBehavior 指令程式來新增可執行檔，但不執行安裝以成功安裝。

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

• 當您使用 CMDeploymentTypeInstallBehavior 指令程式 移除所有可執行檔時
• 您不想讓部署檢查是否有執行可執行檔。

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

-AvailableDateTime

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

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

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

-CollectionId

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

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

-CollectionName

指定此應用程式部署所在的集合名稱。

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

-Comment

指定此部署的選用批註。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeadlineDateTime

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

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

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

-DeployAction

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

Type:	DeployActionType
Accepted values:	Install, Uninstall
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

指定部署目的：

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

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

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableContentDependencyDetection

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

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

網站會將內容發佈到與此集合名稱相關聯的發佈點。

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

-DistributeContent

如果您需要先散佈應用程式內容，請新增此參數。

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

-DistributionPointGroupName

若要散佈應用程式內容，請指定分配點群組的名稱。

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

-DistributionPointName

若要散佈應用程式內容，請指定發佈點的名稱。

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

-EnableMomAlert

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

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

-EnableSoftDeadline

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

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

-FailParameterValue

指定導致警示之失敗之應用程式安裝所占的百分比。 指定介於1到100的整數。 若要啟用此警示，請將 CreatAlertBaseOnPercentFailure 參數設為 $True 。

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

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

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

-GenerateScomAlertOnFailure

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Application
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OverrideServiceWindow

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

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

-PersistOnWriteFilterDevice

會指出是否要為內嵌裝置啟用寫入篩選器。 針對的值 $True ，裝置會在維護時段內提交變更。 此動作需要重新開機。 針對的值 $False ，裝置會將變更儲存在覆迭的位置，然後再提交。

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

-PostponeDateTime

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

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

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

-PreDeploy

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

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

-RebootOutsideServiceWindow

會指出電腦是否在維護視窗之外重新開機。 維護時段是一段指定的時間，用來進行電腦維護和更新。 如果此值為 $True ，任何必要的重新開機都不會考慮維護視窗。 如果是此值 $False ，電腦不會在維護視窗之外重新開機。

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

-ReplaceToastNotificationWithDialog

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

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

-SendWakeupPacket

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

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

-SuccessParameterValue

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

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

-TimeBaseOn

指定要使用的時區：

• LocalTime：使用當地時間。
• UTC：使用協調通用時間 (UTC) 。

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

-UpdateSupersedence

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

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

-UseMeteredNetwork

會指出是否允許用戶端在截止期限後透過流量計費的網際網路連線來下載內容，這可能會導致額外的費用。

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

-UserNotification

指定使用者通知的類型。

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

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

-WhatIf

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

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

-名稱

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

Type:	String
Aliases:	LocalizedDisplayName, ApplicationName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-識別碼

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

Type:	Int32
Aliases:	CIId, CI_ID, ApplicationId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-集合

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

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

-類比

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

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

相關連結

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