Set-CMApplicationGroup
Configure um grupo de aplicativos existente.
Syntax
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>]
Description
Use este cmdlet para definir as configurações de um grupo de aplicativos existente. Use um grupo de aplicativos para implantar vários aplicativos em uma coleção como uma única implantação. Os metadados especificados sobre o grupo de aplicativos são vistos no Centro de Software como uma única entidade. Você pode solicitar os aplicativos no grupo para que o cliente os instale em uma ordem específica. Para obter mais informações, consulte Criar grupos de aplicativos.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Renomear um grupo de aplicativos
Este exemplo obtém um objeto para o grupo de aplicativos e o passa para este cmdlet para renomeá-lo.
$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"
Exemplo 2: Adicionar um nome localizado
Este exemplo configura o grupo de aplicativos com um nome de aplicativo localizado para o idioma irlandês.
Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"
Parâmetros
-AddAppCatalog
Use este parâmetro para especificar uma entrada do Centro de Software para um idioma específico. Essa entrada pode incluir todas as informações localizadas sobre o grupo de aplicativos:
- Descrição
- IconLocationFile
- Palavra-chave
- LinkText
- PrivacyUrl
- Título
- UserDocumentation
Para obter esse objeto, use o cmdlet New-CMApplicationDisplayInfo.
Type: | AppDisplayInfo[] |
Aliases: | AppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddAppCategory
Especifique um ou mais objetos de categoria administrativa para ajudá-lo a filtrar e encontrar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory. Essas categorias são do tipo AppCategories.
Para adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddUserCategory.
Type: | IResultObject[] |
Aliases: | AddAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddApplication
Especifique uma matriz de cadeia de caracteres de nomes de aplicativos para adicionar ao grupo. Se você já tiver um objeto de aplicativo de outro cmdlet como Get-CMApplication,esse valor será a propriedade LocalizedDisplayName. Por exemplo: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
Type: | String[] |
Aliases: | AddApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOwner
Especifique um ou mais usuários administrativos responsáveis por esse grupo de aplicativos.
Type: | String[] |
Aliases: | AddOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSupportContact
Especifique um ou mais usuários administrativos que os usuários finais possam contatar para obter ajuda com esse aplicativo.
Type: | String[] |
Aliases: | AddSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddUserCategory
Especifique um ou mais objetos de categoria de usuário para ajudá-lo a filtrar e encontrar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory. Essas categorias são do tipo CatalogCategories.
Para adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddAppCategory.
Type: | IResultObject[] |
Aliases: | AddUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToLanguageById
Para configurações exibidas no Centro de Software, use este parâmetro para especificar a ID do idioma para as configurações.
Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033
é 0x0409
para inglês (Estados Unidos) e 2108
é para irlandês 0x083C
(Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).
Por exemplo, para adicionar um nome de aplicativo localizado para o irlandês (Irlanda):
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Type: | Int32 |
Aliases: | ApplySettingToSpecificLanguage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanAppCategory
Adicione esse parâmetro para remover todas as categorias administrativas. Para remover uma única categoria, use o parâmetro RemoveAppCategory.
Type: | SwitchParameter |
Aliases: | CleanAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanUserCategory
Adicione esse parâmetro para remover todas as categorias de usuário. Para remover uma única categoria, use o parâmetro RemoveUserCategory.
Type: | SwitchParameter |
Aliases: | CleanUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearAppCatalog
Adicione esse parâmetro para remover todas as entradas do Centro de Software localizado. Para remover uma única entrada, use o parâmetro RemoveAppCatalog.
Type: | SwitchParameter |
Aliases: | ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearOwner
Adicione esse parâmetro para remover todos os proprietários. Para remover um único proprietário, use o parâmetro RemoveOwner.
Type: | SwitchParameter |
Aliases: | CleanOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSupportContact
Adicione esse parâmetro para remover todos os contatos de suporte. Para remover um único contato, use o parâmetro RemoveSupportContact.
Type: | SwitchParameter |
Aliases: | CleanSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultLanguageId
Especifique a ID do idioma para o idioma padrão do Centro de Software.
Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033
é 0x0409
para inglês (Estados Unidos) e 2108
é para irlandês 0x083C
(Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique um comentário de administrador opcional para o grupo de aplicativos. O comprimento máximo é de 2048 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconLocationFile
Especifique o caminho para o arquivo que contém o ícone deste grupo de aplicativos. Os ícones podem ter dimensões de pixel de até 512x512. O arquivo pode ser dos seguintes tipos de arquivo de imagem e ícone:
- DLL
- EXE
- JPG
- ICO
- PNG
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique a ID do grupo de aplicativos a ser configurada. Esse valor é o mesmo que o CI_ID, por 1025866
exemplo.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto de grupo de aplicativos a ser configurada. Para obter esse objeto, use o cmdlet Get-CMApplicationGroup.
Type: | IResultObject |
Aliases: | ApplicationGroup |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Keyword
Especifique uma lista de palavras-chave no idioma selecionado. Essas palavras-chave ajudam os usuários do Centro de Software a pesquisar o grupo de aplicativos.
Dica
Para adicionar várias palavras-chave, use CultureInfo.CurrentCulture.TextInfo.ListSeparator como o delimiter.
Type: | String[] |
Aliases: | Keywords |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinkText
Ao usar o parâmetro UserDocumentation, use esse parâmetro para mostrar uma cadeia de caracteres no lugar de "Informações adicionais" no Centro de Software. O comprimento máximo é de 128 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedDescription
Especifique uma descrição para este grupo de aplicativos no idioma selecionado. O comprimento máximo é de 2048 caracteres.
Type: | String |
Aliases: | LocalizedAppGroupDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedName
Especifique o nome do grupo de aplicativos no idioma selecionado. Esse nome aparece no Centro de Software.
Um nome é necessário para cada idioma que você adicionar.
O comprimento máximo é de 256 caracteres.
Type: | String |
Aliases: | LocalizedAppGroupName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModelName
Especifique o identificador do modelo de aplicativo do grupo de aplicativos a ser configurada. Esse valor também é conhecido como a ID exclusiva da CI. Por exemplo, 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
Especifique o nome do grupo de aplicativos a ser configurada.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Use esse parâmetro para renomear o grupo de aplicativos. O comprimento máximo é de 256 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionalReference
Especifique uma cadeia de caracteres opcional para ajudá-lo a encontrar o grupo de aplicativos no console. O comprimento máximo é de 256 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivacyUrl
Especifique um endereço de site para a declaração de privacidade do grupo de aplicativos. O formato precisa ser uma URL válida, por exemplo https://contoso.com/privacy
. O comprimento máximo da cadeia de caracteres inteira é de 128 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Publisher
Especifique informações de fornecedor opcionais para este grupo de aplicativos. O comprimento máximo é de 256 caracteres.
Type: | String |
Aliases: | Manufacturer |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseDate
Especifique um objeto date para quando esse grupo de aplicativos foi lançado. Para obter esse objeto, use o cmdlet get-Date integrado.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCatalog
Especifique uma matriz de IDs de idioma para remover as entradas do Centro de Software associado. Para remover todas as entradas, use o parâmetro ClearAppCatalog.
Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033
é 0x0409
para inglês (Estados Unidos) e 2108
é para irlandês 0x083C
(Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).
Por exemplo, para remover a entrada do Centro de Software localizado para a Irlanda (Irlanda):
-RemoveAppCatalog 2108
Type: | Int32[] |
Aliases: | RemoveAppCatalogsByLanguageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCategoryName
Especifique uma matriz de nomes de categoria administrativa a ser removido. Para remover todas as categorias administrativas, use o parâmetro CleanAppCategory.
Type: | String[] |
Aliases: | RemoveAppCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveApplication
Especifique uma matriz de nomes de aplicativos a ser removido desse grupo.
Type: | String[] |
Aliases: | RemoveApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveOwner
Especifique uma matriz de proprietários a ser removido. Para remover todos os proprietários, use o parâmetro ClearOwner.
Type: | String[] |
Aliases: | RemoveOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSupportContact
Especifique uma matriz de contatos de suporte a ser removido. Para remover todos os contatos de suporte, use o parâmetro ClearSupportContact.
Type: | String[] |
Aliases: | RemoveSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveUserCategoryName
Especifique uma matriz de nomes de categoria de usuário a ser removido. Para remover todas as categorias de usuário, use o parâmetro CleanUserCategory.
Type: | String[] |
Aliases: | RemoveUserCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareVersion
Especifique uma cadeia de caracteres de versão opcional para o grupo de aplicativos. O tamanho máximo é de 64caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserDocumentation
Especifique o local de um arquivo do qual os usuários do Centro de Software podem obter mais informações sobre esse grupo de aplicativos. Esse local é um endereço de site ou um caminho de rede e nome de arquivo. Certifique-se de que os usuários tenham acesso a esse local.
O comprimento máximo da cadeia de caracteres inteira é de 256 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject
Este cmdlet retorna o objeto SMS_ApplicationGroup classe WMI.