New-CMApplicationGroup
建立新的應用程式群組。
語法
New-CMApplicationGroup
[-Name] <String>
-AddApplication <String[]>
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-AddSupportContact <String[]>]
[-AppGroupCatalog <AppDisplayInfo[]>]
[-DefaultLanguageId <Int32>]
[-LocalizedName <String>]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 建立應用程式群組。 使用應用程式群組將多個應用程式部署至集合作為單一部署。 您指定的應用程式群組相關元數據會在軟體中心中視為單一實體。 您可以在群組中訂購應用程式，讓用戶端以特定順序安裝它們。 如需詳細資訊，請 參閱建立應用程式群組。
有一些應用程式群組的設定，您無法在建立應用程式群組時進行設定。 若要設定其他設定，請使用 Set-CMApplicationGroup Cmdlet。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：建立具有兩個應用程式的群組
此範例會建立名為 Central 應用程式 的新應用程式群組，其中包含兩個應用程式。
$apps = @('LOB Framework','CA UI')
New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'參數
-AddApplication
指定要新增至群組之應用程式名稱的字串陣列。 如果您已經有另一個 Cmdlet 的應用程式物件，例如 Get-CMApplication，這個值就是 LocalizedDisplayName 屬性。 例如：$appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
| 類型: | String[] |
| 別名: | AddApplications |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AddOwner
指定負責此應用程式群組的一或多個系統管理使用者。
| 類型: | String[] |
| 別名: | AddOwners |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AddSupportContact
指定使用者可以連絡的一或多個系統管理使用者，以取得此應用程式的協助。
| 類型: | String[] |
| 別名: | AddSupportContacts |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AppGroupCatalog
使用此參數來指定特定語言的軟體中心專案。 這個項目可以包含應用程式群組的所有本地化資訊：
- 描述
- IconLocationFile
- 關鍵字
- LinkText
- PrivacyUrl
- 標題
- UserDocumentation
若要取得此物件，請使用 New-CMApplicationDisplayInfo Cmdlet。
| 類型: | AppDisplayInfo[] |
| 別名: | AppCatalogs |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultLanguageId
指定預設軟體中心語言的語言標識碼。
此標識子是 Windows 語言識別子的小數對等專案。 例如， 10330x0409 適用於 英文 (美國) ，而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊，請參閱 [MS-LCID]： Windows 語言代碼識別碼 (LCID) 參考。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定應用程式群組的選擇性系統管理員批注。 最大長度為 2048 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IconLocationFile
指定包含此應用程式群組圖示的檔案路徑。 圖示可以有最多 512x512 的像素維度。 檔案可以是下列影像和圖示檔案類型：
- DLL
- EXE
- JPG
- ICO
- PNG
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Keyword
以選取的語言指定關鍵詞清單。 這些關鍵詞可協助軟體中心用戶搜尋應用程式群組。
提示
若要新增多個關鍵詞，請使用 CultureInfo.CurrentCulture.TextInfo.ListSeparator 作為分隔符。
| 類型: | String[] |
| 別名: | Keywords |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LinkText
當您使用 UserDocumentation 參數時，請使用此參數來顯示字串，以取代軟體中心的「其他資訊」。 最大長度為 128 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LocalizedDescription
以選取的語言指定此應用程式群組的描述。 最大長度為 2048 個字元。
| 類型: | String |
| 別名: | LocalizedAppGroupDescription |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LocalizedName
以選取的語言指定應用程式群組名稱。 此名稱會出現在軟體中心。
您新增的每個語言都需要名稱。
最大長度為 256 個字元。
| 類型: | String |
| 別名: | LocalizedAppGroupName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定應用程式群組的名稱。 最大長度為 256 個字元。
| 類型: | String |
| 別名: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OptionalReference
指定選擇性字串，以協助您在控制台中尋找應用程式群組。 最大長度為 256 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PrivacyUrl
指定應用程式群組隱私聲明的網站位址。 格式必須是有效的 URL，例如 https://contoso.com/privacy。 整個字串的最大長度為 128 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Publisher
指定此應用程式群組的選擇性廠商資訊。 最大長度為 256 個字元。
| 類型: | String |
| 別名: | Manufacturer |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ReleaseDate
指定此應用程式群組發行時間的日期物件。 若要取得此物件，請使用 Get-Date 內建 Cmdlet。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SoftwareVersion
指定應用程式群組的選擇性版本字串。 最大長度為 64 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserDocumentation
指定軟體中心使用者可以從中取得此應用程式群組詳細信息的檔案位置。 此位置是網站位址，或網路路徑和檔名。 請確定使用者可以存取此位置。
整個字串的最大長度為 256 個字元。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
輸出
IResultObject
備註
此 Cmdlet 會傳回 SMS_ApplicationGroup WMI 類別物件。