Set-CMApplicationGroup

模組:

ConfigurationManager

設定現有的應用程式群組。

語法

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 來設定現有應用程式群組的設定。 使用應用程式群組將多個應用程式部署至集合作為單一部署。 您指定的應用程式群組相關元數據會在軟體中心中視為單一實體。 您可以在群組中訂購應用程式，讓用戶端以特定順序安裝它們。 如需詳細資訊，請 參閱建立應用程式群組。

注意事項

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

範例

範例 1：重新命名應用程式群組

這個範例會取得應用程式群組的物件，並將它傳遞給這個 Cmdlet 來重新命名它。

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

範例 2：新增本地化名稱

這個範例會使用 愛爾蘭 語言的當地語系化應用程式名稱來設定應用程式群組。

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

參數

-AddAppCatalog

使用此參數來指定特定語言的軟體中心專案。 這個項目可以包含應用程式群組的所有本地化資訊：

• 描述
• IconLocationFile
• 關鍵字
• LinkText
• PrivacyUrl
• 標題
• UserDocumentation

若要取得此物件，請使用 New-CMApplicationDisplayInfo Cmdlet。

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

-AddAppCategory

指定一或多個系統管理類別物件，以協助您在控制台中篩選和尋找應用程式群組。 若要取得這些物件，請使用 Get-CMCategory Cmdlet。 這些類別屬於 AppCategories類型。

若要新增類別以協助使用者在軟體中心篩選和尋找應用程式，請使用 AddUserCategory 參數。

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

-AddApplication

指定要新增至群組之應用程式名稱的字串陣列。 如果您已經有另一個 Cmdlet 的應用程式物件，例如 Get-CMApplication，這個值就是 LocalizedDisplayName 屬性。 例如：$appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

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

-AddOwner

指定負責此應用程式群組的一或多個系統管理使用者。

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

-AddSupportContact

指定使用者可以連絡的一或多個系統管理使用者，以取得此應用程式的協助。

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

-AddUserCategory

指定一或多個使用者類別物件，以協助您在控制台中篩選和尋找應用程式群組。 若要取得這些物件，請使用 Get-CMCategory Cmdlet。 這些類別屬於 CatalogCategories 類型。

若要新增類別以協助使用者在軟體中心篩選和尋找應用程式，請使用 AddAppCategory 參數。

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

-ApplyToLanguageById

對於顯示在軟體中心的設定，請使用此參數來指定設定的語言標識碼。

此標識子是 Windows 語言識別子的小數對等專案。 例如， 10330x0409 適用於 英文 (美國) ，而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊，請參閱 [MS-LCID]： Windows 語言代碼識別碼 (LCID) 參考。

例如，若要為 愛爾蘭 (愛爾蘭 新增本地化應用程式名稱) ：

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

新增此參數以移除所有系統管理類別。 若要移除單一類別，請使用 RemoveAppCategory 參數。

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

-CleanUserCategory

新增此參數以移除所有用戶類別。 若要移除單一類別，請使用 RemoveUserCategory 參數。

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

-ClearAppCatalog

新增此參數以移除所有本地化的軟體中心專案。 若要移除單一專案，請使用 RemoveAppCatalog 參數。

類型:	SwitchParameter
別名:	ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClearOwner

新增此參數以移除所有擁有者。 若要移除單一擁有者，請使用 RemoveOwner 參數。

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

-ClearSupportContact

新增此參數以移除所有支持聯繫人。 若要移除單一聯繫人，請使用 RemoveSupportContact 參數。

類型:	SwitchParameter
別名:	CleanSupportContacts
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

-Id

指定要設定之應用程式群組的識別碼。 這個值與 CI_ID相同，例如 1025866。

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

-InputObject

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

類型:	IResultObject
別名:	ApplicationGroup
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	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

-ModelName

指定要設定之應用程式群組的應用程式模型標識碼。 此值也稱為 CI 唯一識別碼。 例如，ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed。

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

-Name

指定要設定的應用程式群組名稱。

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

-NewName

使用此參數來重新命名應用程式群組。 最大長度為 256 個字元。

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

-OptionalReference

指定選擇性字串，以協助您在控制台中尋找應用程式群組。 最大長度為 256 個字元。

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

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

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

-RemoveAppCatalog

指定語言識別碼的陣列，以移除相關聯的軟體中心專案。 若要移除所有專案，請使用 ClearAppCatalog 參數。

此標識子是 Windows 語言識別子的小數對等專案。 例如， 10330x0409 適用於 英文 (美國) ，而 21080x083C 適用於 愛爾蘭 () 。 如需詳細資訊，請參閱 [MS-LCID]： Windows 語言代碼識別碼 (LCID) 參考。

例如，若要移除 愛爾蘭 (愛爾蘭的 當地語系化軟體中心專案) ：

-RemoveAppCatalog 2108

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

-RemoveAppCategoryName

指定要移除的系統管理類別目錄名稱陣列。 若要移除所有系統管理類別，請使用 CleanAppCategory 參數。

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

-RemoveApplication

指定要從這個群組中移除的應用程式名稱數位。

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

-RemoveOwner

指定要移除的擁有者陣列。 若要移除所有擁有者，請使用 ClearOwner 參數。

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

-RemoveSupportContact

指定要移除的支持聯繫人數組。 若要移除所有支持聯繫人，請使用 ClearSupportContact 參數。

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

-RemoveUserCategoryName

指定要移除的使用者類別目錄名稱陣列。 若要移除所有用戶類別，請使用 CleanUserCategory 參數。

類型:	String[]
別名:	RemoveUserCategoryNames
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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject

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

相關連結

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