Partager via

az blueprint assignment

  • Changement cassant

Note

Cette référence fait partie de l’extension blueprint pour Azure CLI (version 2.50.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az blueprint assignment commande. Apprenez-en davantage sur les extensions.

Ce groupe de commandes est implicitement déconseillé, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Commandes pour gérer l’affectation de blueprint.

Commandes

Nom Description Type État
az blueprint assignment create

Créez une affectation de blueprint.

 Extension GA
az blueprint assignment delete

Supprimez une affectation de blueprint.

 Extension Preview
az blueprint assignment list

Répertorier les affectations de blueprint dans un abonnement.

 Extension Preview
az blueprint assignment show

Obtenir une affectation de blueprint.

 Extension Preview
az blueprint assignment update

Mettez à jour une affectation de blueprint.

 Extension GA
az blueprint assignment wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’affectation de blueprint soit remplie.

 Extension GA
az blueprint assignment who

Get Blueprint Servie Principal Name objectId.

 Extension Preview

az blueprint assignment create

Changement cassant

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Créez une affectation de blueprint.

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]

Exemples

Affectation avec l’identité managée affectée par le système

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

Affectation avec une identité managée affectée par l’utilisateur

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

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--blueprint-version

ID de ressource de la version publiée d’une définition de blueprint.

--description

Les lignes multiples expliquent cette ressource.

--display-name

La chaîne d’un liner explique cette ressource.

--identity-type

Type de l’identité managée.

Propriété Valeur
Groupe de paramètres: Identity Arguments
Valeur par défaut: SystemAssigned
Valeurs acceptées: None, SystemAssigned, UserAssigned
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--locks-excluded-principals

Liste des principaux AAD exclus des verrous de blueprint. Jusqu’à 5 principaux sont autorisés.

--locks-mode

Mode de verrouillage.

Propriété Valeur
Valeurs acceptées: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Utilisez le groupe d’administration pour l’étendue cible de l’affectation de blueprint. Elle est réservée à une utilisation future. Utilisez plutôt --subscription.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--parameters -p

Valeurs des paramètres d’affectation de blueprint. Il peut s’agir d’une chaîne JSON ou d’un chemin de fichier JSON.

--resource-group-value

Paires Clé=Valeur pour un groupe de ressources. Les clés incluent « artifact_name » (obligatoire), « name », « location ».

--subscription -s

Utilisez l’abonnement pour l’étendue cible de l’affectation de blueprint. La susbcription par défaut est utilisée si l’option n’est pas spécifiée.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--user-assigned-identity

Identité managée affectée par l’utilisateur associée à la ressource.

Propriété Valeur
Groupe de paramètres: Identity Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment delete

Préversion Changement cassant

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Supprimez une affectation de blueprint.

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

Exemples

Supprimer une affectation

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

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--delete-behavior

Lorsque deleteBehavior=all, les ressources créées par l’affectation de blueprint sont supprimées.

Propriété Valeur
Valeurs acceptées: all, none
--management-group -m

Utilisez le groupe d’administration pour l’étendue du blueprint.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--subscription -s

Utilisez l’abonnement pour l’étendue du blueprint. Si --management-group n’est pas spécifié, la valeur --subscription ou l’abonnement par défaut sera utilisé comme étendue.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment list

Préversion Changement cassant

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Répertorier les affectations de blueprint dans un abonnement.

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

Exemples

Répertorier les affectations

az blueprint assignment list --subscription MySubscription

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--management-group -m

Utilisez le groupe d’administration pour l’étendue du blueprint.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--subscription -s

Utilisez l’abonnement pour l’étendue du blueprint. Si --management-group n’est pas spécifié, la valeur --subscription ou l’abonnement par défaut sera utilisé comme étendue.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment show

Préversion Changement cassant

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Obtenir une affectation de blueprint.

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

Exemples

Afficher une affectation

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

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--management-group -m

Utilisez le groupe d’administration pour l’étendue du blueprint.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--subscription -s

Utilisez l’abonnement pour l’étendue du blueprint. Si --management-group n’est pas spécifié, la valeur --subscription ou l’abonnement par défaut sera utilisé comme étendue.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment update

Changement cassant

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Mettez à jour une affectation de blueprint.

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]

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--blueprint-version

ID de ressource de la version publiée d’une définition de blueprint.

--description

Les lignes multiples expliquent cette ressource.

--display-name

La chaîne d’un liner explique cette ressource.

--identity-type

Type de l’identité managée.

Propriété Valeur
Groupe de paramètres: Identity Arguments
Valeurs acceptées: None, SystemAssigned, UserAssigned
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--locks-excluded-principals

Liste des principaux AAD exclus des verrous de blueprint. Jusqu’à 5 principaux sont autorisés.

--locks-mode

Mode de verrouillage.

Propriété Valeur
Valeurs acceptées: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Utilisez le groupe d’administration pour l’étendue cible de l’affectation de blueprint. Elle est réservée à une utilisation future. Utilisez plutôt --subscription.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--parameters -p

Valeurs des paramètres d’affectation de blueprint. Il peut s’agir d’une chaîne JSON ou d’un chemin de fichier JSON.

--resource-group-value

Paires Clé=Valeur pour un groupe de ressources. Les clés incluent « artifact_name » (obligatoire), « name », « location ».

--subscription -s

Utilisez l’abonnement pour l’étendue cible de l’affectation de blueprint. La susbcription par défaut est utilisée si l’option n’est pas spécifiée.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--user-assigned-identity

Identité managée affectée par l’utilisateur associée à la ressource.

Propriété Valeur
Groupe de paramètres: Identity Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment wait

Changement cassant

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’affectation de blueprint soit remplie.

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

Exemples

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que l’affectation de blueprint soit correctement provisionnée.

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

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 30
--management-group -m

Utilisez le groupe d’administration pour l’étendue cible de l’affectation de blueprint. Elle est réservée à une utilisation future. Utilisez plutôt --subscription.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--subscription -s

Utilisez l’abonnement pour l’étendue cible de l’affectation de blueprint. La susbcription par défaut est utilisée si l’option n’est pas spécifiée.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az blueprint assignment who

Préversion Changement cassant

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Cette commande est implicitement déconseillée, car le groupe de commandes « az blueprint » est déconseillé et sera supprimé dans une prochaine version. Les blueprints et les commandes associées seront déconseillés dès juillet 2026. Les clients sont encouragés à passer aux spécifications de modèles et aux piles de déploiement pour soutenir leurs scénarios au-delà de cette date. La documentation sur la migration est disponible à l’adresse https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint.

Get Blueprint Servie Principal Name objectId.

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

Exemples

Get SPN objectId

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

Paramètres obligatoires

--name -n

Nom de l’affectation de blueprint.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--management-group -m

Utilisez le groupe d’administration pour l’étendue du blueprint.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
--subscription -s

Utilisez l’abonnement pour l’étendue du blueprint. Si --management-group n’est pas spécifié, la valeur --subscription ou l’abonnement par défaut sera utilisé comme étendue.

Propriété Valeur
Groupe de paramètres: Resource_scope Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False