az blueprint

  • Riferimento

Nota

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

Comandi per gestire il progetto.

Comandi

Nome Descrizione Tipo Stato
az blueprint artifact

Comandi per gestire l'artefatto del progetto.

 Estensione Disponibilità generale
az blueprint artifact delete

Eliminare un artefatto di progetto.

 Estensione Anteprima
az blueprint artifact list

Elencare gli artefatti per una determinata definizione di progetto.

 Estensione Anteprima
az blueprint artifact policy

Comandi per gestire l'artefatto dell'assegnazione dei criteri di progetto.

 Estensione Disponibilità generale
az blueprint artifact policy create

Creare l'artefatto dei criteri del progetto.

 Estensione Disponibilità generale
az blueprint artifact policy update

Aggiornare l'artefatto dei criteri del progetto.

 Estensione Disponibilità generale
az blueprint artifact role

Comandi per gestire l'artefatto dell'assegnazione di ruolo del progetto.

 Estensione Disponibilità generale
az blueprint artifact role create

Creare l'artefatto del ruolo del progetto.

 Estensione Disponibilità generale
az blueprint artifact role update

Aggiornare l'artefatto del ruolo del progetto.

 Estensione Disponibilità generale
az blueprint artifact show

Ottenere un artefatto del progetto.

 Estensione Anteprima
az blueprint artifact template

Comandi per gestire l'artefatto del modello di Resource Manager del progetto.

 Estensione Disponibilità generale
az blueprint artifact template create

Creare un artefatto arm del progetto.

 Estensione Disponibilità generale
az blueprint artifact template update

Aggiornare l'artefatto arm del progetto.

 Estensione Disponibilità generale
az blueprint assignment

Comandi per gestire l'assegnazione del progetto.

 Estensione Disponibilità generale
az blueprint assignment create

Creare un'assegnazione di progetto.

 Estensione Disponibilità generale
az blueprint assignment delete

Eliminare un'assegnazione di progetto.

 Estensione Anteprima
az blueprint assignment list

Elencare le assegnazioni di progetto all'interno di una sottoscrizione.

 Estensione Anteprima
az blueprint assignment show

Ottenere un'assegnazione di progetto.

 Estensione Anteprima
az blueprint assignment update

Aggiornare un'assegnazione di progetto.

 Estensione Disponibilità generale
az blueprint assignment wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione dell'assegnazione del progetto.

 Estensione Disponibilità generale
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.Get Blueprint Servie Principal Name objectId.

 Estensione Anteprima
az blueprint create

Creare una definizione di progetto.

 Estensione Anteprima
az blueprint delete

Eliminare una definizione di progetto.

 Estensione Anteprima
az blueprint export

Esportare una definizione di progetto e gli artefatti in file JSON.

 Estensione Disponibilità generale
az blueprint import

Importare una definizione di progetto e gli artefatti da un directoy di file JSON.

 Estensione Disponibilità generale
az blueprint list

Elencare le definizioni di progetto.

 Estensione Anteprima
az blueprint publish

Pubblicare una nuova versione della definizione del progetto con gli elementi più recenti. Le definizioni di progetto pubblicate non sono modificabili.

 Estensione Anteprima
az blueprint resource-group

Comandi per gestire l'artefatto del gruppo di risorse del progetto.

 Estensione Disponibilità generale
az blueprint resource-group add

Aggiungere un elemento del gruppo di risorse al progetto.

 Estensione Disponibilità generale
az blueprint resource-group list

Elencare l'artefatto del gruppo di risorse del progetto.

 Estensione Disponibilità generale
az blueprint resource-group remove

Rimuovere un elemento del gruppo di risorse del progetto.

 Estensione Disponibilità generale
az blueprint resource-group show

Visualizzare l'artefatto del gruppo di risorse del progetto.

 Estensione Disponibilità generale
az blueprint resource-group update

Aggiornare l'artefatto del gruppo di risorse del progetto.

 Estensione Disponibilità generale
az blueprint show

Ottenere una definizione di progetto.

 Estensione Anteprima
az blueprint update

Aggiornare una definizione di progetto.

 Estensione Anteprima
az blueprint version

Comandi per gestire le versioni di progetto pubblicate.

 Estensione Anteprima
az blueprint version artifact

Comandi per gestire gli artefatti del progetto pubblicati.

 Estensione Anteprima
az blueprint version artifact list

Elencare gli artefatti per una versione di un progetto pubblicato.

 Estensione Anteprima
az blueprint version artifact show

Mostra un artefatto per un progetto pubblicato.

 Estensione Anteprima
az blueprint version delete

Eliminare una versione pubblicata di un progetto.

 Estensione Anteprima
az blueprint version list

Elencare le versioni pubblicate della definizione di progetto specificata.

 Estensione Anteprima
az blueprint version show

Ottenere una versione pubblicata di un progetto.

 Estensione Anteprima

az blueprint create

Anteprima

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

Creare una definizione di progetto.

az blueprint create --name
                    --target-scope {managementGroup, subscription}
                    [--description]
                    [--display-name]
                    [--management-group]
                    [--parameters]
                    [--resource-groups]
                    [--subscription]

Esempio

Creare un progetto di sottoscrizione

az blueprint create --subscription MySubscription --name MyBlueprint --description "blueprint contains all artifacts" --target-scope subscription

Creare un progetto di gruppo di gestione

az blueprint create --management-group MyManagementGroup --name MyBlueprint --description "blueprint contains all artifact" --target-scope subscription

Parametri necessari

--name -n

Nome della definizione del progetto.

--target-scope

Ambito in cui è possibile assegnare questa definizione di progetto.

valori accettati: managementGroup, subscription

Parametri facoltativi

--description

Spiegare in più righe questa risorsa.

--display-name

La stringa di una riga spiega questa risorsa.

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--parameters -p

Parametri richiesti da questa definizione di progetto. Può essere una stringa JSON o un percorso di file JSON. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--resource-groups

Segnaposto del gruppo di risorse definito da questa definizione di progetto. Valore previsto: json-string/@json-file. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint delete

Anteprima

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

Eliminare una definizione di progetto.

az blueprint delete --name
                    [--management-group]
                    [--subscription]
                    [--yes]

Esempio

Eliminare un progetto di gruppo di gestione

az blueprint delete --management-group MyManagementGroup --name MyBlueprint

Eliminare un progetto di sottoscrizione

az blueprint delete --subscription MySubscription --name MyBlueprint

Parametri necessari

--name -n

Nome della definizione del progetto.

Parametri facoltativi

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint export

Esportare una definizione di progetto e gli artefatti in file JSON.

az blueprint export --name
                    --output-path
                    [--management-group]
                    [--subscription]
                    [--yes]

Esempio

Esportare una definizione e artefatti del progetto

az blueprint export --name MyBlueprint \
--output-path "path/to/blueprint/directory"

Parametri necessari

--name -n

Nome della definizione del progetto da esportare.

--output-path

Percorso della directory per le definizioni JSON del progetto e degli artefatti. Il file di definizione del progetto sarà denominato blueprint.json. I file JSON degli artefatti si troveranno in una sottodirectory denominata artifacts.

Parametri facoltativi

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

--yes -y

Ignorare la conferma dell'utente. Se impostata, se la directory non esiste, verrà creata. Se la directory esiste e contiene contenuto, verranno sovrascritti. Se non è impostato, all'utente verrà richiesta l'autorizzazione per continuare.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint import

Importare una definizione di progetto e gli artefatti da un directoy di file JSON.

az blueprint import --input-path
                    --name
                    [--management-group]
                    [--subscription]
                    [--yes]

Esempio

Importare una definizione e artefatti di un progetto

az blueprint import --name MyBlueprint \
--input-path "path/to/blueprint/directory"

Parametri necessari

--input-path

Percorso della directory per le definizioni JSON del progetto e degli artefatti. Il file di definizione del progetto deve essere denominato blueprint.json. I file JSON degli artefatti devono trovarsi in una sottodirectory denominata artifacts.

--name -n

Nome della definizione del progetto.

Parametri facoltativi

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint list

Anteprima

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

Elencare le definizioni di progetto.

az blueprint list [--management-group]
                  [--max-items]
                  [--next-token]
                  [--subscription]

Esempio

Elencare i progetti in un gruppo di gestione

az blueprint list --management-group MyManagementGroup

Elencare i progetti in una sottoscrizione

az blueprint list --subscription MySubscription

Parametri facoltativi

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint publish

Anteprima

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

Pubblicare una nuova versione della definizione del progetto con gli elementi più recenti. Le definizioni di progetto pubblicate non sono modificabili.

az blueprint publish --blueprint-name
                     --version
                     [--change-notes]
                     [--management-group]
                     [--subscription]

Esempio

Pubblicare un progetto di gruppo di gestione

az blueprint publish --management-group MyManagementGroup --blueprint-name MyBlueprint --version v2

Pubblicare un progetto di sottoscrizione

az blueprint publish --subscription MySubscription --blueprint-name MyBlueprint --version v2

Parametri necessari

--blueprint-name

Nome della definizione del progetto.

--version

Versione della definizione del progetto pubblicata.

Parametri facoltativi

--change-notes

Note sulla modifica specifiche della versione.

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint show

Anteprima

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

Ottenere una definizione di progetto.

az blueprint show --name
                  [--management-group]
                  [--subscription]

Esempio

Visualizzare un progetto di gruppo di gestione

az blueprint show --management-group MyManagementGroup --name MyBlueprint

Visualizzare un progetto di sottoscrizione

az blueprint show --subscription MySubscription --name MyBlueprint

Parametri necessari

--name -n

Nome della definizione del progetto.

Parametri facoltativi

--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az blueprint update

Anteprima

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

Aggiornare una definizione di progetto.

az blueprint update --name
                    [--add]
                    [--description]
                    [--display-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--management-group]
                    [--parameters]
                    [--remove]
                    [--resource-groups]
                    [--set]
                    [--subscription]
                    [--target-scope {managementGroup, subscription}]

Parametri necessari

--name -n

Nome della definizione del progetto.

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, stringa o stringa> JSON.

--description

Spiegare in più righe questa risorsa.

--display-name

La stringa di una riga spiega questa risorsa.

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--management-group -m

Usare il gruppo di gestione per l'ambito del progetto.

--parameters -p

Parametri richiesti da questa definizione di progetto. Può essere una stringa JSON o un percorso di file JSON. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list OR --remove propertyToRemove.

--resource-groups

Segnaposto del gruppo di risorse definito da questa definizione di progetto. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

--subscription -s

Usare la sottoscrizione per l'ambito del progetto. Se --management-group non è specificato, il valore --subscription o la sottoscrizione predefinita verrà usata come ambito.

--target-scope

Ambito in cui è possibile assegnare questa definizione di progetto.

valori accettati: managementGroup, subscription
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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