Delen via

az blueprint assignment

  • Referentie

Notitie

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

Opdrachten voor het beheren van blauwdruktoewijzing.

Opdracht

Name Description Type Status
az blueprint assignment create

Maak een blauwdruktoewijzing.

 Toestel GA
az blueprint assignment delete

Een blauwdruktoewijzing verwijderen.

 Toestel Preview uitvoeren
az blueprint assignment list

Blauwdruktoewijzingen in een abonnement weergeven.

 Toestel Preview uitvoeren
az blueprint assignment show

Haal een blauwdruktoewijzing op.

 Toestel Preview uitvoeren
az blueprint assignment update

Werk een blauwdruktoewijzing bij.

 Toestel GA
az blueprint assignment wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de blauwdruktoewijzing wordt voldaan.

 Toestel GA
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.

 Toestel Preview uitvoeren

az blueprint assignment create

Maak een blauwdruktoewijzing.

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]

Voorbeelden

Toewijzing met door het systeem toegewezen beheerde identiteit

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

Toewijzing met door de gebruiker toegewezen beheerde identiteit

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

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--blueprint-version

Resource-id van de gepubliceerde versie van een blauwdrukdefinitie.

--description

In meerdere regels wordt deze resource uitgelegd.

--display-name

In een-linertekenreeks wordt deze resource uitgelegd.

--identity-type

Type van de beheerde identiteit.

geaccepteerde waarden: None, SystemAssigned, UserAssigned
standaardwaarde: SystemAssigned
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--locks-excluded-principals

Lijst met AAD-principals die zijn uitgesloten van blauwdrukvergrendelingen. Maximaal 5 principals zijn toegestaan.

--locks-mode

Vergrendelingsmodus.

geaccepteerde waarden: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Gebruik beheergroep voor het doelbereik van de blauwdruktoewijzing. Het is gereserveerd voor toekomstig gebruik. Gebruik in plaats daarvan --subscription.

--parameters -p

Parameterwaarden voor blauwdruktoewijzing. Dit kan een JSON-tekenreeks of JSON-bestandspad zijn.

--resource-group-value

Sleutel=waardeparen voor een resourcegroep. Sleutels bevatten 'artifact_name' (vereist), 'naam', 'locatie'.

--subscription -s

Gebruik een abonnement voor het doelbereik van de blauwdruktoewijzing. Standaard-susbcription wordt gebruikt als de optie niet is opgegeven.

--user-assigned-identity

De door de gebruiker toegewezen beheerde identiteit die is gekoppeld aan de resource.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment delete

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een blauwdruktoewijzing verwijderen.

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Voorbeelden

Een toewijzing verwijderen

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--delete-behavior

Wanneer deleteBehavior=all, worden de resources die door de blauwdruktoewijzing zijn gemaakt, verwijderd.

geaccepteerde waarden: all, none
--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

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

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment list

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Blauwdruktoewijzingen in een abonnement weergeven.

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

Voorbeelden

Toewijzingen weergeven

az blueprint assignment list --subscription MySubscription

Optionele parameters

--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

--max-items

Totaal aantal items dat moet worden geretourneerd in de uitvoer van de opdracht. Als het totale aantal beschikbare items groter is dan de opgegeven waarde, wordt een token opgegeven in de uitvoer van de opdracht. Als u paginering wilt hervatten, geeft u de tokenwaarde op in --next-token het argument van een volgende opdracht.

--next-token

Token om op te geven waar paginering moet worden gestart. Dit is de tokenwaarde van een eerder afgekapt antwoord.

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

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment show

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Haal een blauwdruktoewijzing op.

az blueprint assignment show --name
                             [--management-group]
                             [--subscription]

Voorbeelden

Een opdracht weergeven

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

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

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment update

Werk een blauwdruktoewijzing bij.

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]

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--blueprint-version

Resource-id van de gepubliceerde versie van een blauwdrukdefinitie.

--description

In meerdere regels wordt deze resource uitgelegd.

--display-name

In een-linertekenreeks wordt deze resource uitgelegd.

--identity-type

Type van de beheerde identiteit.

geaccepteerde waarden: None, SystemAssigned, UserAssigned
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--locks-excluded-principals

Lijst met AAD-principals die zijn uitgesloten van blauwdrukvergrendelingen. Maximaal 5 principals zijn toegestaan.

--locks-mode

Vergrendelingsmodus.

geaccepteerde waarden: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Gebruik beheergroep voor het doelbereik van de blauwdruktoewijzing. Het is gereserveerd voor toekomstig gebruik. Gebruik in plaats daarvan --subscription.

--parameters -p

Parameterwaarden voor blauwdruktoewijzing. Dit kan een JSON-tekenreeks of JSON-bestandspad zijn.

--resource-group-value

Sleutel=waardeparen voor een resourcegroep. Sleutels bevatten 'artifact_name' (vereist), 'naam', 'locatie'.

--subscription -s

Gebruik een abonnement voor het doelbereik van de blauwdruktoewijzing. Standaard-susbcription wordt gebruikt als de optie niet is opgegeven.

--user-assigned-identity

De door de gebruiker toegewezen beheerde identiteit die is gekoppeld aan de resource.

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de blauwdruktoewijzing wordt voldaan.

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Voorbeelden

Pauzeer het uitvoeren van de volgende regel van het CLI-script totdat de blauwdruktoewijzing is ingericht.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

standaardwaarde: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

standaardwaarde: False
--exists

Wacht tot de resource bestaat.

standaardwaarde: False
--interval

Polling-interval in seconden.

standaardwaarde: 30
--management-group -m

Gebruik beheergroep voor het doelbereik van de blauwdruktoewijzing. Het is gereserveerd voor toekomstig gebruik. Gebruik in plaats daarvan --subscription.

--subscription -s

Gebruik een abonnement voor het doelbereik van de blauwdruktoewijzing. Standaard-susbcription wordt gebruikt als de optie niet is opgegeven.

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

standaardwaarde: False
Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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

az blueprint assignment who

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Get Blueprint Servie Principal Name objectId.

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

Voorbeelden

SPN-object-id ophalen

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

Vereiste parameters

--name -n

Naam van de blauwdruktoewijzing.

Optionele parameters

--management-group -m

Gebruik beheergroep voor het bereik van de blauwdruk.

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

Globale parameters
--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

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

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

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