az blueprint artifact role

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 artifact role. Přečtěte si další informace o rozšířeních.

Tato skupina příkazů je implicitně zastaralá, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi. 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.

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

Příkazy

Name Description Typ Stav
az blueprint artifact role create

Vytvoření artefaktu role podrobného plánu

Extension GA
az blueprint artifact role update

Aktualizace artefaktu role podrobného plánu

Extension GA

az blueprint artifact role create

Změna způsobující chybu

Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi. 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.

Vytvoření artefaktu role podrobného plánu

az blueprint artifact role create --artifact-name
                                  --blueprint-name
                                  --principal-ids
                                  --role-definition-id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Příklady

Vytvoření artefaktu role

az blueprint artifact role create \
--blueprint-name MyBlueprint --artifact-name MyRole --role-definition-id \
"/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000" \
--principal-ids "[parameters('[Usergrouporapplicationname]:MyRoleAssignmentName')]"

Povinné parametry

--artifact-name

Název artefaktu podrobného plánu

--blueprint-name

Název definice podrobného plánu

--principal-ids

Pole identit uživatelů nebo skupin v Azure Active Directory nebo odkaz na odpovídající parametr v definitonu podrobného plánu Definice role se použije pro každou identitu.

--role-definition-id

Úplné ID definice role. Podporují se jenom předdefinované role.

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.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--depends-on

Artefakty, které je potřeba nasadit před zadaným artefaktem.

--description

Popis artefaktu podrobného plánu

--display-name

DisplayName tohoto artefaktu.

--management-group -m

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

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--resource-group-art

Název artefaktu skupiny prostředků, ke kterému se zásada přiřadí.

--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 artifact role update

Změna způsobující chybu

Tento příkaz je implicitně zastaralý, protože skupina příkazů az blueprint je zastaralá a bude odebrána v budoucí verzi. 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.

Aktualizace artefaktu role podrobného plánu

az blueprint artifact role update --artifact-name
                                  --blueprint-name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Příklady

Aktualizace artefaktu role

az blueprint artifact role update \
--blueprint-name MyBlueprint --artifact-name MyRole --display-name "My Big Role"

Povinné parametry

--artifact-name

Název artefaktu podrobného plánu

--blueprint-name

Název definice 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.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--depends-on

Artefakty, které je potřeba nasadit před zadaným artefaktem. K odebrání závislostí použijte --depends-on bez hodnot.

--description

Popis artefaktu podrobného plánu

--display-name

DisplayName tohoto artefaktu.

--management-group -m

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

Vlastnost Hodnota
Skupina parametrů: Resource_scope Arguments
--resource-group-art

Název artefaktu skupiny prostředků, ke kterému se zásada přiřadí.

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