Freshness for the authentication cmdlets article

[msewaweru]

This pull request updates the documentation for Microsoft Graph PowerShell authentication commands to improve clarity, enhance accuracy, and provide additional details. The changes include rephrased descriptions, added notes for better understanding, and updated examples to align with best practices.

Documentation Improvements:

General Enhancements:

• Updated descriptions to improve clarity and readability, such as rephrasing "cmdlets that can be used to manage the different parameters required during authentication" to "cmdlets that can be used to manage environment, application ID, and certificate settings."
• Enhanced examples and notes, including specifying that Connect-MgGraph uses MSAL under the hood for authentication.

Authentication Methods:

• Added detailed explanations for authentication types, including managed identities and client secret credentials, emphasizing improved security and automation benefits. [1] [2]
• Clarified the use of parameters like -CertificateThumbprint and -CertificateName for app-only access.

Passwordless Authentication:

• Improved descriptions of passwordless authentication methods and compatibility notes, such as specifying that FIDO2 security keys are supported only in PowerShell 7 and above.

Environment Targeting:

• Provided additional details on targeting specific clouds using the -Environment parameter, including examples for Azure China and US Government clouds.

Command Usage Examples:

• Enhanced examples for retrieving consented scopes using Select-Object with -ExpandProperty and clarified the use of Invoke-MgGraphRequest for issuing REST API requests. [1] [2]

Next Steps Section:

• Updated the "Next steps" section to include links to additional resources for discovering commands and permissions in Microsoft Graph PowerShell.

[learn-build-service-prod]

Learn Build status updates of commit a34828e:

💡 Validation status: suggestions

File	Status	Preview URL	Details
microsoftgraph/docs-conceptual/authentication-commands.md	💡Suggestion	View (graph-powershell-1.0 || graph-powershell-beta)	Details

microsoftgraph/docs-conceptual/authentication-commands.md

• Line 205, Column 69: [Suggestion: learn-site-link-broken - See documentation] Link '/azure/active-directory/develop/quickstart-register-app-portal?tabs=azure-china' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

Learn Build status updates of commit 7ada02d:

✅ Validation status: passed

File	Status	Preview URL	Details
microsoftgraph/docs-conceptual/authentication-commands.md	✅Succeeded	View (graph-powershell-1.0 || graph-powershell-beta)

For more details, please refer to the build report.

[omondiatieno]

@msewaweru, I left a few minor suggestions. Otherwise, LGTM!

[omondiatieno]

Suggested change

A common challenge when writing automation scripts is the management of secrets, credentials, certificates, and keys used to secure communication between services. Eliminate the need to manage credentials by allowing the module to obtain access tokens for Microsoft Entra resources that are protected by Microsoft Entra ID. The identity is managed by the Microsoft Entra platform and does not require you to provision or rotate any secrets.

A common challenge when writing automation scripts is the management of secrets, credentials, certificates, and keys used to secure communication between services. Eliminate the need to manage credentials by allowing the module to obtain access tokens for Microsoft Entra resources that are protected by Microsoft Entra ID. The identity is managed by the Microsoft Entra platform and doesn't require you to provision or rotate any secrets.

[learn-build-service-prod]

Learn Build status updates of commit 1dd3b1c:

✅ Validation status: passed

File	Status	Preview URL	Details
microsoftgraph/docs-conceptual/authentication-commands.md	✅Succeeded	View (graph-powershell-1.0 || graph-powershell-beta)

For more details, please refer to the build report.

[learn-build-service-prod]

Learn Build status updates of commit 79f461e:

✅ Validation status: passed

File	Status	Preview URL	Details
microsoftgraph/docs-conceptual/authentication-commands.md	✅Succeeded	View (graph-powershell-1.0 || graph-powershell-beta)

For more details, please refer to the build report.