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.