az migrate runbook

Anteprima

Note

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

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

Gestire i runbook Azure Migrate.

Comandi per generare e gestire Azure Migrate runbook e le relative esecuzioni. Questo gruppo di comandi è in anteprima e in fase di sviluppo attivo; altri sottogruppi e comandi vengono aggiunti in modo incrementale.

Per evitare di ripetere --resource-group/-g e --project-name/-p in ogni comando, impostare le impostazioni predefinite una sola volta. Ad esempio: az configure --defaults group=<rg> migrate_project=<name>. Una volta impostata, è possibile omettere -g e -p; un flag esplicito vince sempre.

Comandi

Nome	Descrizione	Tipo	Status
az migrate runbook definition	Visualizzare e scaricare il contenuto di una definizione di runbook.	Extension	Preview
az migrate runbook definition download	Scaricare i file di definizione e documentazione del runbook.	Extension	Preview
az migrate runbook definition show	Visualizzare la definizione (contenuto) di un runbook.	Extension	Preview
az migrate runbook definition step	Gestire i singoli passaggi in una definizione di runbook.	Extension	Preview
az migrate runbook definition step-group	Gestire i gruppi di passaggi in una definizione di runbook.	Extension	Preview
az migrate runbook definition step-group merge	Unire due o più gruppi di passaggi in un singolo gruppo di passaggi.	Extension	Preview
az migrate runbook definition step-group split	Dividere un gruppo di passaggi in due gruppi di passaggi.	Extension	Preview
az migrate runbook definition step add	Aggiungere un passaggio alla definizione del runbook.	Extension	Preview
az migrate runbook definition step remove	Rimuovere un passaggio dalla definizione del runbook.	Extension	Preview
az migrate runbook definition step update	Aggiornare un passaggio nella definizione del runbook.	Extension	Preview
az migrate runbook definition visualize	Eseguire il rendering della definizione del runbook come pagina HTML autonoma.	Extension	Preview
az migrate runbook delete	Eliminare un runbook.	Extension	Preview
az migrate runbook execution	Gestire le esecuzioni dei runbook.	Extension	Preview
az migrate runbook execution cancel	Annullare un'esecuzione di runbook in corso o sospesa.	Extension	Preview
az migrate runbook execution list	Elencare le esecuzioni di un runbook.	Extension	Preview
az migrate runbook execution parameter	Scaricare, caricare e configurare il file dei parametri di input di un'esecuzione.	Extension	Preview
az migrate runbook execution parameter configure	Generare un editor HTML offline per i parametri di un'esecuzione.	Extension	Preview
az migrate runbook execution parameter download	Scaricare i file di parametri di un'esecuzione.	Extension	Preview
az migrate runbook execution parameter upload	Caricare il file dei parametri di input di un'esecuzione.	Extension	Preview
az migrate runbook execution pause	Sospendere l'esecuzione di un runbook in corso.	Extension	Preview
az migrate runbook execution resume	Riprendere l'esecuzione di un runbook sospeso.	Extension	Preview
az migrate runbook execution show	Visualizzare (o controllare) lo stato di un'esecuzione di runbook.	Extension	Preview
az migrate runbook execution start	Avviare una nuova esecuzione di un runbook.	Extension	Preview
az migrate runbook execution step	Agire su un singolo passaggio all'interno di un'esecuzione del runbook.	Extension	Preview
az migrate runbook execution step approve	Fornire l'approvazione per un passaggio di tipo approvazione durante l'esecuzione.	Extension	Preview
az migrate runbook execution step complete	Contrassegnare un passaggio manuale come completato durante l'esecuzione.	Extension	Preview
az migrate runbook execution step retry	Riavviare l'esecuzione di un passaggio non riuscito.	Extension	Preview
az migrate runbook execution visualize	Eseguire il rendering dello stato di un'esecuzione come grafico HTML autonomo.	Extension	Preview
az migrate runbook generate	Generare un runbook per un'ondata di migrazione.	Extension	Preview
az migrate runbook list	Elencare i runbook in un progetto di migrazione.	Extension	Preview
az migrate runbook parameter	Scaricare, caricare e configurare il file di parametri (input) di un runbook.	Extension	Preview
az migrate runbook parameter configure	Generare un editor HTML offline per il file di parametri.	Extension	Preview
az migrate runbook parameter download	Scaricare i file di parametri del runbook.	Extension	Preview
az migrate runbook parameter upload	Caricare un nuovo file di parametri e convalidarlo.	Extension	Preview
az migrate runbook regenerate	Rigenerare un runbook dall'ambito corrente.	Extension	Preview
az migrate runbook show	Ottenere i dettagli di un runbook.	Extension	Preview
az migrate runbook update	Aggiornare i metadati dei runbook modificabili.	Extension	Preview
az migrate runbook wait	Attendere che un runbook raggiunga uno stato desiderato.	Extension	Preview

az migrate runbook delete

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un runbook.

az migrate runbook delete --name --runbook-name
                          --project-name
                          --resource-group
                          [--acquire-policy-token]
                          [--change-reference]
                          [--no-wait]
                          [--yes]

Esempio

Eliminare un runbook.

az migrate runbook delete -g myRg --project-name myProject \
  -n myRunbook

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

--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 migrate runbook generate

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Generare un runbook per un'ondata di migrazione.

az migrate runbook generate --name --runbook-name
                            --project-name
                            --resource-group
                            --wave-name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--no-visualize]
                            [--no-wait]

Esempio

Generare un runbook con ambito a un'onda.

az migrate runbook generate -g myRg --project-name myProject \
  -n myRunbook --wave-name myWave

Generare un runbook e restituire immediatamente.

az migrate runbook generate -g myRg --project-name myProject \
  -n myRunbook --wave-name myWave --no-wait

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--wave-name

Nome dell'onda da cui generare il runbook (obbligatorio).

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

--no-visualize

Non aprire la visualizzazione HTML della definizione del runbook dopo la generazione del runbook. Utile per l'automazione e gli ambienti non interattivi.

Proprietà	Valore
Valore predefinito:	False

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

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 migrate runbook list

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare i runbook in un progetto di migrazione.

az migrate runbook list --project-name
                        --resource-group
                        [--status {Completed, Failed, Generating, InExecution, NotConfigured, Paused, ReadyToStart}]
                        [--wave-name]

Esempio

Elencare tutti i runbook in un progetto.

az migrate runbook list -g myRg --project-name myProject

Elencare i runbook filtrati in base all'onda e allo stato.

az migrate runbook list -g myRg --project-name myProject \
  --wave-name myWave --status InExecution

Parametri necessari

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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.

--status

Filtrare i runbook in base allo stato del ciclo di vita.

Proprietà	Valore
Valori accettati:	Completed, Failed, Generating, InExecution, NotConfigured, Paused, ReadyToStart

--wave-name

Filtrare i runbook in base al nome dell'onda.

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 migrate runbook regenerate

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Rigenerare un runbook dall'ambito corrente.

az migrate runbook regenerate --name --runbook-name
                              --project-name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--no-visualize]
                              [--no-wait]

Esempio

Rigenerare un runbook.

az migrate runbook regenerate -g myRg \
  --project-name myProject -n myRunbook

Rigenerare un runbook e restituire immediatamente.

az migrate runbook regenerate -g myRg \
  --project-name myProject -n myRunbook --no-wait

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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

--no-visualize

Non aprire la visualizzazione HTML della definizione del runbook dopo la rigenerazione del runbook. Utile per l'automazione e gli ambienti non interattivi.

Proprietà	Valore
Valore predefinito:	False

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

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 migrate runbook show

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere i dettagli di un runbook.

az migrate runbook show --name --runbook-name
                        --project-name
                        --resource-group

Esempio

Visualizzare i dettagli di un runbook.

az migrate runbook show -g myRg --project-name myProject \
  -n myRunbook

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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 migrate runbook update

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare i metadati dei runbook modificabili.

az migrate runbook update --name --runbook-name
                          --project-name
                          --resource-group
                          [--acquire-policy-token]
                          [--change-reference]
                          [--description]

Esempio

Aggiornare una descrizione del runbook.

az migrate runbook update -g myRg --project-name myProject \
  -n myRunbook --description "Wave 1 cutover runbook"

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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

--description

Descrizione aggiornata per il runbook.

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 migrate runbook wait

Anteprima

Il gruppo di comandi 'migrate runbook' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Attendere che un runbook raggiunga uno stato desiderato.

az migrate runbook wait --name --runbook-name
                        --project-name
                        --resource-group
                        [--acquire-policy-token]
                        [--change-reference]
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--timeout]
                        [--updated]

Esempio

Attendere il completamento dell'esecuzione.

az migrate runbook wait -g myRg --project-name myProject \
  -n myRunbook --custom "properties.state=='ExecutionSucceeded'"

Attendere che il runbook esista.

az migrate runbook wait -g myRg --project-name myProject \
  -n myRunbook --created

Parametri necessari

--name --runbook-name -n

Nome del runbook.

--project-name -p

Nome del progetto Azure Migrate. È possibile configurare l'impostazione predefinita usando az configure --defaults migrate_project=<name>.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

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

--created

Attendere che provisioningState raggiunga Succeeded.

Proprietà	Valore
Valore predefinito:	False

--custom

Attendere che venga soddisfatta una condizione JMESPath, ad esempio "properties.state=='ExecutionSucceeded'".

--deleted

Attendere che il runbook non esista più.

Proprietà	Valore
Valore predefinito:	False

--exists

Attendere che il runbook esista.

Proprietà	Valore
Valore predefinito:	False

--interval

Intervallo di polling in secondi (impostazione predefinita: 30).

Proprietà	Valore
Valore predefinito:	30

--timeout

Tempo di attesa massimo in secondi (valore predefinito: 3600).

Proprietà	Valore
Valore predefinito:	3600

--updated

Attendere che provisioningState raggiunga Operazione riuscita dopo un aggiornamento.

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

Commenti e suggerimenti

Questa pagina è stata utile?