Sdílet prostřednictvím


az blueprint assignment

Note

Tento odkaz je součástí rozšíření blueprint pro Azure CLI (verze 2.50.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az blueprint assignment. Přečtěte si další informace o rozšířeních.

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tato skupina příkazů je implicitně zastaralá, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Příkazy pro správu přiřazení podrobného plánu

Příkazy

Name Description Typ Stav
az blueprint assignment create

Vytvořte přiřazení podrobného plánu.

Extension GA
az blueprint assignment delete

Odstranění přiřazení podrobného plánu

Extension Preview
az blueprint assignment list

Zobrazení seznamu přiřazení podrobných plánů v rámci předplatného

Extension Preview
az blueprint assignment show

Získejte přiřazení podrobného plánu.

Extension Preview
az blueprint assignment update

Aktualizace přiřazení podrobného plánu

Extension GA
az blueprint assignment wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka přiřazení podrobného plánu.

Extension GA
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.

Extension Preview

az blueprint assignment create

Změna způsobující chybu

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Vytvořte přiřazení podrobného plánu.

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]

Příklady

Přiřazení se spravovanou identitou přiřazenou systémem

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

Přiřazení se spravovanou identitou přiřazenou uživatelem

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

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--blueprint-version

ID prostředku publikované verze definice podrobného plánu

--description

Víceřádkové vysvětlení tohoto prostředku

--display-name

Řetězec s jednou vložkou vysvětluje tento prostředek.

--identity-type

Typ spravované identity

Vlastnost Hodnota
Skupina parametrů: Identity Arguments
Default value: SystemAssigned
Přípustné hodnoty: None, SystemAssigned, UserAssigned
--location -l

Location. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--locks-excluded-principals

Seznam objektů zabezpečení AAD vyloučených z zámků podrobného plánu Je povoleno až 5 objektů zabezpečení.

--locks-mode

Režim uzamčení

Vlastnost Hodnota
Přípustné hodnoty: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Použijte skupinu pro správu pro cílový rozsah přiřazení podrobného plánu. Je vyhrazená pro budoucí použití. Místo toho použijte --subscription.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--parameters -p

Hodnoty parametrů přiřazení podrobného plánu Může to být řetězec JSON nebo cesta k souboru JSON.

--resource-group-value

Key=Value pairs for a resource group. Mezi klíče patří artifact_name(povinné), name, location.

--subscription -s

Použijte předplatné pro cílový rozsah přiřazení podrobného plánu. Výchozí susbcription se použije, pokud není zadána možnost.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--user-assigned-identity

Spravovaná identita přiřazená uživatelem přidružená k prostředku.

Vlastnost Hodnota
Skupina parametrů: Identity Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment delete

Preview Změna způsobující chybu

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Odstranění přiřazení podrobného plánu

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

Příklady

Odstranění přiřazení

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

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--delete-behavior

Při odstraněníBehavior=all se odstraní prostředky vytvořené přiřazením podrobného plánu.

Vlastnost Hodnota
Přípustné hodnoty: all, none
--management-group -m

Pro rozsah podrobného plánu použijte skupinu pro správu.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--subscription -s

Použijte předplatné pro rozsah podrobného plánu. Pokud není zadán parametr --management-group, použije se jako obor hodnota --subscription nebo výchozí předplatné.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment list

Preview Změna způsobující chybu

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Zobrazení seznamu přiřazení podrobných plánů v rámci předplatného

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

Příklady

Výpis přiřazení

az blueprint assignment list --subscription MySubscription

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--management-group -m

Pro rozsah podrobného plánu použijte skupinu pro správu.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Pokud chcete pokračovat ve stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

Vlastnost Hodnota
Skupina parametrů: Pagination Arguments
--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

Vlastnost Hodnota
Skupina parametrů: Pagination Arguments
--subscription -s

Použijte předplatné pro rozsah podrobného plánu. Pokud není zadán parametr --management-group, použije se jako obor hodnota --subscription nebo výchozí předplatné.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment show

Preview Změna způsobující chybu

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Získejte přiřazení podrobného plánu.

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

Příklady

Zobrazení zadání

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

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--management-group -m

Pro rozsah podrobného plánu použijte skupinu pro správu.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--subscription -s

Použijte předplatné pro rozsah podrobného plánu. Pokud není zadán parametr --management-group, použije se jako obor hodnota --subscription nebo výchozí předplatné.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment update

Změna způsobující chybu

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Aktualizace přiřazení podrobného plánu

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]

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--blueprint-version

ID prostředku publikované verze definice podrobného plánu

--description

Víceřádkové vysvětlení tohoto prostředku

--display-name

Řetězec s jednou vložkou vysvětluje tento prostředek.

--identity-type

Typ spravované identity

Vlastnost Hodnota
Skupina parametrů: Identity Arguments
Přípustné hodnoty: None, SystemAssigned, UserAssigned
--location -l

Location. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--locks-excluded-principals

Seznam objektů zabezpečení AAD vyloučených z zámků podrobného plánu Je povoleno až 5 objektů zabezpečení.

--locks-mode

Režim uzamčení

Vlastnost Hodnota
Přípustné hodnoty: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Použijte skupinu pro správu pro cílový rozsah přiřazení podrobného plánu. Je vyhrazená pro budoucí použití. Místo toho použijte --subscription.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--parameters -p

Hodnoty parametrů přiřazení podrobného plánu Může to být řetězec JSON nebo cesta k souboru JSON.

--resource-group-value

Key=Value pairs for a resource group. Mezi klíče patří artifact_name(povinné), name, location.

--subscription -s

Použijte předplatné pro cílový rozsah přiřazení podrobného plánu. Výchozí susbcription se použije, pokud není zadána možnost.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--user-assigned-identity

Spravovaná identita přiřazená uživatelem přidružená k prostředku.

Vlastnost Hodnota
Skupina parametrů: Identity Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment wait

Změna způsobující chybu

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka přiřazení podrobného plánu.

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

Příklady

Pozastavte provádění dalšího řádku skriptu rozhraní příkazového řádku, dokud se přiřazení podrobného plánu úspěšně nezřídí.

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

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
--deleted

Počkejte na odstranění.

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: False
--exists

Počkejte, až prostředek existuje.

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: False
--interval

Interval dotazování v sekundách

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: 30
--management-group -m

Použijte skupinu pro správu pro cílový rozsah přiřazení podrobného plánu. Je vyhrazená pro budoucí použití. Místo toho použijte --subscription.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--subscription -s

Použijte předplatné pro cílový rozsah přiřazení podrobného plánu. Výchozí susbcription se použije, pokud není zadána možnost.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--timeout

Maximální čekání v sekundách.

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Vlastnost Hodnota
Skupina parametrů: Wait Condition Arguments
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az blueprint assignment who

Preview Změna způsobující chybu

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Podrobné plány a přidružené příkazy budou od července 2026 zastaralé. Zákazníkům se doporučuje přejít na Template Specs a Deployment Stacks, aby jejich scénáře byly podporovány i po tomto datu. Dokumentace k migraci je k dispozici na https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi.

Get Blueprint Servie Principal Name objectId.

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

Příklady

Získání SPN objectId

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

Povinné parametry

--name -n

Název přiřazení podrobného plánu

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--management-group -m

Pro rozsah podrobného plánu použijte skupinu pro správu.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--subscription -s

Použijte předplatné pro rozsah podrobného plánu. Pokud není zadán parametr --management-group, použije se jako obor hodnota --subscription nebo výchozí předplatné.

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False