Set-CMApplicationGroup
Настройте существующую группу приложений.
Синтаксис
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>] Описание
Используйте этот командлет для настройки параметров существующей группы приложений. Используйте группу приложений для развертывания нескольких приложений в коллекции в виде одного развертывания. Метаданные, указанные для группы приложений, рассматриваются в Центре программного обеспечения как единая сущность. Вы можете упорядочить приложения в группе, чтобы клиент устанавливал их в определенном порядке. Дополнительные сведения см. в разделе Создание групп приложений.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Переименование группы приложений
В этом примере возвращается объект для группы приложений и передается в этот командлет для переименования.
$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
- Название
- UserDocumentation
Чтобы получить этот объект, используйте командлет New-CMApplicationDisplayInfo .
| Тип: | AppDisplayInfo[] |
| Aliases: | AppCatalogs |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AddAppCategory
Укажите один или несколько объектов административной категории, чтобы отфильтровать и найти группу приложений в консоли. Чтобы получить эти объекты, используйте командлет Get-CMCategory . Эти категории относятся к типу Категории приложений.
Чтобы добавить категории, помогающие пользователям фильтровать и находить приложения в Центре программного обеспечения, используйте параметр AddUserCategory .
| Тип: | IResultObject[] |
| Aliases: | AddAppCategories |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AddApplication
Укажите массив строк имен приложений для добавления в группу. Если у вас уже есть объект приложения из другого командлета , например Get-CMApplication, это значение — свойство LocalizedDisplayName . Пример: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
| Тип: | String[] |
| Aliases: | AddApplications |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | 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 |
-AddUserCategory
Укажите один или несколько объектов категории пользователей, чтобы отфильтровать и найти группу приложений в консоли. Чтобы получить эти объекты, используйте командлет Get-CMCategory . Эти категории относятся к типу CatalogCategories.
Чтобы добавить категории, помогающие пользователям фильтровать и находить приложения в Центре программного обеспечения, используйте параметр AddAppCategory .
| Тип: | IResultObject[] |
| Aliases: | AddUserCategories |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ApplyToLanguageById
Для параметров, отображаемых в Центре программного обеспечения, используйте этот параметр, чтобы указать идентификатор языка для параметров.
Этот идентификатор является десятичным эквивалентом идентификатора языка Windows. Например, 1033 — 0x0409 для английского (США) и 2108 для 0x083Cирландского (Ирландия). Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).
Например, чтобы добавить локализованное имя приложения для ирландского (Ирландия), выполните приведенные ниже действия.
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
| Тип: | Int32 |
| Aliases: | ApplySettingToSpecificLanguage |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CleanAppCategory
Добавьте этот параметр, чтобы удалить все административные категории. Чтобы удалить одну категорию, используйте параметр RemoveAppCategory .
| Тип: | SwitchParameter |
| Aliases: | CleanAppCategories |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CleanUserCategory
Добавьте этот параметр, чтобы удалить все категории пользователей. Чтобы удалить одну категорию, используйте параметр RemoveUserCategory .
| Тип: | SwitchParameter |
| Aliases: | CleanUserCategories |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ClearAppCatalog
Добавьте этот параметр, чтобы удалить все локализованные записи центра программного обеспечения. Чтобы удалить одну запись, используйте параметр RemoveAppCatalog .
| Тип: | SwitchParameter |
| Aliases: | ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ClearOwner
Добавьте этот параметр, чтобы удалить всех владельцев. Чтобы удалить одного владельца, используйте параметр RemoveOwner .
| Тип: | SwitchParameter |
| Aliases: | CleanOwners |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ClearSupportContact
Добавьте этот параметр, чтобы удалить все контакты поддержки. Чтобы удалить один контакт, используйте параметр RemoveSupportContact .
| Тип: | SwitchParameter |
| Aliases: | CleanSupportContacts |
| 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 |
-Id
Укажите идентификатор настраиваемой группы приложений. Это значение совпадает с CI_ID, например 1025866.
| Тип: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект группы приложений для настройки. Чтобы получить этот объект, используйте командлет Get-CMApplicationGroup .
| Тип: | IResultObject |
| Aliases: | ApplicationGroup |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | 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 |
-ModelName
Укажите идентификатор модели приложения для настраиваемой группы приложений. Это значение также называется уникальным идентификатором CI. Например, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Укажите имя настраиваемой группы приложений.
| Тип: | String |
| Aliases: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewName
Используйте этот параметр для переименования группы приложений. Максимальная длина составляет 256 символов.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-OptionalReference
Укажите необязательную строку для поиска группы приложений в консоли. Максимальная длина составляет 256 символов.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| 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 |
-RemoveAppCatalog
Укажите массив идентификаторов языков, чтобы удалить связанные записи Центра программного обеспечения. Чтобы удалить все записи, используйте параметр ClearAppCatalog .
Этот идентификатор является десятичным эквивалентом идентификатора языка Windows. Например, 1033 — 0x0409 для английского (США) и 2108 для 0x083Cирландского (Ирландия). Дополнительные сведения см. в разделе [MS-LCID]: Справочник по идентификатору кода языка Windows (LCID).
Например, чтобы удалить локализованную запись центра программного обеспечения для ирландского (Ирландия), выполните следующие действия:
-RemoveAppCatalog 2108
| Тип: | Int32[] |
| Aliases: | RemoveAppCatalogsByLanguageId |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveAppCategoryName
Укажите массив имен административных категорий для удаления. Чтобы удалить все административные категории, используйте параметр CleanAppCategory .
| Тип: | String[] |
| Aliases: | RemoveAppCategoryNames |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveApplication
Укажите массив имен приложений для удаления из этой группы.
| Тип: | String[] |
| Aliases: | RemoveApplications |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveOwner
Укажите массив владельцев для удаления. Чтобы удалить всех владельцев, используйте параметр ClearOwner .
| Тип: | String[] |
| Aliases: | RemoveOwners |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveSupportContact
Укажите массив контактов поддержки для удаления. Чтобы удалить все контакты поддержки, используйте параметр ClearSupportContact .
| Тип: | String[] |
| Aliases: | RemoveSupportContacts |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveUserCategoryName
Укажите массив имен категорий пользователей для удаления. Чтобы удалить все категории пользователей, используйте параметр CleanUserCategory .
| Тип: | String[] |
| Aliases: | RemoveUserCategoryNames |
| 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 |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Этот командлет возвращает объект класса WMI SMS_ApplicationGroup.