Udostępnij przez


az blueprint artifact role

Note

Ta dokumentacja jest częścią rozszerzenia strategii dla interfejsu wiersza polecenia platformy Azure (wersja 2.50.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu az blueprint artifact role polecenia. Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest niejawnie przestarzała, ponieważ grupa poleceń "az blueprint" jest przestarzała i zostanie usunięta w przyszłej wersji. Strategie i skojarzone polecenia zostaną wycofane już w lipcu 2026 r. Zachęcamy klientów do przejścia do szablonów specyfikacji i stosów wdrożeń, aby obsługiwać swoje scenariusze poza tą datą. Dokumentacja migracji jest dostępna pod https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Polecenia do zarządzania artefaktem przypisania roli strategii.

Polecenia

Nazwa Opis Typ Stan
az blueprint artifact role create

Utwórz artefakt roli strategii.

Extension ogólna dostępność
az blueprint artifact role update

Aktualizowanie artefaktu roli strategii.

Extension ogólna dostępność

az blueprint artifact role create

Przełamywanie zmian

To polecenie jest niejawnie przestarzałe, ponieważ grupa poleceń "az blueprint" jest przestarzała i zostanie usunięta w przyszłej wersji. Strategie i skojarzone polecenia zostaną wycofane już w lipcu 2026 r. Zachęcamy klientów do przejścia do szablonów specyfikacji i stosów wdrożeń, aby obsługiwać swoje scenariusze poza tą datą. Dokumentacja migracji jest dostępna pod https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Utwórz artefakt roli strategii.

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

Przykłady

Tworzenie artefaktu roli

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')]"

Wymagane parametry

--artifact-name

Nazwa artefaktu strategii.

--blueprint-name

Nazwa definicji strategii.

--principal-ids

Tablica tożsamości użytkowników lub grup w usłudze Azure Active Directory lub odwołanie do odpowiedniego parametru w definiton strategii. Definicja roli będzie stosowana do każdej tożsamości.

--role-definition-id

Pełny identyfikator definicji roli. Obsługiwane są tylko wbudowane role.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--depends-on

Artefakty, które należy wdrożyć przed określonym artefaktem.

--description

Opis artefaktu strategii.

--display-name

DisplayName tego artefaktu.

--management-group -m

Użyj grupy zarządzania dla zakresu strategii.

Własność Wartość
Grupa parametrów: Resource_scope Arguments
--resource-group-art

Nazwa artefaktu grupy zasobów, do którego zostaną przypisane zasady.

--subscription -s

Użyj subskrypcji dla zakresu strategii. Jeśli parametr --management-group nie zostanie określony, jako zakres zostanie użyta wartość --subscription lub domyślna subskrypcja.

Własność Wartość
Grupa parametrów: Resource_scope Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność Wartość
Wartość domyślna: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność Wartość
Wartość domyślna: False

az blueprint artifact role update

Przełamywanie zmian

To polecenie jest niejawnie przestarzałe, ponieważ grupa poleceń "az blueprint" jest przestarzała i zostanie usunięta w przyszłej wersji. Strategie i skojarzone polecenia zostaną wycofane już w lipcu 2026 r. Zachęcamy klientów do przejścia do szablonów specyfikacji i stosów wdrożeń, aby obsługiwać swoje scenariusze poza tą datą. Dokumentacja migracji jest dostępna pod https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Aktualizowanie artefaktu roli strategii.

az blueprint artifact role update --artifact-name
                                  --blueprint-name
                                  [--depends-on]
                                  [--description]
                                  [--display-name]
                                  [--management-group]
                                  [--resource-group-art]
                                  [--subscription]

Przykłady

Aktualizowanie artefaktu roli

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

Wymagane parametry

--artifact-name

Nazwa artefaktu strategii.

--blueprint-name

Nazwa definicji strategii.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu, jeden lub więcej może być potrzebnych do pomyślnego wykonania polecenia.

--depends-on

Artefakty, które należy wdrożyć przed określonym artefaktem. Użyj polecenia "--depends-on" bez wartości, aby usunąć zależności.

--description

Opis artefaktu strategii.

--display-name

DisplayName tego artefaktu.

--management-group -m

Użyj grupy zarządzania dla zakresu strategii.

Własność Wartość
Grupa parametrów: Resource_scope Arguments
--resource-group-art

Nazwa artefaktu grupy zasobów, do którego zostaną przypisane zasady.

--subscription -s

Użyj subskrypcji dla zakresu strategii. Jeśli parametr --management-group nie zostanie określony, jako zakres zostanie użyta wartość --subscription lub domyślna subskrypcja.

Własność Wartość
Grupa parametrów: Resource_scope Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Własność Wartość
Wartość domyślna: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Własność Wartość
Wartość domyślna: False
--output -o

Format danych wyjściowych.

Własność Wartość
Wartość domyślna: json
Akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Własność Wartość
Wartość domyślna: False