Azure / Azure/azure-powershell
[Doc]: Connect-AzAccount Parameter Sets Cannot Describe the Functions and Usages Properly
- Dominant language
- C#
- Stars
- 4.8k
- Forks
- 4.3k
- Avg merge
- 2d 17h
- Merged PRs (30d)
- 51
Description
### Type of issue
Other (describe below)
### Feedback
Currently the parameter sets of Connect-AzAccount don't describe the usages and functions
For example
- In the default parameter set "UserWithSubscriptionId (Default)", `subscription` is optional and so why it is named as "WithSubscriptionId"? Further, `UserWithCredential` is also a user flow and with `subscription` .
- For the parameter sets `ServicePrincipalWithSubscriptionId`, `ServicePrincipalCertificateWithSubscriptionId`, `ServicePrincipalCertificateFileWithSubscriptionId` and `AccessTokenWithSubscriptionId`, what's the meaning for "WithSubscriptionId" as the "subscripiton" is optional for all the parameter sets?
### Page URL
_No response_
### Content source URL
https://github.com/Azure/azure-powershell/blob/main/src/Accounts/Accounts/help/Connect-AzAccount.md
### Author
_No response_
### Document Id
_No response_
Contributor guide
Assessment
This issue has not been assessed yet.