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英语 (美国) ,而 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 类对象。