az devops service-endpoint

Note

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az devops service-endpoint. Altre informazioni sulle estensioni.

Gestire endpoint/connessioni di servizio.

Comandi

Nome Descrizione Tipo Status
az devops service-endpoint azurerm

Gestire Azure endpoint/connessioni del servizio RM.

 Extension GA
az devops service-endpoint azurerm create

Creare un endpoint di servizio di tipo RM Azure.

 Extension GA
az devops service-endpoint convert

Convertire un endpoint di servizio per usare credenziali federate esterne.

 Extension GA
az devops service-endpoint create

Creare un endpoint di servizio usando il file di configurazione.

 Extension GA
az devops service-endpoint delete

Elimina l'endpoint del servizio.

 Extension GA
az devops service-endpoint github

Gestire GitHub endpoint/connessioni del servizio.

 Extension GA
az devops service-endpoint github create

Creare un endpoint di servizio GitHub.

 Extension GA
az devops service-endpoint list

Elencare gli endpoint di servizio in un progetto.

 Extension GA
az devops service-endpoint show

Ottenere i dettagli di un endpoint di servizio.

 Extension GA
az devops service-endpoint update

Aggiornare un endpoint di servizio.

 Extension GA

az devops service-endpoint convert

Convertire un endpoint di servizio per usare credenziali federate esterne.

Invia una richiesta di migrazione all'API di migrazione delle credenziali federate esterne Azure DevOps per la connessione al servizio specificata tramite --azdo-subject. Il valore --azdo-subject deve essere nel sc://<organization>/<project>/<serviceConnectionName> formato . L'URL dell'organizzazione viene derivato automaticamente da --azdo-subject usando https://dev.azure.com. Usare --tenant-id per selezionare il tenant Entra usato per eseguire l'autenticazione all'organizzazione Azure DevOps.

az devops service-endpoint convert --azdo-subject
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--tenant-id]

Esempio

Convertire usando solo la connessione al servizio (derivata automaticamente dall'organizzazione)

az devops service-endpoint convert --azdo-subject "sc://myorg/myproject/myserviceconnection"

Eseguire la conversione usando un tenant di autenticazione specifico

az devops service-endpoint convert --azdo-subject "sc://myorg/myproject/myserviceconnection" --tenant-id "00000000-0000-0000-0000-000000000000"

Parametri necessari

--azdo-subject

Oggetto delle credenziali federate dell'autorità emittente Azure DevOps, in sc://<organization>/<project>/<serviceConnectionName> formato . L'URL dell'organizzazione è derivato da --azdo-subject usando https://dev.azure.com.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--tenant-id

ID tenant Entra usato per eseguire l'autenticazione all'organizzazione Azure DevOps. L'impostazione predefinita è il tenant di sottoscrizione predefinito o il primo tenant della sottoscrizione memorizzato nella cache.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az devops service-endpoint create

Creare un endpoint di servizio usando il file di configurazione.

Per altre informazioni, vedere https://aka.ms/azure-devops-service-endpoint-config.

az devops service-endpoint create --service-endpoint-configuration
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--detect {false, true}]
                                  [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                                  [--org --organization]
                                  [--project]

Parametri necessari

--service-endpoint-configuration

File di configurazione con richiesta dell'endpoint di servizio.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--encoding

Codifica del file di input.

Proprietà Valore
Valore predefinito: utf-8
Valori accettati: ascii, utf-16be, utf-16le, utf-8
--org --organization

Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az devops service-endpoint delete

Elimina l'endpoint del servizio.

az devops service-endpoint delete --id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--deep]
                                  [--detect {false, true}]
                                  [--org --organization]
                                  [--project]
                                  [--yes]

Parametri necessari

--id

ID dell'endpoint del servizio da eliminare.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--deep

Specifico dell'endpoint AzureRM creato nel flusso automatico. Quando viene specificato, verrà eliminata anche l'applicazione AAD corrispondente in Azure.

Proprietà Valore
Valore predefinito: False
--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--org --organization

Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az devops service-endpoint list

Elencare gli endpoint di servizio in un progetto.

:rtype: elenco di :class:VssJsonCollectionWrapper <service_endpoint.v4_1.models.ServiceEndpoint>.

az devops service-endpoint list [--detect {false, true}]
                                [--org --organization]
                                [--project]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--org --organization

Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az devops service-endpoint show

Ottenere i dettagli di un endpoint di servizio.

az devops service-endpoint show --id
                                [--detect {false, true}]
                                [--org --organization]
                                [--project]

Parametri necessari

--id

ID dell'endpoint del servizio.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--org --organization

Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az devops service-endpoint update

Aggiornare un endpoint di servizio.

az devops service-endpoint update --id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--detect {false, true}]
                                  [--enable-for-all {false, true}]
                                  [--org --organization]
                                  [--project]

Parametri necessari

--id

ID dell'endpoint del servizio.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--enable-for-all

Consentire a tutte le pipeline di accedere a questo endpoint di servizio.

Proprietà Valore
Valori accettati: false, true
--org --organization

Azure DevOps URL dell'organizzazione. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False