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>]
说明
使用此 cmdlet 创建应用程序组。 使用应用程序组将多个应用程序作为单个部署部署到集合。 指定的有关应用组的元数据在软件中心中显示为单个实体。 你可以对组中的应用进行排序,以便客户端按特定顺序安装它们。 有关详细信息,请参阅 创建应用程序组。
创建应用组时无法配置应用组的某些设置。 若要配置其他设置,请使用 Set-CMApplicationGroup cmdlet。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:创建包含两个应用的组
此示例创建一个名为 Central app 的新应用 组,其中包含两个应用。
$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
指定默认软件中心语言的语言 ID。
此 ID 是 Windows 语言 ID 的等效小数。 例如, 1033
表示0x0409
英语 (美国) ,而 2108
0x083C
对于爱尔兰 (爱尔兰) 。 有关详细信息,请参阅 [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 类对象。