New-CMApplicationGroup

  • Ссылка
Модуль:
ConfigurationManager

Создайте новую группу приложений.

Синтаксис

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

Описание

Используйте этот командлет для создания группы приложений. Используйте группу приложений для развертывания нескольких приложений в коллекции в виде одного развертывания. Метаданные, указанные для группы приложений, рассматриваются в Центре программного обеспечения как единая сущность. Вы можете упорядочить приложения в группе, чтобы клиент устанавливал их в определенном порядке. Дополнительные сведения см. в разделе Создание групп приложений.

Существуют некоторые параметры группы приложений, которые невозможно настроить при ее создании. Чтобы настроить другие параметры, используйте командлет Set-CMApplicationGroup .

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например 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

Укажите массив строк имен приложений для добавления в группу. Если у вас уже есть объект приложения из другого командлета , например Get-CMApplication, это значение — свойство LocalizedDisplayName . Пример: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Тип:String[]
Aliases:AddApplications
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddOwner

Укажите одного или нескольких пользователей с правами администратора, которые отвечают за эту группу приложений.

Тип:String[]
Aliases:AddOwners
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddSupportContact

Укажите одного или нескольких пользователей с правами администратора, к которым конечные пользователи могут обратиться за помощью по этому приложению.

Тип:String[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AppGroupCatalog

Используйте этот параметр, чтобы указать запись Центра программного обеспечения для определенного языка. Эта запись может содержать все локализованные сведения о группе приложений:

  • Описание
  • IconLocationFile
  • Ключевое слово
  • LinkText
  • PrivacyUrl
  • Название
  • UserDocumentation

Чтобы получить этот объект, используйте командлет New-CMApplicationDisplayInfo .

Тип:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultLanguageId

Укажите идентификатор языка для языка центра программного обеспечения по умолчанию.

Этот идентификатор является десятичным эквивалентом идентификатора языка Windows. Например, 1033 — 0x0409 для английского (США) и 2108 для 0x083Cирландского (Ирландия). Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательный комментарий администратора для группы приложений. Максимальная длина — 2048 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IconLocationFile

Укажите путь к файлу, который содержит значок для этой группы приложений. Значки могут иметь размеры в пикселях до 512 x 512. Файл может иметь следующие типы файлов изображений и значков:

  • Библиотека dll
  • EXE
  • JPG
  • ICO
  • PNG
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Keyword

Укажите список ключевых слов на выбранном языке. Эти ключевые слова помогают пользователям Центра программного обеспечения искать группу приложений.

Совет

Чтобы добавить несколько ключевых слов, используйте CultureInfo.CurrentCulture.TextInfo.ListSeparator в качестве разделителя.

Тип:String[]
Aliases:Keywords
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LinkText

При использовании параметра UserDocumentation используйте этот параметр для отображения строки вместо "Дополнительные сведения" в Центре программного обеспечения. Максимальная длина — 128 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocalizedDescription

Укажите описание для этой группы приложений на выбранном языке. Максимальная длина — 2048 символов.

Тип:String
Aliases:LocalizedAppGroupDescription
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocalizedName

Укажите имя группы приложений на выбранном языке. Это имя отображается в Центре программного обеспечения.

Имя требуется для каждого добавляемого языка.

Максимальная длина составляет 256 символов.

Тип:String
Aliases:LocalizedAppGroupName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя группы приложений. Максимальная длина составляет 256 символов.

Тип:String
Aliases:LocalizedDisplayName, ApplicationGroupName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OptionalReference

Укажите необязательную строку для поиска группы приложений в консоли. Максимальная длина составляет 256 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PrivacyUrl

Укажите адрес веб-сайта в заявлении о конфиденциальности для группы приложений. Формат должен быть допустимым URL-адресом, например https://contoso.com/privacy. Максимальная длина всей строки составляет 128 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Publisher

Укажите необязательные сведения о поставщике для этой группы приложений. Максимальная длина составляет 256 символов.

Тип:String
Aliases:Manufacturer
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReleaseDate

Укажите объект даты для момента выпуска этой группы приложений. Чтобы получить этот объект, используйте встроенный командлет Get-Date .

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SoftwareVersion

Укажите необязательную строку версии для группы приложений. Максимальная длина: 64 символа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserDocumentation

Укажите расположение файла, из которого пользователи Центра программного обеспечения могут получить дополнительные сведения об этой группе приложений. Это расположение является адресом веб-сайта или сетевым путем и именем файла. Убедитесь, что у пользователей есть доступ к этому расположению.

Максимальная длина всей строки составляет 256 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Этот командлет возвращает объект класса WMI SMS_ApplicationGroup .