New-CMApplicationGroupDeployment

模組:

ConfigurationManager

建立應用程式群組的部署。

語法

New-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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

建立應用程式群組的部署。 應用程式群組包含多個應用程式，而使用者會在軟體中心將群組視為單一實體。 如需詳細資訊，請 參閱建立應用程式群組。

您必須先建立應用程式群組，才能部署應用程式群組。 然後，您可以將它部署至使用者或裝置集合作為單一部署。

注意事項

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

範例

範例 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

參數

-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

指定集合標識子作為此應用程式群組部署的目標。

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

指定此部署是否可供使用者安裝，或是否需要在期限安裝。

類型:	DeployPurposeType
接受的值:	Available, Required
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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

將此參數設定為 ， $true 以在部署失敗時產生 System Center Operations Manager 警示。

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

-Id

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

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

-InputObject

指定應用程式群組的物件。 若要取得此物件，請使用 Get-CMApplicationGroup Cmdlet。

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

-Name

指定此應用程式群組部署的名稱。

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

-OverrideServiceWindow

將此參數設定為 ， $true 以在維護期間外安裝應用程式群組。

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

-PersistOnWriteFilterDevice

使用此參數來處理 Windows Embedded 裝置的寫入篩選。 如果您將它設定為 $true，裝置會在期限或維護期間認可變更。 此動作需要重新啟動。 如果您將它設定為 $false，裝置會將變更儲存到暫時重疊，並在稍後認可。

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

-RebootOutsideServiceWindow

將此參數設定為 $true ，以允許裝置在維護期間外重新啟動。

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

-SendWakeupPacket

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

備註

此 Cmdlet 會傳回SMS_ApplicationGroupAssignment WMI 類別物件。

相關連結

• Get-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Get-CMApplicationGroup
• 建立應用程式群組