aad app set¶
Updates Azure AD app registration
Usage¶
m365 aad app set [options]
Options¶
--appId [appId]
- Application (client) ID of the Azure AD application registration to update. Specify either
appId
,objectId
orname
--objectId [objectId]
- Object ID of the Azure AD application registration to update. Specify either
appId
,objectId
orname
--name [name]
- Name of the Azure AD application registration to update. Specify either
appId
,objectId
orname
-u, --uri [uri]
- Comma-separated list of Application ID URIs to update
-r, --redirectUris [redirectUris]
- Comma-separated list of redirect URIs to add to the app registration. Requires
platform
to be specified -p, --platform [platform]
- Platform for which the
redirectUri
should be configured. Allowed valuesspa,web,publicClient
--redirectUrisToRemove [redirectUrisToRemove]
- Comma-separated list of existing redirect URIs to remove. Specify, when you want to replace existing redirect URIs with another
--certificateFile [certificateFile]
- Path to the file with certificate public key. Specify either
certificateFile
orcertificateBase64Encoded
--certificateBase64Encoded [certificateBase64Encoded]
- Base64-encoded string with certificate public key. Specify either
certificateFile
orcertificateBase64Encoded
--certificateDisplayName [certificateDisplayName]
- Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either
certificateFile
orcertificateBase64Encoded
-h, --help
- output usage information
--query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text,csv
. Defaultjson
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Remarks¶
For best performance use the objectId
option to reference the Azure AD application registration to update. If you use appId
or name
, this command will first need to find the corresponding object ID for that application.
If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
When a certificate is specified it will be added to the list of certificates of the app without changing existing certificates.
Examples¶
Update the app URI of the Azure AD application registration specified by its object ID
m365 aad app set --objectId d75be2e1-0204-4f95-857d-51a37cf40be8 --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
Update the app URI of the Azure AD application registration specified by its app (client) ID
m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
Update the app URI of the Azure AD application registration specified by its name
m365 aad app set --name "My app" --uri https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
Add a new redirect URI for SPA authentication
m365 aad app set --objectId 95cfe30d-ed44-4f9d-b73d-c66560f72e83 --redirectUris https://contoso.com/auth --platform spa
Replace one redirect URI with another for SPA authentication
m365 aad app set --objectId 95cfe30d-ed44-4f9d-b73d-c66560f72e83 --redirectUris https://contoso.com/auth --platform spa --redirectUrisToRemove https://contoso.com/old-auth
Add a certificate to the app
m365 aad app set --certificateDisplayName "Some certificate name" --certificateFile c:\temp\some-certificate.cer