Introdução rápida: Precisa retirar um ícone de app que continua aparecendo na barra lateral do Microsoft Teams mesmo depois de removido da política global? Este guia detalha todos os passos – do Teams Admin Center ao PowerShell – para eliminar a app fixada e garantir que a alteração chegue a todos os utilizadores.
Visão geral do problema
Quando se remove uma aplicação da lista de Pinned apps na política Global (Org‑wide default), o ícone costuma desaparecer automaticamente dos clientes Teams. Contudo, não é raro que a app permaneça visível por horas ou até dias. Essa “teimosia” acontece porque:
- O ficheiro de políticas é armazenado em cache localmente no Teams.
- O serviço de distribuição de políticas propaga alterações em waves, priorizando a latência da plataforma.
- Usuários podem ter políticas personalizadas que sobrepõem a global.
Como funcionam as políticas de Pinned Apps
O Teams utiliza a política de App setup para definir quais aplicações ficam fixadas na barra lateral. Essa política é resolvida desta maneira:
- Política atribuída diretamente ao utilizador.
- Política através de grupo (group policy assignment).
- Política Global (Org‑wide default) para todos os que não têm atribuição específica.
Portanto, se uma app persistir após você a remover da política global, verifique se há outras políticas em vigor ou atribuições diretas.
Remoção pontual pelo próprio utilizador
Se o caso for isolado, peça ao utilizador para:
- Abrir Teams ▶ Aplicações ▶ Gerir as suas aplicações.
- Localizar a app em questão.
- Clicar em Remover.
Esta ação apenas remove o ícone para esse utilizador; novas instalações continuarão disponíveis se a app não estiver bloqueada.
Remoção global pela equipa de TI
Pelo Teams Admin Center
- Navegue até Teams apps ▶ Manage apps.
- Confirme em Org‑wide app settings que Allow third‑party apps continua Enable (boa prática Microsoft).
- Na lista, selecione a aplicação indesejada e clique em Block.
- Verifique se a app foi também retirada da política Global ▶ Pinned apps.
Após o Block, a aplicação deixa de aparecer na Store interna e não pode ser instalada manualmente. O ícone fixado desaparece quando a política chega aos clientes. A replicação geralmente é inferior a 24 h, mas pode atingir 72 h (ou até 7 dias em tenants massivos).
Pelo PowerShell
# Instalar o módulo se necessário
Install-Module -Name MicrosoftTeams
Autenticar
Connect-MicrosoftTeams
Remover app da política Global
\$policy = Get-CsTeamsAppSetupPolicy -Identity Global
\$policy.PinnedAppIds = \$policy.PinnedAppIds | Where-Object { $\ -ne "APP\ID\_INDESEJADA" }
Set-CsTeamsAppSetupPolicy -Instance \$policy
Forçar atualização para um utilizador
Grant-CsTeamsAppSetupPolicy -Identity [user@contoso.com](mailto:user@contoso.com) -PolicyName GlobalConfirmar a aplicação da nova política
| Método | Passos |
|---|---|
| Teams Admin Center | Users ▶ <utilizador> ▶ Policies ▶ App setup Confirme que a app não figura em Pinned apps. |
| PowerShell | Get-CsUserPolicyAssignment -Identity <UPN>ou Get-CsTeamsAppSetupPolicy -Identity Global |
| Logs locais | Abra %appdata%\Microsoft\Teams\logs.txt e procure por PolicyPackageDownload para ver a data‑hora do último download de políticas. |
Acelerando a propagação
A mudança é assíncrona, mas pode ser agilizada:
- Reatribua a política global com
Grant-CsTeamsAppSetupPolicyao utilizador afetado. - Peça que o utilizador encerre a sessão (Sign out) e entre novamente.
- Em casos críticos, limpe o cache local do Teams.
Limpeza de cache no cliente
- Feche o Teams.
- Apague a pasta
%appdata%\Microsoft\Teams\IndexedDB. - Reabra o Teams e aguarde a sincronização.
Este procedimento elimina ícones “fantasma” que já não deveriam aparecer.
Desafixar × Bloquear: entenda a diferença
| Ação | Efeito | Quando usar |
|---|---|---|
| Desafixar | Remove o ícone da barra lateral, mas mantém a app disponível na Store. | Quando quer apenas reduzir a poluição visual e promover outras apps. |
| Bloquear | Oculta a app da Store e impede novas instalações. | Quando a app é obsoleta, insegura ou migrou para outra solução. |
Automatizando com PowerShell e Microsoft Graph
Em ambientes com milhares de licenças, auditar e remover apps manualmente é inviável. Utilize scripts que:
- Exportem todas as políticas de App Setup.
Get-CsTeamsAppSetupPolicy | Export-Csv TeamsAppPolicies.csv - Identifiquem políticas onde
PinnedAppIdscontém aAPPIDINDESEJADA. - Atualizem essas políticas removendo o ID.
- Reapliquem a política a utilizadores e grupos.
Para auditoria contínua, a Graph API oferece o endpoint /beta/teamsAppSettings/pinnedApps, permitindo queries periódicas que geram alertas se a app reaparecer.
Boas práticas para mudanças em larga escala
- Planeje fora do horário de pico: em grandes tenants, a replicação pode estender‑se a 7 dias; agende alterações antes de fins de semana ou feriados.
- Comunique previamente: um aviso no Viva Engage (Yammer) ou e‑mail evita chamados de suporte.
- Teste em piloto: crie uma política de App Setup de teste e atribua a um grupo limitado.
- Mantenha registro: documente o App ID, a data da mudança e quem aprovou.
- Monitore logs: configure alertas no Sentinel ou Splunk para eventos de política do Teams.
Perguntas frequentes (FAQ)
É possível remover uma app fixada somente para um departamento?
Sim. Crie uma política de App Setup sem a app e atribua‑a a um grupo de segurança que contenha apenas os utilizadores desse departamento.
Posso forçar a aplicação imediata da política?
Não existe “push” instantâneo. O máximo que se pode fazer é reatribuir a política e pedir ao utilizador para reiniciar‑se no Teams.
Desinstalar a app localmente funciona?
Não. A app retornará se continuar listada como Pinned ou permitida para instalação. A remoção local é apenas temporária.
Como sei o ID da aplicação que quero remover?
No Teams Admin Center, abra a app e copie o valor em App ID. Ele tem o formato com.contoso.app ou um GUID.
Conclusão
Remover apps fixadas no Microsoft Teams exige compreender a hierarquia das políticas e a cadência de replicação interna do serviço. Ao combinar:
- remover a app da política Global ▶ Pinned apps,
- bloquear a aplicação no Teams Admin Center,
- forçar a reaplicação via PowerShell quando necessário
você garante que o ícone desapareça de forma definitiva, evitando ruído na experiência do utilizador e reduzindo o volume de chamados de suporte. Planejar, comunicar e monitorar são pilares para o sucesso em ambientes de produção.
Após a janela de replicação ― normalmente menos de 24 horas, no máximo 72 horas ― a aplicação não deverá mais aparecer em nenhum cliente Teams.