Instalar extensões

2025-04-30

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Instalar, atribuir, desabilitar e desinstalar extensões, que adicionam novos recursos e funcionalidades para o Azure DevOps.

Para obter mais informações sobre extensões, consulte as visões gerais de desenvolvimento e publicação .

Pré-requisitos

Categoria	Requisitos
Permissões	Membro do grupo Administradores de Coleção de Projetos. Os proprietários da organização são automaticamente membros desse grupo. Se você não tiver permissões, poderá solicitar extensões ou então procurar um administrador de coleção de projetos.
Compartilhamento de extensão	Extensões privadas compartilhadas com sua organização.

Categoria	Requisitos
Permissões	Membro do grupo Administradores de Coleção de Projetos ou permissões para Editar informações no nível da coleção. Os proprietários da organização são automaticamente membros desse grupo. Se você não tiver permissões, poderá solicitar extensões ou então procurar um administrador de coleção de projetos.
Compartilhamento de extensão	Extensões privadas compartilhadas com sua organização.

Observação

Para usar uma assinatura existente do Azure para cobrança, tenha pelo menos permissões de coadministrador para essa assinatura. Se você não tiver permissões, um Administrador de Conta do Azure ou Administrador de Serviços poderá adicioná-lo como coadministrador à assinatura do Azure no portal do Azure.

Sua coleção de projetos reutiliza sua assinatura do Azure para compras futuras do Marketplace. Onde posso encontrar mais informações sobre a cobrança do Azure?

Instalar uma extensão

Instale uma extensão em sua organização executando as etapas a seguir.

Navegador
CLI do Azure DevOps

Entre em sua organização (https://dev.azure.com/{Your_Organization}).
Selecione o ícone da sacola de compras e, em seguida, selecione Procurar no Marketplace.
Encontre a extensão que você deseja instalar e selecione Obter gratuitamente.
Selecione sua organização no menu suspenso e selecione Instalar para instalar a extensão.
- Por que não vejo nenhuma organização?
- Por que não consigo instalar esta extensão?

Sua extensão agora está instalada! Agora você pode ir para sua organização para usar sua extensão. Além disso, informe sua equipe sobre essa extensão, para que eles possam começar a usar seus recursos.

Extensão instalada

Instale uma extensão com o comando az devops extension install . Para começar, confira Introdução à CLI do Azure DevOps.

Pesquisar por uma extensão

Se necessário, primeiro procure uma extensão com o az devops extension search comando.

az devops extension search --search-query

Parâmetros

search-query: especifique um termo para pesquisar no marketplace.

Exemplo

O comando a seguir pesquisa no marketplace o termo Timetracker e retorna a ID do editor e a ID da extensão em formato de tabela.

az devops extension search --search-query Timetracker --output table

Publisher Id    Extension Id    Name
--------------  --------------  -----------
7pace           Timetracker     Timetracker
7pacelabs       kitten          Kitten

Instalar a extensão

az devops extension install --extension-id
                            --publisher-id
                            [--org]

Parâmetros

extension-id: o nome da extensão a ser instalada.
publisher-id: o nome do editor da extensão.
org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo

O comando a seguir instala a extensão Timetracker e mostra o resultado no formato YAML.

az devops extension install --extension-id Timetracker --publisher-id 7pace --output yaml

baseUri: null
constraints: null
contributionTypes: null
contributions: null
demands: null
eventCallbacks: null
extensionId: Timetracker
extensionName: Timetracker
fallbackBaseUri: null
files: null
flags: null
installState:
  flags: none
  installationIssues: null
  lastUpdated: '2019-11-26T16:04:32.907000+00:00'
language: null
lastPublished: '2019-11-13T11:58:37.890000+00:00'
licensing: null
manifestVersion: null
publisherId: 7pace
publisherName: 7pace
registrationId: null
restrictedTo: null
scopes: null
serviceInstanceType: null
version: 5.0.1.34507

Instalação manual:

Use o comando a seguir para obter a extensão que você deseja instalar.

az extension add --name <extension-name>
Substitua <extension-name> pelo nome real da extensão que você deseja instalar.
- Se a extensão for de um recurso externo ou se você tiver um link direto para ela, forneça a URL de origem ou o caminho local.
az extension add --source <URL-or-path>

Você também pode criar um índice de extensão privado seguindo o formato em index.json e, em seguida, definir a URL do índice de extensão usada pela CLI do Azure a partir da versão 2.20.0. Depois disso, é possível instalar a extensão pelo nome a partir do índice particular de extensões.

Instalação automática (instalação dinâmica):

Quando você executa um comando de extensão que não está instalado, a CLI do Azure reconhece o comando executado e instala automaticamente a extensão para você (a partir da versão 2.10.0). Esse recurso chamado de instalação dinâmica está habilitado por padrão desde 2.12.0. Você também pode habilitá-lo por meio da configuração para versões anteriores com suporte:

az config set extension.use_dynamic_install=yes_prompt

Use o seguinte comando de configuração para ativar a instalação dinâmica sem um prompt:

az config set extension.use_dynamic_install=yes_without_prompt

Use o seguinte comando de configuração para desativar o recurso de instalação dinâmica para reverter para o comportamento padrão:

az config set extension.use_dynamic_install=no

O comando de extensão retornará um erro "command-not-found" se a extensão não estiver instalada.

Localização da extensão:

Depois que uma extensão é instalada, você pode encontrá-la sob o valor da $AZURE_EXTENSION_DIR variável shell. Se essa variável tiver sua definição removida, por padrão, o valor é $HOME/.azure/cliextensions no Linux e macOS e %USERPROFILE%\\.azure\\cliextensions no Windows.

Altos privilégios, decoradores de pipeline e extensões não publicadas

As extensões com escopos de alto privilégio, decoradores de pipeline ou status não publicado podem representar riscos potenciais à segurança se não forem devidamente examinadas. Os escopos de alto privilégio concedem acesso amplo aos recursos da sua organização, enquanto os decoradores de pipeline podem modificar todos os pipelines da sua organização. Extensões não publicadas podem não ser mais mantidas por seus editores. Para obter mais informações sobre como gerenciar esses tipos de extensões, consulte Gerenciar escopos de privilégios altos, decoradores de pipeline e extensões não publicadas.

Entre em sua organização (https://dev.azure.com/{Your_Organization}).
Selecione Configurações da organização.
Selecione Extensões e, em seguida, selecione a extensão que você deseja desinstalar ou desabilitar.
Selecione Desinstalar ou selecione as reticências (...) e, em seguida, selecione Desabilitar.

Desinstalar extensão | Desativar extensão

Desinstalar uma extensão

Desinstale uma extensão com o comando az devops extension uninstall . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension uninstall --extension-name
                              --publisher-name
                              [--org]
                              [--yes]

Parâmetros - desinstalar extensão

extension-name: o nome da extensão a ser desinstalada.
publisher-name: o nome do editor da extensão.
org: a URL da organização do Azure DevOps. Configure a organização padrão com az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
yes: opcional. Não solicite confirmação.

Exemplo - extensão de desinstalação

O comando a seguir desinstala a extensão "Timetracker" sem solicitar confirmação.

az devops extension uninstall --extension-name Timetracker --publisher-name 7pace --yes

Desabilitar uma extensão

Desabilite uma extensão com o comando az devops extension disable . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension disable --extension-name
                            --publisher-name
                            [--org]

Parâmetros - desativar extensão

extension-name: o nome da extensão a ser desabilitada.
publisher-name: o nome do editor da extensão.
org: a URL da organização do Azure DevOps. Configure a organização padrão com az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - desabilitar extensão

O comando a seguir desabilita a extensão Timetracker e mostra o resultado no formato de tabela.

az devops extension disable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Para desinstalar extensões em uma coleção, execute as seguintes etapas:

Vá para o portal de gerenciamento de galeria local (http://{server}:8080/tfs/_gallery/manage).
Para a extensão desejada, selecione as reticências (...) e, em seguida, selecione Remover.

Habilitar ou listar extensões por meio da linha de comando

Ative uma extensão com o comando az devops extension enable. Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parâmetros - habilitar extensão

extension-name: o nome da extensão a ser habilitada.
publisher-name: o nome do editor da extensão.
org: a URL da organização do Azure DevOps. Configure a organização padrão com az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - habilitar extensão

O comando a seguir habilita a extensão Timetracker e mostra o resultado no formato de tabela.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Listar extensões

Você pode listar as extensões instaladas em sua organização com o comando az devops extension list . Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Parâmetros opcionais - extensões de lista

include-built-in: inclua as extensões internas. Os valores aceitos são true (padrão) e false.
include-disabled: inclua as extensões desativadas. Os valores aceitos são true (padrão) e false.
org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - extensões de lista

O comando a seguir lista as extensões em sua organização. Ele exclui as extensões internas e desabilitadas e mostra os resultados no formato de tabela.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Listar informações de extensão

Você pode listar os detalhes de uma extensão usando o comando az devops extension show. Para começar, confira Introdução à CLI do Azure DevOps.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parâmetros - listar informações de extensão

extension-name: o nome da extensão.
publisher-name: o nome do editor da extensão.
org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo - listar informações de extensão

O comando a seguir mostra informações sobre a extensão Timetracker em formato de tabela.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Solucionar problemas de instalação da extensão

Para resolver problemas comuns, siga estas etapas de solução de problemas:

A extensão falha ao ser instalada:
- Verificar permissões: Para instalar extensões, verifique se você é um Administrador de Coleção de Projetos ou tenha as permissões necessárias concedidas por um administrador.
- Verificar a compatibilidade da extensão: Verifique se a extensão é compatível com sua versão do Azure DevOps. Verifique a página de detalhes da extensão para obter informações de compatibilidade.
- Problemas de rede: Verifique se a conexão de rede está estável e se não há configurações de firewall ou proxy bloqueando o processo de instalação.
Extensão falha ou causa erros:
- Coletar informações de diagnóstico: Se uma extensão falhar ou causar erros, colete informações de diagnóstico para ajudar a identificar o problema. Essas informações incluem mensagens de erro, logs e capturas de tela do problema.
- Verificar logs de extensão: Algumas extensões disponibilizam logs que podem ajudar a diagnosticar problemas. Verifique a documentação da extensão para obter informações sobre como acessar e interpretar esses logs.
- Contate o suporte: Se você não conseguir resolver o problema, entre em contato com a equipe de suporte da extensão com as informações de diagnóstico coletadas. Forneça o máximo de detalhes possível para ajudá-los a solucionar o problema.
Extensão não visível após a instalação:
- Atualizar a página: Às vezes, a extensão pode não aparecer imediatamente após a instalação.
- Verificar permissões: Verifique se você tem as permissões necessárias para exibir e usar a extensão. Algumas extensões podem exigir permissões específicas para serem visíveis.
- Reinstale a extensão: Se a extensão ainda não estiver visível, tente desinstalá-la e reinstalá-la.

Perguntas frequentes (FAQs)

P: Por que não vejo minha organização na página de instalação do Marketplace?

R: Se você não vir sua organização ao comprar no Azure DevOps Marketplace, tente as seguintes etapas:

Verifique a identidade que você usa para entrar no Visual Studio Marketplace. No canto superior direito, selecione seu nome de usuário para visualizar seu perfil.
Certifique-se de que seu endereço de e-mail e diretório estejam corretos.
Feche todas as janelas do navegador.
Abra uma sessão de navegação privada ou anônima.
Entre no Visual Studio Marketplace. Use a identidade de um usuário na organização desejada.

Dica

O Azure DevOps pode pedir que você escolha entre "conta corporativa ou de estudante" ou "conta pessoal". Nesse caso, você usou um endereço de email que é o mesmo para uma conta da Microsoft e uma "conta corporativa ou de estudante" que sua organização gerencia na ID do Microsoft Entra. Embora essas identidades tenham o mesmo endereço de email, elas ainda são identidades separadas com perfis, configurações de segurança e permissões diferentes. Escolha a identidade do usuário na organização que você deseja selecionar.

P: Por que não consigo instalar uma extensão?

R: Você não pode instalar extensões por um dos seguintes motivos.

Seja membro do grupo Administradores de Coleção de Projetos group ou Proprietário da organização. Se você não tiver permissões, mas for membro do projeto, poderá solicitar extensões .
Para um erro "já instalado ou solicitado", verifique com o administrador da coleção de projetos e peça que ele atribua a extensão a você.

P: Por que os usuários não podem acessar os recursos de extensão?

R: Os usuários não podem acessar uma extensão por um dos seguintes motivos.

A maioria das extensões exige que os usuários tenham pelo menos acesso básico, não o Stakeholder. Por exemplo, você pode instalar a extensão gratuita de Pesquisa de Código, mas cada usuário deve ter pelo menos acesso básico para pesquisar código. Para ajudar sua equipe a melhorar a qualidade do aplicativo, você pode instalar a extensão gratuita Teste e Feedback. Você experimenta recursos diferentes, com base em seu nível de acesso e se trabalha offline ou conectado a Azure DevOps Services ou Azure DevOps Server local. Para obter mais informações, consulte a descrição da extensão na guia do Azure DevOps no Visual Studio Marketplace.
Se você estiver usando uma organização e tiver iniciado uma avaliação de extensão gratuita, sua avaliação poderá ter expirado. Verifique se sua avaliação expirou.
1. Na barra de ferramentas da sua organização, selecione Usuários.
2. Vá para o painel de extensão.
3. Verifique se há uma mensagem de expiração para descobrir se ou quando sua extensão expirou.
Se você estiver usando uma organização e pagou por essa extensão, certifique-se de atribuí-la aos usuários.
1. Na barra de ferramentas da sua organização, vá para Usuários.
2. Vá para o painel de extensão.
3. Verifique se a extensão está atribuída ao usuário. Se não estiver, atribua a extensão ao usuário.

Para obter mais informações, consulte Atribuir extensões aos usuários.

P: O que aconteceu com a minha extensão de visualização?

R: Sua extensão pode estar fora de visualização. Após um período de visualização, uma extensão mais longa geralmente está disponível como uma extensão paga. Um período de carência pode ser oferecido antes que você tenha que comprar a extensão. Todas as extensões de visualização são convertidas automaticamente em uma avaliação gratuita antes de você precisar comprar a extensão.

P: Por que não consigo instalar extensões para Azure DevOps Server?

R: Você não pode instalar extensões para Azure DevOps Server por um dos seguintes motivos:

Ser membro do grupo Administradores de Coleção de Projetos ou ter a permissão Editar informações de nível de coleção definida como Permitir na coleção de projetos onde você deseja instalar extensões. Se você não tiver permissões, pode solicitar extensões em vez disso.
Você pode receber um erro informando que você já instalou ou solicitou a extensão. Em caso afirmativo, verifique com um membro do grupo Administradores de Coleção de Projetos e peça que ele atribua a extensão a você. Para obter mais informações, consulte Solicitar um aumento nos níveis de permissão.

P: Por que não vejo a coleção de projetos que desejo (no local)?

R: Ser membro da coleção de projetos. Siga estas etapas para verificar sua identidade que você usa para entrar no Marketplace.

Na home page do portal da Web Azure DevOps Server (https://{server}:8080/tfs/), vá para o canto superior direito da página e selecione seu nome de usuário para exibir seu perfil.
No lado esquerdo do seu perfil, certifique-se de que seu endereço de e-mail e diretório estejam corretos.
Feche todas as janelas do navegador.
Abra uma sessão de navegação privada ou anônima.
Entre na página inicial do Azure DevOps Server (https://{server}:8080/tfs/) usando a identidade de usuário da coleção de projetos onde você deseja instalar a extensão.
O Azure DevOps pode solicitar que você escolha entre uma "organização corporativa ou de estudante" ou "conta pessoal". Essa mensagem significa que você usou um endereço de email igual para uma conta da Microsoft e uma "conta corporativa ou de estudante" gerenciada por sua organização na ID do Microsoft Entra. Embora essas identidades tenham o mesmo endereço de email, elas ainda são identidades separadas com perfis, configurações de segurança e permissões diferentes. Escolha a identidade do usuário em sua coleção de projetos.
Na coleção de projetos, acesse o Marketplace.

P: Por que a extensão que eu quero não mostra um botão de download (local)?

R: Algumas extensões funcionam apenas com Azure DevOps Services por um dos seguintes motivos:

A extensão usa recursos do Azure DevOps que ainda não foram lançados para Azure DevOps Server.
O manifesto da extensão indica que a extensão está disponível apenas para Azure DevOps Services (destinos = Microsoft.Visualstudio.Services.Cloud).
O manifesto da extensão indica que se trata de uma integração (alvos = Microsoft.Visualstudio.Services.Integration).

P: Por que não consigo carregar extensões para Azure DevOps Server?

R: Ser membro do grupo Administradores do Team Foundation. Você também deve ter permissões para Editar informações no nível da instância no Azure DevOps Server onde deseja fazer upload de extensões.

Próximas etapas

Gerenciar permissões de extensão