Condividi tramite

Installazione di estensioni

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Installare, assegnare, disabilitare e disinstallare le estensioni, che aggiungono nuove funzionalità e funzionalità per Azure DevOps.

Per altre informazioni sulle estensioni, vedere le panoramiche sullo sviluppo e la pubblicazione.

Prerequisiti

  • Solo i membri del gruppo Project Collection Administrators o che dispongono delle autorizzazioni "Modifica informazioni a livello di raccolta" possono installare le estensioni. I proprietari dell'organizzazione sono automaticamente membri di questo gruppo. Se non si dispone delle autorizzazioni, è possibile richiedere estensioni o cercare un amministratore della raccolta di progetti.
  • Per poter essere installate, le estensioni private devono essere condivise con l'organizzazione. Per informazioni su come condividere le estensioni private, vedere la documentazione relativa alla pubblicazione.

Nota

Per usare una sottoscrizione di Azure esistente per la fatturazione, è necessario disporre almeno delle autorizzazioni di coamministratore per tale sottoscrizione. Se non si dispone delle autorizzazioni, un amministratore account di Azure o un amministratore del servizio può aggiungere l'utente come coamministratore alla sottoscrizione di Azure nel portale di Azure.

La raccolta di progetti riutilizza la sottoscrizione di Azure per gli acquisti futuri del Marketplace. Dove è possibile trovare altre informazioni sulla fatturazione di Azure?

Installare un'estensione

Installare un'estensione per l'organizzazione seguendo questa procedura.

  1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

  2. Selezionare l'icona del carrello acquisti e quindi selezionare Sfoglia marketplace.

    Screenshot che mostra l'icona del carrello acquisti evidenziata e la selezione del pulsante Sfoglia marketplace.

  3. Trovare l'estensione che si vuole installare e selezionare Scarica gratuitamente.

    Screenshot che mostra l'evidenziazione del quadrato rosso con il pulsante Scarica gratis.

  4. Selezionare l'organizzazione dal menu a discesa e quindi selezionare Installa per installare l'estensione.

    Selezionare l'organizzazione per questa estensione

L'estensione è ora installata. È ora possibile passare all'organizzazione per usare l'estensione. Inoltre, comunicare al team questa estensione, in modo che possano iniziare a usare le relative funzionalità.

Estensione installata

  1. Passare a Marketplace.visualstudio.com.

  2. Accedere usando le credenziali di Azure DevOps.

  3. Trovare l'estensione da installare. Usare la casella di ricerca per filtrare l'elenco delle estensioni.

    Screenshot della selezione di un'estensione.

  4. Selezionare l'estensione e selezionare Scarica o Scarica gratuitamente. In alternativa, per alcune estensioni di terze parti, selezionare Introduzione per visualizzare le informazioni sui prezzi e le istruzioni di installazione specifiche dell'estensione.

    Screenshot del recupero delle estensioni.

    Se non si dispone dell'autorizzazione per installare l'estensione, è possibile richiedere a un amministratore di installarlo automaticamente. La richiesta viene archiviata in Azure DevOps Server ed è pronta per l'attenzione di un amministratore.

  5. Selezionare Scarica per scaricare il file vsix.

  6. Caricare il vsix nel Marketplace locale. Aprire la home page di Azure DevOps Server (https://{server}:DefaultCollection).

  7. Passare a Impostazioni>raccolta Sfoglia le estensioni locali.

    Screenshot della selezione, pulsante Sfoglia estensioni locali.

  8. Selezionare Gestisci estensioni e quindi Caricare il file vsix.

    Screenshot della selezione, Gestisci estensioni.

  9. Installare l'estensione nella raccolta di progetti nella pagina Gestisci estensioni . Selezionare la raccolta di progetti in cui si vuole installare l'estensione e scegliere Installa.

Screenshot di Selezionare la raccolta di progetti e scegliere Installa.

  1. Al termine dell'installazione, passare alla raccolta di progetti o tornare al Marketplace per trovare altre estensioni.

Screenshot che mostra l'installazione dell'estensione completata.

Disinstallare o disabilitare un'estensione

  1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

  2. Selezionare icona a forma di ingranaggio Impostazioni organizzazione.

    Screenshot che mostra le impostazioni apri organizzazione.

  3. Selezionare Estensioni e quindi selezionare l'estensione da disinstallare o disabilitare.

    Screenshot che mostra La selezione della disinstallazione o la disabilitazione per l'estensione.

  4. Selezionare Disinstalla o selezionare i puntini di sospensione (...), quindi selezionare Disabilita.

    Screenshot che mostra le azioni di disabilitazione o disinstallazione dell'estensione.

Per disinstallare le estensioni in una raccolta, seguire questa procedura.

  1. Passare al portale di gestione della raccolta locale (http://{server}:8080/tfs/_gallery/manage).

  2. Per l'estensione desiderata, selezionare i puntini di sospensione (...) e quindi selezionare Rimuovi.

    Screenshot che mostra l'azione Rimuovi estensione.

Abilitare o elencare le estensioni tramite la riga di comando

Abilitare un'estensione con il comando az devops extension enable . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

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

Parametri : abilitare l'estensione

  • extension-name: nome dell'estensione da abilitare.
  • publisher-name: nome del server di pubblicazione dell'estensione.
  • org: URL dell'organizzazione di Azure DevOps. Configurare l'organizzazione predefinita con az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio: abilitare l'estensione

Il comando seguente abilita l'estensione Timetracker e mostra il risultato in formato tabella.

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

Elencare le estensioni

È possibile elencare le estensioni installate nell'organizzazione con il comando az devops extension list . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

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

Parametri facoltativi - Estensioni elenco

  • include-built-in: includere le estensioni predefinite. I valori accettati sono true (impostazione predefinita) e false.
  • include-disabled: includere le estensioni disabilitate. I valori accettati sono true (impostazione predefinita) e false.
  • org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio - Elencare le estensioni

Il comando seguente elenca le estensioni nell'organizzazione. Esclude le estensioni disabilitate e predefinite e mostra i risultati in formato tabella.

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

Elencare le informazioni sull'estensione

È possibile elencare i dettagli di un'estensione con il comando az devops extension show . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

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

Parametri - Informazioni sull'estensione dell'elenco

  • extension-name: nome dell'estensione.
  • publisher-name: nome del server di pubblicazione dell'estensione.
  • org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio : informazioni sull'estensione elenco

Il comando seguente mostra informazioni sull'estensione Timetracker in formato tabella.

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

Domande frequenti

D: Perché l'organizzazione non viene visualizzata dalla pagina di installazione del Marketplace?

R: Se l'organizzazione non viene visualizzata durante l'acquisto da Azure DevOps Marketplace, provare la procedura seguente:

  1. Controllare l'identità usata per accedere a Visual Studio Marketplace. Nell'angolo superiore destro selezionare il nome utente per visualizzare il profilo.
  2. Assicurarsi che l'indirizzo di posta elettronica e la directory siano corretti.
  3. Chiudere tutte le finestre del browser.
  4. Aprire una sessione di esplorazione privata o in incognito.
  5. Accedere a Visual Studio Marketplace. Usare l'identità di un utente nell'organizzazione desiderata.

Suggerimento

Azure DevOps potrebbe chiedere di scegliere tra "account aziendale o dell'istituto di istruzione" o "account personale". In tal caso, è stato usato un indirizzo di posta elettronica identico per un account Microsoft e un "account aziendale o dell'istituto di istruzione" gestito dall'organizzazione in Microsoft Entra ID. Anche se queste identità hanno lo stesso indirizzo di posta elettronica, sono comunque identità separate con profili, impostazioni di sicurezza e autorizzazioni diversi. Scegliere l'identità per l'utente nell'organizzazione da selezionare.

D: Perché non è possibile installare un'estensione?

R: Non è possibile installare le estensioni per uno dei motivi seguenti.

D: Perché gli utenti non possono accedere alle funzionalità dell'estensione?

R: Gli utenti non possono accedere a un'estensione per uno dei motivi seguenti.

  • La maggior parte delle estensioni richiede che gli utenti abbiano almeno l'accesso Basic, non stakeholder. Ad esempio, è possibile installare l'estensione free Code Search, ma ogni utente deve avere almeno l'accesso Basic per cercare il codice. Per aiutare il team a migliorare la qualità delle app, è possibile installare l'estensione test e feedback gratuita. Si riscontrano funzionalità diverse, in base al livello di accesso e al funzionamento offline o connessi ad Azure DevOps Services o a Azure DevOps Server locale. Per altre informazioni, vedere la descrizione dell'estensione nella scheda Visual Studio Marketplace, Azure DevOps.

  • Se si usa un'organizzazione e si è avviata una versione di valutazione gratuita dell'estensione, la versione di valutazione potrebbe essere scaduta. Controllare se la versione di valutazione è scaduta.

    1. Sulla barra degli strumenti dell'organizzazione selezionare Utenti.
    2. Passare al riquadro dell'estensione.
    3. Verificare la presenza di un messaggio di scadenza per trovare se o quando l'estensione è scaduta.

  • Se si usa un'organizzazione e si paga per questa estensione, assicurarsi di aver assegnato questa estensione agli utenti.

    1. Sulla barra degli strumenti dell'organizzazione passare a Utenti.
    2. Passare al riquadro dell'estensione.
    3. Controllare se l'estensione è assegnata all'utente. In caso contrario, assegnare l'estensione all'utente.

Per altre informazioni, vedere Assegnare estensioni agli utenti.

D: Cosa è successo all'estensione di anteprima?

R: L'estensione potrebbe non essere disponibile in anteprima. Dopo un periodo di anteprima, un'estensione più lunga è disponibile a livello generale come estensione a pagamento. Un periodo di tolleranza potrebbe essere offerto prima di dover acquistare l'estensione. Tutte le estensioni di anteprima vengono convertite automaticamente in una versione di valutazione gratuita prima di dover acquistare l'estensione.

D: Perché non è possibile installare le estensioni per Azure DevOps Server?

R: Non è possibile installare le estensioni per Azure DevOps Server per uno dei motivi seguenti:

  • È necessario essere membri del gruppo Project Collection Administrators o disporre dell'autorizzazione Modifica informazioni a livello di raccolta impostata su Consenti nella raccolta di progetti in cui si desidera installare le estensioni. Se non si dispone delle autorizzazioni, è possibile richiedere invece le estensioni .
  • È possibile che venga visualizzato un errore che indica che l'estensione è già stata installata o richiesta. In tal caso, rivolgersi a un membro del gruppo Project Collection Administrators e chiedere loro di assegnare l'estensione. Per altre informazioni, vedere Richiedere un aumento dei livelli di autorizzazione.

D: Perché non viene visualizzata la raccolta di progetti desiderata (locale)?

R: È necessario essere membri della raccolta di progetti. Seguire questa procedura per verificare l'identità usata per accedere al Marketplace.

  1. Nella home page del portale Web di Azure DevOps Server (https://{server}:8080/tfs/) passare all'angolo superiore destro della pagina e selezionare il nome utente per visualizzare il profilo.

  2. Sul lato sinistro del profilo assicurarsi che l'indirizzo di posta elettronica e la directory siano corretti.

  3. Chiudere tutte le finestre del browser.

  4. Aprire una sessione di esplorazione privata o in incognito.

  5. Accedere alla home page di Azure DevOps Server (https://{server}:8080/tfs/) con l'identità di un utente nella raccolta di progetti in cui si vuole installare l'estensione.

    Azure DevOps potrebbe chiedere di scegliere tra un"organizzazione aziendale o dell'istituto di istruzione" o un "account personale". Questo messaggio indica che è stato usato un indirizzo di posta elettronica identico per un account Microsoft e un "account aziendale o dell'istituto di istruzione" gestito dall'organizzazione in Microsoft Entra ID. Anche se queste identità hanno lo stesso indirizzo di posta elettronica, sono comunque identità separate con profili, impostazioni di sicurezza e autorizzazioni diversi. Scegliere l'identità dell'utente nella raccolta di progetti.

  6. Dalla raccolta di progetti passare al Marketplace.

D: Perché l'estensione che voglio visualizzare un pulsante di download (locale)?

R: Alcune estensioni funzionano solo con Azure DevOps Services per uno dei motivi seguenti:

  • L'estensione usa le funzionalità di Azure DevOps non ancora rilasciate per Azure DevOps Server.
  • Il manifesto dell'estensione indica che l'estensione è disponibile solo per Azure DevOps Services (destinazioni = Microsoft.Visualstudio.Services.Cloud).
  • Il manifesto dell'estensione indica che l'estensione è un'integrazione (targets = Microsoft.Visualstudio.Services.Integration).

D: Perché non è possibile caricare le estensioni in Azure DevOps Server?

R: È necessario essere membri del gruppo Team Foundation Administrators. È anche necessario disporre delle autorizzazioni di modifica delle informazioni a livello di istanza per azure DevOps Server in cui si vogliono caricare le estensioni.

D: Ricerca per categorie ottenere supporto per sottoscrizioni, fatturazione e Marketplace di Azure?

R: A seconda del supporto necessario, scegliere tra gli articoli seguenti:

Nota

Il team di supporto di Azure DevOps non supporta le estensioni di Visual Studio Marketplace. Per ottenere supporto sulle estensioni del marketplace, individuare l'estensione in uso in Visual Studio Marketplace. Nella pagina dell'estensione è possibile trovare un collegamento al repository GitHub in cui è possibile creare un problema o ottenere un collegamento per ottenere il supporto della community.

Passaggi successivi

Gestire autorizzazioni estensioni