az blueprint assignment

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

Comandi per gestire l'assegnazione del progetto.

Comandi

Nome Descrizione Tipo Stato
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 assignment create

Creare un'assegnazione di progetto.

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Esempio

Assegnazione con identità gestita assegnata dal sistema

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

Assegnazione con identità gestita assegnata dall'utente

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

Parametri necessari

--name -n

Nome dell'assegnazione del progetto.

Parametri facoltativi

--blueprint-version

ID risorsa della versione pubblicata di una definizione di progetto.

--description

Spiegare in più righe questa risorsa.

--display-name

La stringa di una riga spiega questa risorsa.

--identity-type

Tipo dell'identità gestita.

valori accettati: None, SystemAssigned, UserAssigned
valore predefinito: SystemAssigned
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--locks-excluded-principals

Elenco delle entità AAD escluse dai blocchi del progetto. Sono consentite fino a 5 entità.

--locks-mode

Modalità di blocco.

valori accettati: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Usare il gruppo di gestione per l'ambito di destinazione dell'assegnazione del progetto. È riservato per un uso futuro. Usare invece --subscription.

--parameters -p

Valori dei parametri di assegnazione del progetto. Può essere una stringa JSON o un percorso di file JSON.

--resource-group-value

Coppie chiave=valore per un gruppo di risorse. Le chiavi includono 'artifact_name'(obbligatorio), 'name', 'location'.

--subscription -s

Usare la sottoscrizione per l'ambito di destinazione dell'assegnazione del progetto. Se l'opzione non è specificata, verrà usata la susbcription predefinita.

--user-assigned-identity

Identità gestita assegnata dall'utente associata alla risorsa.

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 assignment delete

Anteprima

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

Eliminare un'assegnazione di progetto.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Esempio

Eliminare un'assegnazione

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

Parametri necessari

--name -n

Nome dell'assegnazione del progetto.

Parametri facoltativi

--delete-behavior

Quando deleteBehavior=all, le risorse create dall'assegnazione del progetto verranno eliminate.

valori accettati: all, none
--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 assignment list

Anteprima

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

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

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

Esempio

Elencare le assegnazioni

az blueprint assignment 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 assignment show

Anteprima

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

Ottenere un'assegnazione di progetto.

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

Esempio

Mostra un'assegnazione

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

Parametri necessari

--name -n

Nome dell'assegnazione 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 assignment update

Aggiornare un'assegnazione di progetto.

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

Parametri necessari

--name -n

Nome dell'assegnazione del progetto.

Parametri facoltativi

--blueprint-version

ID risorsa della versione pubblicata di una definizione di progetto.

--description

Spiegare in più righe questa risorsa.

--display-name

La stringa di una riga spiega questa risorsa.

--identity-type

Tipo dell'identità gestita.

valori accettati: None, SystemAssigned, UserAssigned
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--locks-excluded-principals

Elenco delle entità AAD escluse dai blocchi del progetto. Sono consentite fino a 5 entità.

--locks-mode

Modalità di blocco.

valori accettati: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Usare il gruppo di gestione per l'ambito di destinazione dell'assegnazione del progetto. È riservato per un uso futuro. Usare invece --subscription.

--parameters -p

Valori dei parametri di assegnazione del progetto. Può essere una stringa JSON o un percorso di file JSON.

--resource-group-value

Coppie chiave=valore per un gruppo di risorse. Le chiavi includono 'artifact_name'(obbligatorio), 'name', 'location'.

--subscription -s

Usare la sottoscrizione per l'ambito di destinazione dell'assegnazione del progetto. Se l'opzione non è specificata, verrà usata la susbcription predefinita.

--user-assigned-identity

Identità gestita assegnata dall'utente associata alla risorsa.

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

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Esempio

Sospendere l'esecuzione della riga di comando successiva dello script dell'interfaccia della riga di comando fino a quando non viene eseguito correttamente il provisioning dell'assegnazione del progetto.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Parametri necessari

--name -n

Nome dell'assegnazione del progetto.

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--exists

Attendere che la risorsa esista.

valore predefinito: False
--interval

Intervallo di polling in secondi.

valore predefinito: 30
--management-group -m

Usare il gruppo di gestione per l'ambito di destinazione dell'assegnazione del progetto. È riservato per un uso futuro. Usare invece --subscription.

--subscription -s

Usare la sottoscrizione per l'ambito di destinazione dell'assegnazione del progetto. Se l'opzione non è specificata, verrà usata la susbcription predefinita.

--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

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 assignment who

Anteprima

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

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

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

Esempio

Get SPN objectId

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

Parametri necessari

--name -n

Nome dell'assegnazione 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.