Dela via


az blueprint assignment

Kommentar

Den här referensen är en del av skisstillägget för Azure CLI (version 2.50.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az blueprint-tilldelningskommando . Läs mer om tillägg.

Kommandon för att hantera skisstilldelning.

Kommandon

Name Description Typ Status
az blueprint assignment create

Skapa en skisstilldelning.

Anknytning Allmän tillgänglighet
az blueprint assignment delete

Ta bort en skisstilldelning.

Anknytning Förhandsgranska
az blueprint assignment list

Lista skisstilldelningar i en prenumeration.

Anknytning Förhandsgranska
az blueprint assignment show

Hämta en skisstilldelning.

Anknytning Förhandsgranska
az blueprint assignment update

Uppdatera en skisstilldelning.

Anknytning Allmän tillgänglighet
az blueprint assignment wait

Placera CLI i vänteläge tills ett villkor för skisstilldelningen har uppfyllts.

Anknytning Allmän tillgänglighet
az blueprint assignment who

Hämta Blueprint Servie Principal Name objectId.

Anknytning Förhandsgranska

az blueprint assignment create

Skapa en skisstilldelning.

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]

Exempel

Tilldelning med systemtilldelad hanterad identitet

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" \

Tilldelning med användartilldelad hanterad identitet

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" \

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--blueprint-version

Resurs-ID för den publicerade versionen av en skissdefinition.

--description

Förklara den här resursen med flera rader.

--display-name

Enradssträng förklarar den här resursen.

--identity-type

Typ av hanterad identitet.

accepterade värden: None, SystemAssigned, UserAssigned
standardvärde: SystemAssigned
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--locks-excluded-principals

Lista över AAD-huvudnamn som undantas från skisslås. Upp till 5 huvudkonton är tillåtna.

--locks-mode

Låsläge.

accepterade värden: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Använd hanteringsgrupp för skisstilldelningens målomfång. Den är reserverad för framtida användning. Använd --subscription i stället.

--parameters -p

Parametervärden för skisstilldelning. Det kan vara en JSON-sträng eller JSON-filsökväg.

--resource-group-value

Key=Value pairs för en resursgrupp. Nycklarna inkluderar "artifact_name" (krävs), "namn", "plats".

--subscription -s

Använd prenumerationen för skisstilldelningens målomfång. Standard-susbcription används om alternativet inte anges.

--user-assigned-identity

Den användartilldelade hanterade identiteten som är associerad med resursen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment delete

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en skisstilldelning.

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

Exempel

Ta bort en tilldelning

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

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--delete-behavior

När deleteBehavior=all tas de resurser som skapades av skisstilldelningen bort.

accepterade värden: all, none
--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--subscription -s

Använd prenumerationen för skissens omfattning. Om --management-group inte har angetts används --prenumerationsvärdet eller standardprenumerationen som omfång.

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment list

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Lista skisstilldelningar i en prenumeration.

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

Exempel

Lista tilldelningar

az blueprint assignment list --subscription MySubscription

Valfria parametrar

--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argumentet för ett efterföljande kommando.

--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

--subscription -s

Använd prenumerationen för skissens omfattning. Om --management-group inte har angetts används --prenumerationsvärdet eller standardprenumerationen som omfång.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment show

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta en skisstilldelning.

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

Exempel

Visa en tilldelning

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

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--subscription -s

Använd prenumerationen för skissens omfattning. Om --management-group inte har angetts används --prenumerationsvärdet eller standardprenumerationen som omfång.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment update

Uppdatera en skisstilldelning.

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]

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--blueprint-version

Resurs-ID för den publicerade versionen av en skissdefinition.

--description

Förklara den här resursen med flera rader.

--display-name

Enradssträng förklarar den här resursen.

--identity-type

Typ av hanterad identitet.

accepterade värden: None, SystemAssigned, UserAssigned
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--locks-excluded-principals

Lista över AAD-huvudnamn som undantas från skisslås. Upp till 5 huvudkonton är tillåtna.

--locks-mode

Låsläge.

accepterade värden: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Använd hanteringsgrupp för skisstilldelningens målomfång. Den är reserverad för framtida användning. Använd --subscription i stället.

--parameters -p

Parametervärden för skisstilldelning. Det kan vara en JSON-sträng eller JSON-filsökväg.

--resource-group-value

Key=Value pairs för en resursgrupp. Nycklarna inkluderar "artifact_name" (krävs), "namn", "plats".

--subscription -s

Använd prenumerationen för skisstilldelningens målomfång. Standard-susbcription används om alternativet inte anges.

--user-assigned-identity

Den användartilldelade hanterade identiteten som är associerad med resursen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment wait

Placera CLI i vänteläge tills ett villkor för skisstilldelningen har uppfyllts.

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

Exempel

Pausa körningen av nästa rad i CLI-skriptet tills skisstilldelningen har etablerats.

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

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--management-group -m

Använd hanteringsgrupp för skisstilldelningens målomfång. Den är reserverad för framtida användning. Använd --subscription i stället.

--subscription -s

Använd prenumerationen för skisstilldelningens målomfång. Standard-susbcription används om alternativet inte anges.

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az blueprint assignment who

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta Blueprint Servie Principal Name objectId.

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

Exempel

Hämta SPN objectId

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

Obligatoriska parametrar

--name -n

Namnet på skisstilldelningen.

Valfria parametrar

--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--subscription -s

Använd prenumerationen för skissens omfattning. Om --management-group inte har angetts används --prenumerationsvärdet eller standardprenumerationen som omfång.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.