Configure um grupo de aplicativos existente.
\n","uid":"ConfigurationManager.Set-CMApplicationGroup"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMApplicationGroup":{"href":"set-cmapplicationgroup","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMApplicationGroup","schemaType":"PowershellCmdlet","summary":"Configure um grupo de aplicativos existente.
\n","uid":"ConfigurationManager.Set-CMApplicationGroup"}},"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 ordenar 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.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Este exemplo obtém um objeto para o grupo de aplicativos e o passa para este cmdlet para renomeá-lo.
\n","title":"Exemplo 1: Renomear um grupo de aplicativos"},{"code":"Set-CMApplicationGroup -Name \"Contoso Welcome app\" -ApplyToLanguageById 60 -LocalizedName \"Fáilte romhat\"","description":"","summary":"Este exemplo configura o grupo de aplicativos com um nome de aplicativo localizado para o idioma irlandês .
\n","title":"Exemplo 2: adicionar um nome localizado"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmapplicationgroup","text":"Get-CMApplicationGroup"},{"href":"new-cmapplicationgroup","text":"New-CMApplicationGroup"},{"href":"remove-cmapplicationgroup","text":"Remove-CMApplicationGroup"},{"href":"new-cmapplicationdisplayinfo","text":"New-CMApplicationDisplayInfo"},{"href":"get-cmapplicationgroupdeployment","text":"Get-CMApplicationGroupDeployment"},{"href":"new-cmapplicationgroupdeployment","text":"New-CMApplicationGroupDeployment"},{"href":"remove-cmapplicationgroupdeployment","text":"Remove-CMApplicationGroupDeployment"},{"href":"set-cmapplicationgroupdeployment","text":"Set-CMApplicationGroupDeployment"},{"href":"/mem/configmgr/apps/deploy-use/create-app-groups","text":"Criar grupos de aplicativos"}],"module":"ConfigurationManager","name":"Set-CMApplicationGroup","notes":"","outputs":[{"description":"Esse cmdlet retorna o objeto de classe WMI SMS_ApplicationGroup.
\n","name":"IResultObject\n"}],"parameters":[{"aliases":"AppCatalogs","defaultValue":"None","description":"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:
\nPara obter esse objeto, use o cmdlet New-CMApplicationDisplayInfo .
\n","name":"AddAppCatalog","parameterValueGroup":"","position":"Named","type":"AppDisplayInfo[]
\n"},{"aliases":"AddAppCategories","defaultValue":"None","description":"Especifique um ou mais objetos de categoria administrativa para ajudá-lo a filtrar e localizar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory . Essas categorias são do tipo AppCategories.
\nPara adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddUserCategory .
\n","name":"AddAppCategory","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"AddApplications","defaultValue":"None","description":"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)
String[]
\n"},{"aliases":"AddOwners","defaultValue":"None","description":"Especifique um ou mais usuários administrativos responsáveis por esse grupo de aplicativos.
\n","name":"AddOwner","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"AddSupportContacts","defaultValue":"None","description":"Especifique um ou mais usuários administrativos que os usuários finais podem contatar para obter ajuda com esse aplicativo.
\n","name":"AddSupportContact","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"AddUserCategories","defaultValue":"None","description":"Especifique um ou mais objetos de categoria de usuário para ajudá-lo a filtrar e localizar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory . Essas categorias são do tipo CatalogCategories.
\nPara adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddAppCategory .
\n","name":"AddUserCategory","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"ApplySettingToSpecificLanguage","defaultValue":"None","description":"Para configurações exibidas no Centro de Software, use esse parâmetro para especificar a ID de idioma para as configurações.
\nEssa ID é o equivalente decimal da ID de idioma do Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é 0x083C para irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Referência do LCID (Identificador de Código de Idioma) do Windows.
Por exemplo, para adicionar um nome de aplicativo localizado para irlandês (Irlanda):
\n-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Adicione este parâmetro para remover todas as categorias administrativas. Para remover uma única categoria, use o parâmetro RemoveAppCategory .
\n","name":"CleanAppCategory","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"CleanUserCategories","defaultValue":"None","description":"Adicione este parâmetro para remover todas as categorias de usuário. Para remover uma única categoria, use o parâmetro RemoveUserCategory .
\n","name":"CleanUserCategory","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs","defaultValue":"None","description":"Adicione esse parâmetro para remover todas as entradas localizadas do Centro de Software. Para remover uma única entrada, use o parâmetro RemoveAppCatalog .
\n","name":"ClearAppCatalog","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"CleanOwners","defaultValue":"None","description":"Adicione este parâmetro para remover todos os proprietários. Para remover um único proprietário, use o parâmetro RemoveOwner .
\n","name":"ClearOwner","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"CleanSupportContacts","defaultValue":"None","description":"Adicione este parâmetro para remover todos os contatos de suporte. Para remover um único contato, use o parâmetro RemoveSupportContact .
\n","name":"ClearSupportContact","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique a ID de idioma para o idioma padrão do Centro de Software.
\nEssa ID é o equivalente decimal da ID de idioma do Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é 0x083C para irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Referência do LCID (Identificador de Código de Idioma) do Windows.
Especifique um comentário opcional do administrador para o grupo de aplicativos. O comprimento máximo é de 2048 caracteres.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique o caminho para o arquivo que contém o ícone desse grupo de aplicativos. Os ícones podem ter dimensões de pixel de até 512x512. O arquivo pode ser dos seguintes tipos de imagem e ícone:
\nEspecifique a ID do grupo de aplicativos a ser configurado. Esse valor é igual ao CI_ID, por exemplo 1025866.
Especifique um objeto de grupo de aplicativos a ser configurado. Para obter esse objeto, use o cmdlet Get-CMApplicationGroup .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"Keywords","defaultValue":"None","description":"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.
\nDica
\nPara adicionar várias palavras-chave, use CultureInfo.CurrentCulture.TextInfo.ListSeparator como delimitador.
\nString[]
\n"},{"aliases":"","defaultValue":"None","description":"Ao usar o parâmetro UserDocument , 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.
\n","name":"LinkText","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"LocalizedAppGroupDescription","defaultValue":"None","description":"Especifique uma descrição para este grupo de aplicativos no idioma selecionado. O comprimento máximo é de 2048 caracteres.
\n","name":"LocalizedDescription","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"LocalizedAppGroupName","defaultValue":"None","description":"Especifique o nome do grupo de aplicativos no idioma selecionado. Esse nome aparece no Centro de Software.
\nUm nome é necessário para cada idioma que você adicionar.
\nO comprimento máximo é de 256 caracteres.
\n","name":"LocalizedName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o identificador de modelo de aplicativo do grupo de aplicativos a ser configurado. Esse valor também é conhecido como ID exclusiva de CI. Por exemplo, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.
Especifique o nome do grupo de aplicativos a ser configurado.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Use esse parâmetro para renomear o grupo de aplicativos. O comprimento máximo é de 256 caracteres.
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma cadeia de caracteres opcional para ajudar você a localizar o grupo de aplicativos no console. O comprimento máximo é de 256 caracteres.
\n","name":"OptionalReference","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique um endereço de site para a política 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.
Especifique informações opcionais do fornecedor para este grupo de aplicativos. O comprimento máximo é de 256 caracteres.
\n","name":"Publisher","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique um objeto de data para quando esse grupo de aplicativos foi lançado. Para obter esse objeto, use o cmdlet interno Get-Date .
\n","name":"ReleaseDate","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"RemoveAppCatalogsByLanguageId","defaultValue":"None","description":"Especifique uma matriz de IDs de idioma para remover as entradas associadas do Centro de Software. Para remover todas as entradas, use o parâmetro ClearAppCatalog .
\nEssa ID é o equivalente decimal da ID de idioma do Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é 0x083C para irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Referência do LCID (Identificador de Código de Idioma) do Windows.
Por exemplo, para remover a entrada localizada do Centro de Software para irlandês (Irlanda):
\n-RemoveAppCatalog 2108
Int32[]
\n"},{"aliases":"RemoveAppCategoryNames","defaultValue":"None","description":"Especifique uma matriz de nomes de categorias administrativas a ser removida. Para remover todas as categorias administrativas, use o parâmetro CleanAppCategory .
\n","name":"RemoveAppCategoryName","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"RemoveApplications","defaultValue":"None","description":"Especifique uma matriz de nomes de aplicativos a serem removidos deste grupo.
\n","name":"RemoveApplication","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"RemoveOwners","defaultValue":"None","description":"Especifique uma matriz de proprietários a ser removida. Para remover todos os proprietários, use o parâmetro ClearOwner .
\n","name":"RemoveOwner","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"RemoveSupportContacts","defaultValue":"None","description":"Especifique uma matriz de contatos de suporte a ser removida. Para remover todos os contatos de suporte, use o parâmetro ClearSupportContact .
\n","name":"RemoveSupportContact","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"RemoveUserCategoryNames","defaultValue":"None","description":"Especifique uma matriz de nomes de categorias de usuário a ser removida. Para remover todas as categorias de usuário, use o parâmetro CleanUserCategory .
\n","name":"RemoveUserCategoryName","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma cadeia de caracteres de versão opcional para o grupo de aplicativos. O tamanho máximo é de 64 caracteres.
\n","name":"SoftwareVersion","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"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.
\nO comprimento máximo da cadeia de caracteres inteira é de 256 caracteres.
\n","name":"UserDocumentation","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Configure um grupo de aplicativos existente.
\n","syntaxes":["Set-CMApplicationGroup [-InputObject]Configure um grupo de aplicativos existente.
\n","uid":"ConfigurationManager.Set-CMApplicationGroup"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmapplicationgroup?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmapplicationgroup?view=sccm-ps"},"pageMetadata":"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 ordenar 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.\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.