Azure / Azure/azure-powershell

[Doc]: Connect-AzAccount Parameter Sets Cannot Describe the Functions and Usages Properly

Open
#25,103 3 comments 0 reactions 0 assignees View on GitHub
Accounts feature-request P2 Tracking
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.