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