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>]
Описание
Используйте этот комдлет для создания группы приложений. Используйте группу приложений для развертывания нескольких приложений в коллекции в качестве одного развертывания. Метаданные, которые указаны в группе приложений, в Центре программного обеспечения рассматривается как единое целое. Вы можете заказать приложения в группе, чтобы клиент устанавливал их в определенном порядке. Дополнительные сведения см. в приложении Create groups.
Существует несколько параметров группы приложений, которые нельзя настроить при ее создании. Чтобы настроить другие параметры, используйте группу Set-CMApplicationGroup.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Создание группы с двумя приложениями
В этом примере создается новая группа приложений с именем Центральное приложение, которое включает два приложения.
$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)
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 |
-AppGroupCatalog
Этот параметр используется для указания записи Центра программного обеспечения для определенного языка. Эта запись может включать всю локализованную информацию о группе приложений:
- Описание
- IconLocationFile
- Ключевое слово
- LinkText
- PrivacyUrl
- Title
- UserDocumentation
Чтобы получить этот объект, используйте кодлет New-CMApplicationDisplayInfo.
Type: | AppDisplayInfo[] |
Aliases: | AppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultLanguageId
Укажите языковой ID для языка Центра программного обеспечения по умолчанию.
Этот ID является десятичной эквивалентом Windows языка. Например, 1033
для 0x0409
английского языка (США) и 2108
для 0x083C
ирландского (Ирландия). Дополнительные сведения см. в справке [MS-LCID]Windows.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Укажите необязательный комментарий администратора для группы приложений. Максимальная длина— 2048 символов.
Type: | String |
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 |
-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 |
-Name
Укажите имя группы приложений. Максимальная длина имени составляет 256 символов.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
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 |
-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.
Type: | DateTime |
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
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Этот комлет возвращает объект SMS_ApplicationGroup класса WMI.