Share via

az blueprint assignment

  • Reference

Poznámka

Tento odkaz je součástí rozšíření podrobného plánu 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.

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.

 Rozšíření GA
az blueprint assignment delete

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

 Rozšíření Preview
az blueprint assignment list

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

 Rozšíření Preview
az blueprint assignment show

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

 Rozšíření Preview
az blueprint assignment update

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

 Rozšíření 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.

 Rozšíření GA
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.

 Rozšíření Preview

az blueprint assignment create

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

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

přijímané hodnoty: None, SystemAssigned, UserAssigned
výchozí hodnota: SystemAssigned
--location -l

Umístění. 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í

přijímané 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.

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

--user-assigned-identity

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

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment delete

Preview

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

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

--delete-behavior

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

přijímané hodnoty: all, none
--management-group -m

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

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

--yes -y

Nezotvádejte výzvu k potvrzení.

výchozí hodnota: False
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment list

Preview

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

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

--management-group -m

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

--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. Chcete-li obnovit stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

--next-token

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

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

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment show

Preview

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

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

--management-group -m

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

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

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment update

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

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

přijímané hodnoty: None, SystemAssigned, UserAssigned
--location -l

Umístění. 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í

přijímané 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.

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

--user-assigned-identity

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

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

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.

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

--created

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

výchozí hodnota: False
--custom

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

--deleted

Počkejte na odstranění.

výchozí hodnota: False
--exists

Počkejte, až prostředek existuje.

výchozí hodnota: False
--interval

Interval dotazování v sekundách

výchozí hodnota: 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.

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

--timeout

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

výchozí hodnota: 3600
--updated

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

výchozí hodnota: False
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment who

Preview

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

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

--management-group -m

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

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

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

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

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

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