az blueprint artifact role

Note

Deze verwijzing maakt deel uit van de extensie blueprint voor de Azure CLI (versie 2.50.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az blueprint artifact role opdracht uitvoert. Meer informatie over uitbreidingen.

Deze opdrachtgroep is impliciet afgeschaft omdat opdrachtgroep 'az blueprint' is afgeschaft en in een toekomstige release wordt verwijderd. Azure Blueprints op 31 januari 2027 buiten gebruik wordt gesteld, met gefaseerde beperkingen vanaf 31 juli 2026. Na buitengebruikstelling reageert de service-API niet meer en werken deze opdrachten niet meer; ze worden in een latere release uit de Azure CLI verwijderd. Blueprint-definities migreren naar Template Specs en toewijzingen migreren naar Azure Deployment Stacks (aanbevolen). Migratierichtlijnen: https://aka.ms/AzureBlueprintsRetirement

Opdrachten voor het beheren van artefact voor blauwdrukroltoewijzing.

Opdracht

Name Description Type Status
az blueprint artifact role create

Blauwdrukrolartefact maken.

Extension GA
az blueprint artifact role update

Blauwdrukrolartefact bijwerken.

Extension GA

az blueprint artifact role create

Wijziging die fouten veroorzaken

Azure Blueprints op 31 januari 2027 buiten gebruik wordt gesteld, met gefaseerde beperkingen vanaf 31 juli 2026. Na buitengebruikstelling reageert de service-API niet meer en werken deze opdrachten niet meer; ze worden in een latere release uit de Azure CLI verwijderd. Blueprint-definities migreren naar Template Specs en toewijzingen migreren naar Azure Deployment Stacks (aanbevolen). Migratierichtlijnen: https://aka.ms/AzureBlueprintsRetirement deze opdracht is impliciet afgeschaft omdat opdrachtgroep az blueprint is afgeschaft en in een toekomstige release wordt verwijderd.

Blauwdrukrolartefact maken.

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]

Voorbeelden

Een rolartefact maken

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

Vereiste parameters

--artifact-name

Naam van het blauwdrukartefact.

--blueprint-name

Naam van de blauwdrukdefinitie.

--principal-ids

Matrix van gebruikers- of groepsidentiteiten in Azure Active Directory of een verwijzing naar de bijbehorende parameter in blauwdrukdefiniton. De roleDefinition is van toepassing op elke identiteit.

--role-definition-id

De id van de volledige roldefinitie. Alleen ingebouwde rollen worden ondersteund.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--depends-on

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd.

--description

Beschrijving van het blauwdrukartefact.

--display-name

DisplayName van dit artefact.

--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

Eigenschap Waarde
Parametergroep: Resource_scope Arguments
--resource-group-art

Naam van het artefact van de resourcegroep waaraan het beleid wordt toegewezen.

--subscription -s

Gebruik een abonnement voor het bereik van de blauwdruk. Als --management-group niet is opgegeven, --subscription value of het standaardabonnement wordt gebruikt als het bereik.

Eigenschap Waarde
Parametergroep: Resource_scope Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az blueprint artifact role update

Wijziging die fouten veroorzaken

Azure Blueprints op 31 januari 2027 buiten gebruik wordt gesteld, met gefaseerde beperkingen vanaf 31 juli 2026. Na buitengebruikstelling reageert de service-API niet meer en werken deze opdrachten niet meer; ze worden in een latere release uit de Azure CLI verwijderd. Blueprint-definities migreren naar Template Specs en toewijzingen migreren naar Azure Deployment Stacks (aanbevolen). Migratierichtlijnen: https://aka.ms/AzureBlueprintsRetirement deze opdracht is impliciet afgeschaft omdat opdrachtgroep az blueprint is afgeschaft en in een toekomstige release wordt verwijderd.

Blauwdrukrolartefact bijwerken.

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]

Voorbeelden

Een rolartefact bijwerken

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

Vereiste parameters

--artifact-name

Naam van het blauwdrukartefact.

--blueprint-name

Naam van de blauwdrukdefinitie.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--depends-on

Artefacten die vóór het opgegeven artefact moeten worden geïmplementeerd. Gebruik '--depends-on' zonder waarden om afhankelijkheden te verwijderen.

--description

Beschrijving van het blauwdrukartefact.

--display-name

DisplayName van dit artefact.

--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

Eigenschap Waarde
Parametergroep: Resource_scope Arguments
--resource-group-art

Naam van het artefact van de resourcegroep waaraan het beleid wordt toegewezen.

--subscription -s

Gebruik een abonnement voor het bereik van de blauwdruk. Als --management-group niet is opgegeven, --subscription value of het standaardabonnement wordt gebruikt als het bereik.

Eigenschap Waarde
Parametergroep: Resource_scope Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False