Dela via


az blueprint

Anmärkning

Den här referensen är en del av skissen-tillä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 kommando. Läs mer om tillägg.

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Den här kommandogruppen har blivit inaktuell och tas bort i nästa icke-bakåtkompatibla ändringsversion (2.79.0) som är planerad till nov 2025.

Kommandon för att hantera skiss.

Kommandon

Name Description Typ Status
az blueprint artifact

Kommandon för att hantera skissartefakt.

Förlängning Avrådes från användning
az blueprint artifact delete

Ta bort en skissartefakt.

Förlängning Förhandsversion och inaktuell
az blueprint artifact list

Lista artefakter för en viss skissdefinition.

Förlängning Förhandsversion och inaktuell
az blueprint artifact policy

Kommandon för att hantera skissprinciptilldelningsartefakt.

Förlängning Avrådes från användning
az blueprint artifact policy create

Skapa skissprincipartefakt.

Förlängning Avrådes från användning
az blueprint artifact policy update

Uppdatera skissprincipartefakt.

Förlängning Avrådes från användning
az blueprint artifact role

Kommandon för att hantera skissrolltilldelningsartefakt.

Förlängning Avrådes från användning
az blueprint artifact role create

Skapa en skissrollartefakt.

Förlängning Avrådes från användning
az blueprint artifact role update

Uppdatera skissrollartefakten.

Förlängning Avrådes från användning
az blueprint artifact show

Hämta en skissartefakt.

Förlängning Förhandsversion och inaktuell
az blueprint artifact template

Kommandon för att hantera arm-mallartefakt för skiss.

Förlängning Avrådes från användning
az blueprint artifact template create

Skapa skissarmens artefakt.

Förlängning Avrådes från användning
az blueprint artifact template update

Uppdatera skissarmens artefakt.

Förlängning Avrådes från användning
az blueprint assignment

Kommandon för att hantera skisstilldelning.

Förlängning Avrådes från användning
az blueprint assignment create

Skapa en skisstilldelning.

Förlängning Avrådes från användning
az blueprint assignment delete

Ta bort en skisstilldelning.

Förlängning Förhandsversion och inaktuell
az blueprint assignment list

Lista skisstilldelningar i en prenumeration.

Förlängning Förhandsversion och inaktuell
az blueprint assignment show

Hämta en skisstilldelning.

Förlängning Förhandsversion och inaktuell
az blueprint assignment update

Uppdatera en skisstilldelning.

Förlängning Avrådes från användning
az blueprint assignment wait

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

Förlängning Avrådes från användning
az blueprint assignment who

Hämta Blueprint Servie Principal Name objectId.

Förlängning Förhandsversion och inaktuell
az blueprint create

Skapa en skissdefinition.

Förlängning Förhandsversion och inaktuell
az blueprint delete

Ta bort en skissdefinition.

Förlängning Förhandsversion och inaktuell
az blueprint export

Exportera en skissdefinition och artefakter till json-filer.

Förlängning Avrådes från användning
az blueprint import

Importera en skissdefinition och artefakter från en directoy av json-filer.

Förlängning Avrådes från användning
az blueprint list

Lista skissdefinitioner.

Förlängning Förhandsversion och inaktuell
az blueprint publish

Publicera en ny version av skissdefinitionen med de senaste artefakterna. Publicerade skissdefinitioner är oföränderliga.

Förlängning Förhandsversion och inaktuell
az blueprint resource-group

Kommandon för att hantera skissresursgruppens artefakt.

Förlängning Avrådes från användning
az blueprint resource-group add

Lägg till en resursgruppsartefakt i skissen.

Förlängning Avrådes från användning
az blueprint resource-group list

Lista resursgruppartefakt för skiss.

Förlängning Avrådes från användning
az blueprint resource-group remove

Ta bort en skissresursgruppartefakt.

Förlängning Avrådes från användning
az blueprint resource-group show

Visa skissresursgruppens artefakt.

Förlängning Avrådes från användning
az blueprint resource-group update

Uppdatera skissresursgruppens artefakt.

Förlängning Avrådes från användning
az blueprint show

Hämta en skissdefinition.

Förlängning Förhandsversion och inaktuell
az blueprint update

Uppdatera en skissdefinition.

Förlängning Förhandsversion och inaktuell
az blueprint version

Kommandon för att hantera publicerade skissversioner.

Förlängning Förhandsversion och inaktuell
az blueprint version artifact

Kommandon för att hantera publicerade skissartefakter.

Förlängning Förhandsversion och inaktuell
az blueprint version artifact list

Lista artefakter för en version av en publicerad skiss.

Förlängning Förhandsversion och inaktuell
az blueprint version artifact show

Visa en artefakt för en publicerad skiss.

Förlängning Förhandsversion och inaktuell
az blueprint version delete

Ta bort en publicerad version av en skiss.

Förlängning Förhandsversion och inaktuell
az blueprint version list

Visa en lista över publicerade versioner av den angivna skissdefinitionen.

Förlängning Förhandsversion och inaktuell
az blueprint version show

Hämta en publicerad version av en skiss.

Förlängning Förhandsversion och inaktuell

az blueprint create

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Skapa en skissdefinition.

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

Exempel

Skapa en prenumerationsritning

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

Skapa en hanteringsgruppsritning

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

Obligatoriska parametrar

--name -n

Namnet på skissdefinitionen.

--target-scope

Omfånget där den här skissdefinitionen kan tilldelas.

Godkända värden: managementGroup, subscription

Valfria parametrar

--description

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

--display-name

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

--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--parameters -p

Parametrar som krävs av den här skissdefinitionen. Det kan vara en JSON-sträng eller JSON-filsökväg. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--resource-groups

Platshållare för resursgrupper som definieras av den här skissdefinitionen. Förväntat värde: json-string/@json-file. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

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

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint delete

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Ta bort en skissdefinition.

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

Exempel

Ta bort en skiss för hanteringsgrupp

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

Ta bort en prenumerationsritning

az blueprint delete --subscription MySubscription --name MyBlueprint

Obligatoriska parametrar

--name -n

Namnet på skissdefinitionen.

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.

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

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint export

Inaktuell

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Exportera en skissdefinition och artefakter till json-filer.

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

Exempel

Exportera en skissdefinition och artefakter

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

Obligatoriska parametrar

--name -n

Namnet på skissdefinitionen som ska exporteras.

--output-path

Katalogsökvägen för json-definitioner av skissen och artefakterna. Skissdefinitionsfilen får namnet blueprint.json. Artifacts json-filer finns i en underkatalog med namnet artifacts.

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.

--yes -y

Hoppa över användarbekräftelse. Om katalogen inte finns när den har angetts skapas den. Om katalogen finns och innehåller innehåll skrivs de över. Om den inte anges uppmanas användaren att fortsätta.

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.

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint import

Inaktuell

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Importera en skissdefinition och artefakter från en directoy av json-filer.

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

Exempel

Importera en skissdefinition och artefakter

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

Obligatoriska parametrar

--input-path

Katalogsökvägen för json-definitioner av skissen och artefakterna. Skissdefinitionsfilen ska ha namnet blueprint.json. Artifacts json-filer ska finnas i en underkatalog med namnet artifacts.

--name -n

Namnet på skissdefinitionen.

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.

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

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint list

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Lista skissdefinitioner.

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

Exempel

Lista skisser i en hanteringsgrupp

az blueprint list --management-group MyManagementGroup

Lista skisser i en prenumeration

az blueprint 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 argument 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.

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint publish

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Publicera en ny version av skissdefinitionen med de senaste artefakterna. Publicerade skissdefinitioner är oföränderliga.

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

Exempel

Publicera en skiss för hanteringsgrupp

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

Publicera en prenumerationsritning

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

Obligatoriska parametrar

--blueprint-name

Namnet på skissdefinitionen.

--version

Version av den publicerade skissdefinitionen.

Valfria parametrar

--change-notes

Versionsspecifika ändringsanteckningar.

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

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint show

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Hämta en skissdefinition.

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

Exempel

Visa en skiss för hanteringsgrupp

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

Visa en prenumerationsritning

az blueprint show --subscription MySubscription --name MyBlueprint

Obligatoriska parametrar

--name -n

Namnet på skissdefinitionen.

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.

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az blueprint update

Förhandsgranskning Inaktuell

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

Skisser och associerade kommandon kommer att vara inaktuella redan i juli 2026. Kunder uppmanas att övergå till mallspecifikationer och distributionsstackar för att stödja sina scenarier efter det datumet. Migreringsdokumentation finns på https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och tas bort i en framtida version.

Uppdatera en skissdefinition.

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}]

Obligatoriska parametrar

--name -n

Namnet på skissdefinitionen.

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

--description

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

--display-name

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

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--management-group -m

Använd hanteringsgrupp för skissens omfattning.

--parameters -p

Parametrar som krävs av den här skissdefinitionen. Det kan vara en JSON-sträng eller JSON-filsökväg. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

--resource-groups

Platshållare för resursgrupper som definieras av den här skissdefinitionen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

--subscription -s

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

--target-scope

Omfånget där den här skissdefinitionen kan tilldelas.

Godkända värden: managementGroup, subscription
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.

Godkända 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 prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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