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

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

az blueprint

Comandi

az blueprint create

Esempio

Parametri necessari

Parametri facoltativi

az blueprint delete

Esempio

Parametri necessari

Parametri facoltativi

az blueprint export

Esempio

Parametri necessari

Parametri facoltativi

az blueprint import

Esempio

Parametri necessari

Parametri facoltativi

az blueprint list

Esempio

Parametri facoltativi

az blueprint publish

Esempio

Parametri necessari

Parametri facoltativi

az blueprint show

Esempio

Parametri necessari

Parametri facoltativi

az blueprint update

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti

Risorse aggiuntive