New-CMApplicationGroupDeployment
建立應用程式群組的部署。
Syntax
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
建立應用程式群組的部署。 應用程式群組包含多個應用程式，而且使用者可在軟體中心中以單一實體形式查看群組。 如需詳細資訊，請參閱 Create application groups。
在部署應用程式群組之前，您必須先建立它。 然後，您可以將其部署到使用者或裝置集合，做為單一部署。
注意
從 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 來指定部署指派或 期限。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
將集合識別碼指定為此應用程式群組部署的目標。
| 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
指定此部署是否可供使用者安裝，或在最後期限安裝時必須安裝。
| Type: | DeployPurposeType |
| Accepted values: | Available, Required |
| 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 |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
當部署失敗時，將此參數設定為 $true 以產生 System Center Operations Manager 警示。
| Type: | Boolean |
| Aliases: | RaiseMomAlertsOnFailure |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定應用程式群組的物件。 若要取得此物件，請使用 CMApplicationGroup Cmdlet。
| Type: | IResultObject |
| Aliases: | ApplicationGroup |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OverrideServiceWindow
將此參數設定為在 $true 維護時段外安裝應用程式群組。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
使用此參數處理 Windows 內嵌裝置的寫入篩選器。 如果您將其設定為 $true ，裝置會在期限或維護時段內提交變更。 此動作需要重新開機。 如果您將其設定為，裝置會將變更儲存到暫時覆迭， $false 然後再提交。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RebootOutsideServiceWindow
將此參數設定為 $true ，可讓裝置在維護時段之外重新開機。
| 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 |
-TimeBaseOn
指定要使用的時區：
LocalTime：使用裝置的本機時間。UTC：使用協調通用時間 (UTC) 。
| Type: | TimeType |
| Accepted values: | LocalTime, Utc |
| 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, ApplicationGroupName |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-識別碼
指定要部署的應用程式群組識別碼。
| Type: | Int32 |
| Aliases: | CIId, CI_ID, ApplicationGroupId |
| 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 |
輸入
ConfigurationManagement IResultObject
輸出
IResultObject
備註
此 Cmdlet 會傳回 SMS_ApplicationGroupAssignment WMI 類別物件。