The new corresponding parameter name should be -WebHomePageUrl, but -WebHomePageUrl is used as an alias, instead of the official name. Other parameters face similar problems:
-AvailableToOtherTenants which conflicts with -SignInAudience
-ReplyUrls vs -WebRedirectUri. New-AzADApplication makes -ReplyUrls and -WebRedirectUri the same:
However, in Microsoft Graph, replyUrls is split into web/redirectUris and publicClient/redirectUris, instead of replaced by web/redirectUris:
meaning there is no one-one mapping between replyUrls and web/redirectUris.
Problems
New users of Microsoft Graph can't easily find the corresponding parameter names (-WebHomePageUrl). Instead, they will have to learn the deprecated AD Graph parameter names (-HomePage). This increases learning effort for new users.
The cmdlet parameter doesn't match the output - -HomePage maps to web/homePageUrl, introducing inconsistency.
Azure CLI's solution: be consistent with new Microsoft Graph API
yonzhan
commented
2 years ago
Discussion: whether to preserve deprecated AD Graph parameter names
There has been an internal discussion recently about whether we should preserve deprecated AD Graph parameter names.
Azure PowerShell's solution: Keep AD Graph parameter names
For Azure PowerShell, after the Microsoft Graph migration, it uses
For example,
New-AzADApplicationuses the deprecated AD Graph property name-HomePageas the official parameter name:According to https://docs.microsoft.com/en-us/graph/migrate-azure-ad-graph-property-differences,
homepagehas been replaced byweb/homePageUrlin Microsoft Graph:The new corresponding parameter name should be
-WebHomePageUrl, but-WebHomePageUrlis used as an alias, instead of the official name. Other parameters face similar problems:-AvailableToOtherTenantswhich conflicts with-SignInAudience-ReplyUrlsvs-WebRedirectUri.New-AzADApplicationmakes-ReplyUrlsand-WebRedirectUrithe same:replyUrlsis split intoweb/redirectUrisandpublicClient/redirectUris, instead of replaced byweb/redirectUris:replyUrlsandweb/redirectUris.Problems
-WebHomePageUrl). Instead, they will have to learn the deprecated AD Graph parameter names (-HomePage). This increases learning effort for new users.-HomePagemaps toweb/homePageUrl, introducing inconsistency.Azure CLI's solution: be consistent with new Microsoft Graph API
Currently, as detailed in https://docs.microsoft.com/cli/azure/microsoft-graph-migration, we decide to replace deprecated AD Graph parameter names with new Microsoft Graph ones, such as
If you have any feedback, please feel free to left a comment in this issue.
Originally posted by @jiasli in https://github.com/Azure/azure-cli/issues/12946#issuecomment-1058796773