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>]

说明

使用此 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
• Title
• UserDocumentation

若要获取此对象，请使用 New-CMApplicationDisplayInfo cmdlet。

Type:	AppDisplayInfo[]
Aliases:	AppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddAppCategory

指定一个或多个管理类别对象以帮助你在控制台中筛选和查找应用组。 若要获取这些对象，请使用 Get-CMCategory cmdlet。 这些类别的类型为 AppCategories。

若要添加类别以帮助用户在软件中心中筛选和查找应用程序，请使用 AddUserCategory 参数。

Type:	IResultObject[]
Aliases:	AddAppCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddApplication

指定要添加到组的应用名称的字符串数组。 如果你已有来自另一个 cmdlet（如 Get-CMApplication）的应用对象，则此值为 LocalizedDisplayName 属性。 例如：$appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Type:	String[]
Aliases:	AddApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOwner

指定一个或多个负责此应用程序组的管理用户。

Type:	String[]
Aliases:	AddOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddSupportContact

指定最终用户可以联系的一个或多个管理用户，以请求此应用程序的帮助。

Type:	String[]
Aliases:	AddSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddUserCategory

指定一个或多个用户类别对象以帮助你在控制台中筛选和查找应用组。 若要获取这些对象，请使用 Get-CMCategory cmdlet。 这些类别的类型为 CatalogCategories。

若要添加类别以帮助用户在软件中心中筛选和查找应用程序，请使用 AddAppCategory 参数。

Type:	IResultObject[]
Aliases:	AddUserCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplyToLanguageById

对于在软件中心显示的设置，使用此参数指定设置的语言 ID。

此 ID 是语言 ID Windows等效项。 例如， 1033 适用于 0x0409 **英语 (美国) ， **适用于爱尔兰 (2108 0x083C **爱尔兰) **。 有关详细信息，请参阅[MS-LCID]： Windows Language Code Identifier (LCID) Reference。

例如，为爱尔兰语和爱尔兰语添加本地化 (**名称) ： **

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

添加此参数可删除所有管理类别。 若要删除单个类别，请使用 RemoveAppCategory 参数。

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

-CleanUserCategory

添加此参数可删除所有用户类别。 若要删除单个类别，请使用 RemoveUserCategory 参数。

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

-ClearAppCatalog

添加此参数可删除所有本地化的软件中心条目。 若要删除单个条目，请使用 RemoveAppCatalog 参数。

Type:	SwitchParameter
Aliases:	ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOwner

添加此参数可删除所有所有者。 若要删除单个所有者，请使用 RemoveOwner 参数。

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

-ClearSupportContact

添加此参数可删除所有支持联系人。 若要删除单个联系人，请使用 RemoveSupportContact 参数。

Type:	SwitchParameter
Aliases:	CleanSupportContacts
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

-DefaultLanguageId

指定默认软件中心语言的语言 ID。

此 ID 是语言 ID Windows等效项。 例如， 1033 适用于 0x0409 **英语 (美国) ， **适用于爱尔兰 (2108 0x083C **爱尔兰) **。 有关详细信息，请参阅[MS-LCID]： Windows Language Code Identifier (LCID) Reference。

Type:	Int32
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

-ForceWildcardHandling

此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

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

-IconLocationFile

指定包含此应用程序组的图标的文件的路径。 图标的像素尺寸最高为 512x512。 该文件可以是以下图像和图标文件类型：

• DLL
• EXE
• JPG
• ICO
• PNG

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

-Id

指定要配置的应用组的 ID。 此值与值值 CI_ID相同， 例如 1025866 。

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

-InputObject

指定要配置的应用组对象。 若要获取此对象，请使用 Get-CMApplicationGroup cmdlet。

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

-Keyword

指定选定语言的关键字列表。 这些关键字可帮助软件中心用户搜索应用组。

提示

若要添加多个关键字，请使用 CultureInfo.CurrentCulture.TextInfo.ListSeparator 作为分隔符。

Type:	String[]
Aliases:	Keywords
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LinkText

使用 UserDocumentation 参数时，使用此参数在软件中心中显示一个字符串，以表示"其他信息"。 最大长度为 128 个字符。

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

-LocalizedDescription

以选定语言为此应用组指定说明。 最大长度为 2048 个字符。

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

-LocalizedName

以选定语言指定应用组名称。 此名称将显示在软件中心中。

您添加的每种语言都需要一个名称。

长度不得超过 256 个字符。

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

-ModelName

指定要配置的应用程序组的应用程序模型标识符。 此值也称为 CI 唯 一 ID。 例如，ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed。

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

-NewName

使用此参数可重命名应用程序组。 长度不得超过 256 个字符。

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

-OptionalReference

指定可选字符串以帮助你在控制台中查找应用组。 长度不得超过 256 个字符。

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

-PassThru

添加此参数可返回一个对象，该对象表示要处理的项目。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-PrivacyUrl

为应用程序组隐私声明指定网站地址。 格式需要是有效的 URL，例如 https://contoso.com/privacy 。 整个字符串的最大长度为 128 个字符。

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

-Publisher

为此应用组指定可选供应商信息。 长度不得超过 256 个字符。

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

-ReleaseDate

指定此应用组的发布日期对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

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

-RemoveAppCatalog

指定语言 ID 的数组，以删除关联的软件中心条目。 若要删除所有条目，请使用 ClearAppCatalog 参数。

此 ID 是语言 ID Windows等效项。 例如， 1033 适用于英语 0x0409 ** (美国) ，** 适用于爱尔兰 (2108 0x083C **爱尔兰) 。 ** 有关详细信息，请参阅[MS-LCID]：Windows语言代码标识符 (LCID) 参考。

例如，若要删除爱尔兰语和爱尔兰语的本地化软件 (**项) ： **

-RemoveAppCatalog 2108

Type:	Int32[]
Aliases:	RemoveAppCatalogsByLanguageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveAppCategoryName

指定要删除的管理类别名称数组。 若要删除所有管理类别，请使用 CleanAppCategory 参数。

Type:	String[]
Aliases:	RemoveAppCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveApplication

指定要从该组中删除的应用程序名称数组。

Type:	String[]
Aliases:	RemoveApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOwner

指定要删除的所有者数组。 若要删除所有所有者，请使用 ClearOwner 参数。

Type:	String[]
Aliases:	RemoveOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSupportContact

指定要删除的支持联系人数组。 若要删除所有支持联系人，请使用 ClearSupportContact 参数。

Type:	String[]
Aliases:	RemoveSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUserCategoryName

指定要删除的用户类别名称数组。 若要删除所有用户类别，请使用 CleanUserCategory 参数。

Type:	String[]
Aliases:	RemoveUserCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareVersion

为应用组指定可选版本字符串。 最大长度为 64 个字符。

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

-UserDocumentation

指定软件中心用户可以从其中获取有关此应用程序组详细信息的文件的位置。 此位置是网站地址或网络路径和文件名。 确保用户有权访问此位置。

整个字符串的最大长度为 256 个字符。

Type:	String
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

-描述

为应用组指定可选的管理员注释。 最大长度为 2048 个字符。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
• 创建应用程序组