az devops migrations

  • Anteprima

Annotazioni

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 migrations . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire le migrazioni in tempo reale aziendali.

Questo gruppo di comandi fa parte dell'estensione azure-devops ed è in anteprima. La disponibilità può essere limitata (ad esempio, agli utenti 1P/consentiti). Per le migrazioni ELM, --org deve essere l'URL dell'organizzazione di Azure DevOps( ad esempio: https://dev.azure.com/myorg).

Comandi

Nome Descrizione Tipo Status
az devops migrations abandon

Abbandonare una migrazione.

 Estensione Anteprima
az devops migrations create

Creare una migrazione per un repository.

 Estensione Anteprima
az devops migrations cutover

Gestire il cutover della migrazione.

 Estensione Anteprima
az devops migrations cutover approve

Approvare il cutover accettando elementi non elaborati e/o verificando le pipeline rewired.

 Estensione Anteprima
az devops migrations cutover cancel

Annullare un cutover pianificato.

 Estensione Anteprima
az devops migrations cutover review

Esaminare gli elementi di migrazione non elaborati prima del cutover.

 Estensione Anteprima
az devops migrations cutover set

Pianificare il cutover per una migrazione.

 Estensione Anteprima
az devops migrations list

Elencare le migrazioni in un'organizzazione.

 Estensione Anteprima
az devops migrations pause

Sospendere una migrazione attiva.

 Estensione Anteprima
az devops migrations pipelines

Gestire il riwiring della pipeline per le migrazioni. (Anteprima).

 Estensione Anteprima
az devops migrations pipelines delete

Eliminare i dati di riwiring della pipeline per una migrazione. (Anteprima).

 Estensione Anteprima
az devops migrations pipelines list

Elencare la configurazione di riwiring della pipeline e lo stato per ogni pipeline.

 Estensione Anteprima
az devops migrations pipelines retry

Ripetizione di tentativi di ripetizione del rewiring della pipeline non riuscita. (Anteprima).

 Estensione Anteprima
az devops migrations pipelines submit

Inviare pipeline per il riwiring. (Anteprima).

 Estensione Anteprima
az devops migrations pipelines update

Configurazione di riwiring della pipeline di aggiornamento in blocco. (Anteprima).

 Estensione Anteprima
az devops migrations resume

Riprendere una migrazione arrestata (sospesa, non riuscita).

 Estensione Anteprima
az devops migrations status

Ottenere lo stato della migrazione per un repository.

 Estensione Anteprima

az devops migrations abandon

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Abbandonare una migrazione.

Sposta la migrazione in uno stato abbandonato/non riuscito; il record di migrazione non viene eliminato. I dati di riwiring della pipeline sono rimasti intatti in modo che una successiva migrazione possa riutilizzarla.

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--remove-read-only]
                             [--repository-id]
                             [--yes]

Esempio

Abbandonare e mantenere il repository di sola lettura (impostazione predefinita).

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Abbandonare e ripristinare il repository in lettura/scrittura.

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only

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
--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Impostare anche il repository Azure Repos sullo stato di lettura/scrittura inviando removeReadOnly=true.

Proprietà Valore
Valore predefinito: False
--repository-id

ID del repository Repos di Azure (GUID).

--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 sottoscrizione predefinita 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 migrations create

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare una migrazione per un repository.

Se --github-token non viene fornito, l'interfaccia della riga di comando controlla ELM_GITHUB_TOKEN e quindi esegue GitHub flusso del dispositivo per acquisire un token.

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--auto-discover --enable-auto-discover-pipelines]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--enable-boards-gh --enable-boards-github-connection]
                            [--github-token]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--service-endpoint-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

Esempio

Creare una migrazione.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool>

Creare una migrazione di sola convalida.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize

Creare usando un token di GitHub o pat pregenerato.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --github-token <token>

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
--agent-pool

Nome del pool di agenti da usare per il lavoro di migrazione.

--auto-discover --enable-auto-discover-pipelines

Acconsentire esplicitamente all'individuazione automatica della pipeline al cutover. Disattivato per impostazione predefinita. Se abilitato, il processo di sincronizzazione ELM illustra il repository di origine e crea definizioni di clonazione per ogni pipeline che vi fa riferimento. Richiede --pipeline-service-connection-id; senza l'individuazione viene eseguita come no-op e registra 0 pipeline. La riwiring della pipeline è sempre disponibile tramite az devops migrations pipelines submit/update.

Proprietà Valore
Valore predefinito: False
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--cutover-date

Data/ora di cutover pianificata (ISO 8601).

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà Valore
Valori accettati: false, true
--enable-boards-gh --enable-boards-github-connection

Acconsentire esplicitamente al provisioning della connessione Azure Boards GitHub al cutover. Disattivato per impostazione predefinita. Richiede l'installazione dell'app Azure Boards GitHub nell'organizzazione GitHub Enterprise di destinazione prima dell'esecuzione della migrazione.

Proprietà Valore
Valore predefinito: False
--github-token

GitHub token utente usato per la verifica dell'identità utente nell'host di destinazione. Indipendente da --service-endpoint-id. Se omesso e --service-endpoint-id non viene specificato, l'interfaccia della riga di comando controlla ELM_GITHUB_TOKEN e quindi esegue GitHub flusso del dispositivo. Quando viene specificato --service-endpoint-id, il flusso del dispositivo viene ignorato; passare --github-token o impostare ELM_GITHUB_TOKEN per fornire il token utente.

--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--pipeline-sc-id --pipeline-service-connection-id

Project-scoped GitHub service connection ID (GUID) collegato in fase di creazione per il riwiring della pipeline. Obbligatorio per l'individuazione automatica completa in combinazione con --enable-auto-discover-pipelines; facoltativo in modalità manuale (pre-collega la connessione in modo che le pipeline successive inviano le chiamate necessitano solo di --pipeline-ids).

--repository-id

ID del repository Repos di Azure (GUID).

--service-endpoint-id

ID endpoint servizio (GUID) per la connessione GitHub Enterprise Server usata per sincronizzare i commit nella destinazione. Indipendentemente dalla verifica dell'identità utente: è possibile specificare --github-token/ELM_GITHUB_TOKEN insieme a questo flag. Il flusso del dispositivo viene ignorato quando questo flag è impostato.

--skip-validation

Criteri di convalida da ignorare. Accetta un elenco delimitato da virgole di nomi di criteri (ad esempio AgentPoolExists,MaxFileSize) o una maschera di bit integer non negativa. Nomi di criteri supportati (senza distinzione tra maiuscole e minuscole): None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

ID utente proprietario del repository di destinazione. Deprecato e ignorato quando è abilitata la risoluzione del proprietario basata su token sul lato server.

--target-repository

URL del repository di destinazione (deve iniziare con http:// o https://).

--validate-only

Crea in modalità di sola convalida (solo controlli di pre-migrazione).

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 sottoscrizione predefinita 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 migrations list

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare le migrazioni in un'organizzazione.

Per impostazione predefinita, viene restituita la migrazione più recente per ogni repository, indipendentemente dallo stato. Usare --include-all per restituire la cronologia completa della migrazione.

az devops migrations list [--detect {false, true}]
                          [--include-all]
                          [--include-inactive]
                          [--org --organization]
                          [--project]

Esempio

Elencare la migrazione più recente per ogni repository.

az devops migrations list --org https://dev.azure.com/myorg

Elencare la cronologia completa della migrazione per ogni repository.

az devops migrations list --org https://dev.azure.com/myorg --include-all

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
--include-all

Restituisce la cronologia completa della migrazione (tutti i record per repository). Per impostazione predefinita, viene restituita solo la migrazione più recente per ogni repository, indipendentemente dal relativo stato.

Proprietà Valore
Valore predefinito: False
--include-inactive
Deprecato

L'opzione '--include-inactive' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--include-all'.

Deprecated. Usare invece --include-all.

Proprietà Valore
Valore predefinito: False
--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project

Nome o ID di progetto facoltativo per filtrare le migrazioni.

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 sottoscrizione predefinita 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 migrations pause

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Sospendere una migrazione attiva.

az devops migrations pause [--acquire-policy-token]
                           [--change-reference]
                           [--detect {false, true}]
                           [--org --organization]
                           [--repository-id]

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
--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID del repository Repos di Azure (GUID).

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 sottoscrizione predefinita 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 migrations resume

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Riprendere una migrazione arrestata (sospesa, non riuscita).

az devops migrations resume [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--migration]
                            [--org --organization]
                            [--repository-id]
                            [--validate-only]

Esempio

Riprendere l'uso della modalità corrente.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Riprendere in modalità di sola convalida.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only

Continua la migrazione (cancella la modalità di sola convalida).

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration

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
--migration

Alzare di livello una migrazione di sola convalida riuscita a una migrazione completa (imposta validateOnly=false e statusRequested=active).

Proprietà Valore
Valore predefinito: False
--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID del repository Repos di Azure (GUID).

--validate-only

Riprendere in modalità di sola convalida.

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 sottoscrizione predefinita 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 migrations status

Anteprima

Il gruppo di comandi "devops migrations" è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere lo stato della migrazione per un repository.

az devops migrations status [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--org --organization]
                            [--repository-id]

Esempio

Ottenere lo stato della migrazione in base all'ID del repository.

az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

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
--org --organization

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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID del repository Repos di Azure (GUID).

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 sottoscrizione predefinita 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