az blueprint artifact role

Icke-bakåtkompatibel ändring

Note

Den här referensen är en del av tillägget blueprint för Azure CLI (version 2.50.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az blueprint artifact role kommando. Läs mer om tillägg.

Den här kommandogruppen är implicit inaktuell eftersom kommandogruppen az blueprint är inaktuell och tas bort i en framtida version. Azure Blueprints går i pension den 31 januari 2027, med stegvisa begränsningar från och med den 31 juli 2026. Efter pensioneringen slutar tjänst-API:et att svara och dessa kommandon slutar fungera. de tas bort från Azure CLI i en senare version. Migrera skissdefinitioner till mallspecifikationer och tilldelningar till Azure distributionsstackar (rekommenderas). Migreringsvägledning: https://aka.ms/AzureBlueprintsRetirement

Kommandon för att hantera skissrolltilldelningsartefakt.

Kommandon

Name	Description	Typ	Status
az blueprint artifact role create	Skapa en skissrollartefakt.	Extension	GA
az blueprint artifact role update	Uppdatera skissrollartefakten.	Extension	GA

az blueprint artifact role create

Icke-bakåtkompatibel ändring

Azure Blueprints går i pension den 31 januari 2027, med stegvisa begränsningar från och med den 31 juli 2026. Efter pensioneringen slutar tjänst-API:et att svara och dessa kommandon slutar fungera. de tas bort från Azure CLI i en senare version. Migrera skissdefinitioner till mallspecifikationer och tilldelningar till Azure distributionsstackar (rekommenderas). Migreringsvägledning: https://aka.ms/AzureBlueprintsRetirement Det här kommandot är implicit inaktuellt eftersom kommandogruppen "az blueprint" är inaktuell och kommer att tas bort i en framtida version.

Skapa en skissrollartefakt.

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]

Exempel

Skapa en rollartefakt

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

Obligatoriska parametrar

--artifact-name

Namnet på skissartefakten.

--blueprint-name

Namnet på skissdefinitionen.

--principal-ids

Matris med användar- eller gruppidentiteter i Azure Active Directory eller en referens till motsvarande parameter i skissdefiniton. RoleDefinition gäller för varje identitet.

--role-definition-id

Det fullständiga rolldefinitions-ID:t. Endast inbyggda roller stöds.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--depends-on

Artefakter som måste distribueras före den angivna artefakten.

--description

Beskrivning av skissartefakten.

--display-name

DisplayName för den här artefakten.

--management-group -m

Använd hanteringsgrupp för skissens omfattning.

Egenskap	Värde
Parametergrupp:	Resource_scope Arguments

--resource-group-art

Namnet på resursgruppens artefakt som principen ska tilldelas till.

--subscription -s

Använd prenumerationen för skissens omfattning. Om --management-group inte har angetts används --prenumerationsvärdet eller standardprenumerationen som omfång.

Egenskap	Värde
Parametergrupp:	Resource_scope Arguments

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az blueprint artifact role update