az ad app

Gérer les applications Microsoft Entra.

Commandes

Nom	Description	Type	État
az ad app create	Créez une application.	Core	GA
az ad app credential	Gérez le mot de passe ou les informations d’identification de certificat d’une application.	Core	GA
az ad app credential delete	Supprimez le mot de passe ou les informations d’identification de certificat d’une application.	Core	GA
az ad app credential list	Répertoriez les métadonnées d’informations d’identification du mot de passe ou du certificat d’une application. (Le contenu du mot de passe ou des informations d’identification du certificat n’est pas récupérable.).	Core	GA
az ad app credential reset	Réinitialisez le mot de passe ou les informations d’identification de certificat d’une application.	Core	GA
az ad app delete	Supprimez une application.	Core	GA
az ad app federated-credential	Gérer les informations d’identification d’identité fédérée de l’application.	Core	GA
az ad app federated-credential create	Créez des informations d’identification d’identité fédérée d’application.	Core	GA
az ad app federated-credential delete	Supprimez les informations d’identification d’identité fédérée de l’application.	Core	GA
az ad app federated-credential list	Répertorier les informations d’identification d’identité fédérée de l’application.	Core	GA
az ad app federated-credential show	Afficher les informations d’identification d’identité fédérée de l’application.	Core	GA
az ad app federated-credential update	Mettez à jour les informations d’identification d’identité fédérée de l’application.	Core	GA
az ad app list	Répertorier les applications.	Core	GA
az ad app owner	Gérer les propriétaires d’applications.	Core	GA
az ad app owner add	Ajoutez un propriétaire d’application.	Core	GA
az ad app owner list	Répertorier les propriétaires d’applications.	Core	GA
az ad app owner remove	Supprimez un propriétaire d’application.	Core	GA
az ad app permission	Gérer les autorisations OAuth2 d’une application.	Core	GA
az ad app permission add	Ajoutez une autorisation d’API.	Core	GA
az ad app permission admin-consent	Accordez à l’application & autorisations déléguées par le biais du consentement administrateur.	Core	GA
az ad app permission delete	Supprimez une autorisation d’API.	Core	GA
az ad app permission grant	Accordez à l’application des autorisations déléguées d’API.	Core	GA
az ad app permission list	Répertorier les autorisations d’API demandées par l’application.	Core	GA
az ad app permission list-grants	Répertorier les octrois d’autorisations Oauth2.	Core	GA
az ad app show	Obtenez les détails d’une application.	Core	GA
az ad app update	Mettez à jour une application.	Core	GA

az ad app create

Modifier

Créez une application.

Pour obtenir une documentation plus détaillée, consultez https://learn.microsoft.com/graph/api/resources/application.

az ad app create --display-name
                 [--app-roles]
                 [--enable-access-token-issuance {false, true}]
                 [--enable-id-token-issuance {false, true}]
                 [--end-date]
                 [--identifier-uris]
                 [--is-fallback-public-client {false, true}]
                 [--key-display-name]
                 [--key-type {AsymmetricX509Cert, Password, Symmetric}]
                 [--key-usage {Sign, Verify}]
                 [--key-value]
                 [--optional-claims]
                 [--public-client-redirect-uris]
                 [--requested-access-token-version]
                 [--required-resource-accesses]
                 [--service-management-reference]
                 [--sign-in-audience {AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount}]
                 [--start-date]
                 [--web-home-page-url]
                 [--web-redirect-uris]

Exemples

Créez une application.

az ad app create --display-name mytestapp

Créer une application qui peut revenir au client public avec l’autorisation déléguée Microsoft Graph User.Read

az ad app create --display-name my-public --is-fallback-public-client --required-resource-accesses @manifest.json
("manifest.json" contains the following content)
[{
    "resourceAppId": "00000003-0000-0000-c000-000000000000",
    "resourceAccess": [
        {
            "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
            "type": "Scope"
        }
   ]
}]

Créer une application avec un rôle

az ad app create --display-name mytestapp --identifier-uris https://mytestapp.websites.net --app-roles @manifest.json
("manifest.json" contains the following content)
[{
    "allowedMemberTypes": [
      "User"
    ],
    "description": "Approvers can mark documents as approved",
    "displayName": "Approver",
    "isEnabled": "true",
    "value": "approver"
}]

Créer une application avec des revendications facultatives

az ad app create --display-name mytestapp --optional-claims @manifest.json
("manifest.json" contains the following content)
{
    "idToken": [
        {
            "name": "auth_time",
            "essential": false
        }
    ],
    "accessToken": [
        {
            "name": "ipaddr",
            "essential": false
        }
    ],
    "saml2Token": [
        {
            "name": "upn",
            "essential": false
        },
        {
            "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
            "source": "user",
            "essential": false
        }
    ]
}

Paramètres obligatoires

--display-name

Nom complet de l’application.

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.

--app-roles

Collection de rôles attribués à l’application. Avec les attributions de rôles d’application, ces rôles peuvent être attribués aux utilisateurs, groupes ou principaux de service associés à d’autres applications. Doit être un chemin d’accès au fichier JSON ou une chaîne JSON en ligne. Pour plus d’informations, consultez des exemples.

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--enable-access-token-issuance

Spécifie si cette application web peut demander un jeton d’accès à l’aide du flux implicite OAuth 2.0.

Propriété	Valeur
Groupe de paramètres:	web Arguments
Valeurs acceptées:	false, true

--enable-id-token-issuance

Spécifie si cette application web peut demander un jeton d’ID à l’aide du flux implicite OAuth 2.0.

Propriété	Valeur
Groupe de paramètres:	web Arguments
Valeurs acceptées:	false, true

--end-date

Date ou heure d’expiration des informations d’identification (par exemple, « 2017-12-31T11:59:59+00:00 » ou « 2017-12-31 »). La valeur par défaut est d’un an après l’heure actuelle.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--identifier-uris

Valeurs séparées par l’espace. Également appelée URI ID d'application, cette valeur est définie lorsqu’une application est utilisée en tant qu’application de ressources. L’identificateurUris agit comme préfixe pour les étendues que vous référencez dans le code de votre API et doit être globalement unique. Vous pouvez utiliser la valeur par défaut fournie, qui se trouve dans le formulaire api://<application-client-id> ou spécifier un URI plus lisible comme https://contoso.com/api.

--is-fallback-public-client

Désigne le type d’application de base comme étant client public (une application installée exécutée sur un appareil mobile, par exemple). La valeur par défaut est false, ce qui signifie que le type d’application de secours est un client confidentiel tel qu’une application web.

Propriété	Valeur
Valeurs acceptées:	false, true

--key-display-name

Nom convivial de la clé.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--key-type

Type des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments
Valeur par défaut:	AsymmetricX509Cert
Valeurs acceptées:	AsymmetricX509Cert, Password, Symmetric

--key-usage

Utilisation des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments
Valeur par défaut:	Verify
Valeurs acceptées:	Sign, Verify

--key-value

Valeur des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--optional-claims

Les développeurs d’applications peuvent configurer des revendications facultatives dans leurs applications Microsoft Entra pour spécifier les revendications envoyées à leur application par le service de jeton de sécurité Microsoft. Pour plus d’informations, consultez https://learn.microsoft.com/azure/active-directory/develop/active-directory-optional-claims. Doit être un chemin d’accès au fichier JSON ou une chaîne JSON en ligne. Pour plus d’informations, consultez des exemples.

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--public-client-redirect-uris

Valeurs séparées par l’espace. Spécifie les URL où les jetons utilisateur sont envoyés pour la connexion ou les URI de redirection où les codes d’autorisation et les jetons d’accès OAuth 2.0 sont envoyés.

Propriété	Valeur
Groupe de paramètres:	publicClient Arguments

--requested-access-token-version

Spécifie la version de jeton d’accès attendue par la ressource. Cela modifie la version et le format du JWT produit indépendant du point de terminaison ou du client utilisé pour demander le jeton d’accès.

Propriété	Valeur
Groupe de paramètres:	api Arguments

--required-resource-accesses

Spécifie les ressources auxquelles l’application doit accéder. Cette propriété spécifie également l’ensemble des autorisations déléguées et des rôles d’application dont elle a besoin pour chacune de ces ressources. Cette configuration de l'accès aux ressources requises détermine l'expérience du consentement. Doit être un chemin d’accès au fichier JSON ou une chaîne JSON en ligne. Pour plus d’informations, consultez des exemples.

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--service-management-reference

Fait référence aux informations de contact d’application ou de service à partir d’une base de données Service ou Gestion des actifs.

--sign-in-audience

Spécifie les comptes Microsoft qui sont pris en charge pour l’application actuelle.

Propriété	Valeur
Valeurs acceptées:	AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount

--start-date

Date ou heure à laquelle les informations d’identification deviennent valides (par exemple, « 2017-01-01T01:00:00+00:00 » ou « 2017-01-01 »). La valeur par défaut est l’heure actuelle.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--web-home-page-url

Page d’accueil ou page de destination de l’application.

Propriété	Valeur
Groupe de paramètres:	web Arguments

--web-redirect-uris

Propriété	Valeur
Groupe de paramètres:	web 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 ad app delete

Modifier

Supprimez une application.

az ad app delete --id

Exemples

Supprimez une application. (autogenerated)

az ad app delete --id 00000000-0000-0000-0000-000000000000

Paramètres obligatoires

--id

URI d’identificateur, ID d’application ou ID d’objet.

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 ad app list

Modifier

Répertorier les applications.

Pour une faible latence, par défaut, seuls les 100 premiers seront retournés, sauf si vous fournissez des arguments de filtre ou utilisez « --all ».

az ad app list [--all]
               [--app-id]
               [--display-name]
               [--filter]
               [--identifier-uri]
               [--show-mine]

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.

--all

Répertoriez toutes les entités, attendez-vous à un long délai si dans une grande organisation.

--app-id

ID d’application.

--display-name

Nom complet de l’application.

--filter

Filtre OData, par exemple --filter « displayname eq 'test' et servicePrincipalType eq 'Application' ».

--identifier-uri

L’identificateur d’application Graph doit être au format uri.

--show-mine

Répertorier les entités appartenant à l’utilisateur actuel.

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 ad app show

Modifier

Obtenez les détails d’une application.

az ad app show --id

Exemples

Obtenez les détails d’une application avec appId.

az ad app show --id 00000000-0000-0000-0000-000000000000

Obtenez les détails d’une application avec l’ID.

az ad app show --id 00000000-0000-0000-0000-000000000000

Obtenez les détails d’une application avec l’URI d’identificateur.

az ad app show --id api://myapp

Paramètres obligatoires

--id

URI d’identificateur, ID d’application ou ID d’objet.

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 ad app update

Modifier

Mettez à jour une application.

az ad app update --id
                 [--add]
                 [--app-roles]
                 [--display-name]
                 [--enable-access-token-issuance {false, true}]
                 [--enable-id-token-issuance {false, true}]
                 [--end-date]
                 [--force-string]
                 [--identifier-uris]
                 [--is-fallback-public-client {false, true}]
                 [--key-display-name]
                 [--key-type {AsymmetricX509Cert, Password, Symmetric}]
                 [--key-usage {Sign, Verify}]
                 [--key-value]
                 [--optional-claims]
                 [--public-client-redirect-uris]
                 [--remove]
                 [--requested-access-token-version]
                 [--required-resource-accesses]
                 [--service-management-reference]
                 [--set]
                 [--sign-in-audience {AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount}]
                 [--start-date]
                 [--web-home-page-url]
                 [--web-redirect-uris]

Exemples

Mettre à jour une application avec l’autorisation déléguée Microsoft Graph User.Read

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --required-resource-accesses @manifest.json
("manifest.json" contains the following content)
[{
    "resourceAppId": "00000003-0000-0000-c000-000000000000",
    "resourceAccess": [
        {
            "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
            "type": "Scope"
        }
   ]
}]

déclarer un rôle d’application

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --app-roles @manifest.json
("manifest.json" contains the following content)
[{
    "allowedMemberTypes": [
      "User"
    ],
    "description": "Approvers can mark documents as approved",
    "displayName": "Approver",
    "isEnabled": "true",
    "value": "approver"
}]

mettre à jour les revendications facultatives

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --optional-claims @manifest.json
("manifest.json" contains the following content)
{
    "idToken": [
        {
            "name": "auth_time",
            "essential": false
        }
    ],
    "accessToken": [
        {
            "name": "ipaddr",
            "essential": false
        }
    ],
    "saml2Token": [
        {
            "name": "upn",
            "essential": false
        },
        {
            "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
            "source": "user",
            "essential": false
        }
    ]
}

mettre à jour les revendications d’appartenance à un groupe d’une application sur « Tout »

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --set groupMembershipClaims=All

Paramètres obligatoires

--id

URI d’identificateur, ID d’application ou ID d’objet.

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.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	[]

--app-roles

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--display-name

Nom complet de l’application.

--enable-access-token-issuance

Spécifie si cette application web peut demander un jeton d’accès à l’aide du flux implicite OAuth 2.0.

Propriété	Valeur
Groupe de paramètres:	web Arguments
Valeurs acceptées:	false, true

--enable-id-token-issuance

Spécifie si cette application web peut demander un jeton d’ID à l’aide du flux implicite OAuth 2.0.

Propriété	Valeur
Groupe de paramètres:	web Arguments
Valeurs acceptées:	false, true

--end-date

Date ou heure d’expiration des informations d’identification (par exemple, « 2017-12-31T11:59:59+00:00 » ou « 2017-12-31 »). La valeur par défaut est d’un an après l’heure actuelle.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	False

--identifier-uris

--is-fallback-public-client

Propriété	Valeur
Valeurs acceptées:	false, true

--key-display-name

Nom convivial de la clé.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--key-type

Type des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments
Valeur par défaut:	AsymmetricX509Cert
Valeurs acceptées:	AsymmetricX509Cert, Password, Symmetric

--key-usage

Utilisation des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments
Valeur par défaut:	Verify
Valeurs acceptées:	Sign, Verify

--key-value

Valeur des informations d’identification de clé associées à l’application.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--optional-claims

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--public-client-redirect-uris

Propriété	Valeur
Groupe de paramètres:	publicClient Arguments

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	[]

--requested-access-token-version

Propriété	Valeur
Groupe de paramètres:	api Arguments

--required-resource-accesses

Propriété	Valeur
Groupe de paramètres:	JSON property Arguments

--service-management-reference

Fait référence aux informations de contact d’application ou de service à partir d’une base de données Service ou Gestion des actifs.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	[]

--sign-in-audience

Spécifie les comptes Microsoft qui sont pris en charge pour l’application actuelle.

Propriété	Valeur
Valeurs acceptées:	AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount

--start-date

Date ou heure à laquelle les informations d’identification deviennent valides (par exemple, « 2017-01-01T01:00:00+00:00 » ou « 2017-01-01 »). La valeur par défaut est l’heure actuelle.

Propriété	Valeur
Groupe de paramètres:	keyCredential Arguments

--web-home-page-url

Page d’accueil ou page de destination de l’application.

Propriété	Valeur
Groupe de paramètres:	web Arguments

--web-redirect-uris

Propriété	Valeur
Groupe de paramètres:	web 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

Commentaires

Cette page a-t-elle été utile ?

Partager via

az ad app

Commandes

az ad app create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az ad app delete

Exemples

Paramètres obligatoires

az ad app list

Paramètres facultatifs

az ad app show

Exemples

Paramètres obligatoires

az ad app update

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires