Update v2 Changelog.

Author: peombwa

docs/authentication.md

@@ -5,20 +5,6 @@ The Microsoft Graph PowerShell module supports two types of authentication:
 - Delegated Access
 - App-only Access
 
-## Web Account Manager (WAM)
-WAM is a Windows 10+ component that acts as an authentication broker allowing the users of an app benefit from integration with accounts known to Windows, such as the account already signed into an active Windows session.
-
-Microsoft Graph PowerShell module supports WAM in the following scenraio:
-
-- To enable WAM on supported devices
-```PowerShell
-Set-MgGraphOption -EnableLoginByWAM $true
-```
-
-- To disable WAM on supported devices
-```PowerShell
-Set-MgGraphOption -EnableLoginByWAM $false
-```
 ## Delegated Access
 
 Delegated access uses a public client to get an access token and consume Microsoft Graph resources on behalf of the signed-in user.
@@ -125,3 +111,21 @@ When using `-AccessToken`, we won't have access to the refresh token and the cli
 ### Access Token Scopes (scp) Claims
 
 Before using the provided `-AccessToken` to get Microsoft Graph resources, customers should ensure that the access token has the necessary scopes/ permissions needed to access/modify a resource.
+
+## Web Account Manager (WAM)
+
+WAM is a Windows 10+ component that acts as an authentication broker allowing the users of an app benefit from integration with accounts known to Windows, such as the account already signed into an active Windows session.
+
+Microsoft Graph PowerShell module supports WAM in the following scenario:
+
+- To enable WAM on supported devices
+
+```PowerShell
+Set-MgGraphOption -EnableLoginByWAM $true
+```
+
+- To disable WAM on supported devices
+
+```PowerShell
+Set-MgGraphOption -EnableLoginByWAM $false
+```

docs/upgrade-to-v2.md

@@ -124,9 +124,37 @@ Connect-MgGraph -EnvironmentVariable
 
 ### Service Modules
 
+#### Count Commands (`/$count`)
+
+We've added dedicated count commands in v2 for supported resources. In v2, you can now get a [count of users in your tenant](https://learn.microsoft.com/graph/api/user-list?view=graph-rest-1.0&tabs=http#example-3-get-only-a-count-of-users) using:
+
+``` powershell
+$UsersCount = Get-MgUserCount -ConsistencyLevel Eventual
+```
+
+See [advanced query capabilities on Azure AD objects](https://learn.microsoft.com/graph/aad-advanced-queries) for more details.
+
+#### OData Cast Support
+
+V2 adds OData cast commands via `*-Mg*As<CAST-Type>` syntax when supported by the API. With OData cast support, customers can now access properties on specialized types rather than going through AdditionalProperties for supported APIs. For example, one can use `Get-MgGroupMemberAsUser` to [list group members that are users](https://learn.microsoft.com/graph/api/group-list-members?view=graph-rest-1.0&tabs=http):
+
+```powershell
+$Users = Get-MgGroupMemberAsUser -GroupId "GROUP_ID"
+```
+
+> In the example above, the cast type can also be `ServicePrincipal`, `Application`, `Device`, `Group`, and more as supported by the API.
+
+#### Improved Service Error Reporting
+
+We've updated how service errors are written to the error stream to help with debugging API related errors. In v2, when a service error occurs, the SDK will now write message, HTTP status code, error code, request-id, date, and other useful headers to the error stream.
+
+![image](https://github.com/microsoftgraph/msgraph-sdk-powershell/assets/7061532/45ab9783-12ee-4666-b6ee-c29bfbff6827)
+
+See [Microsoft Graph API error response](https://learn.microsoft.com/graph/errors) for more details.
+
 #### HTTP/2 support
 
-v2 adds [HTTP/2](https://httpwg.org/specs/rfc7540.html) support for supported API endpoints. The module will gracefully fallback to HTTP/1.1 when HTTP/2 is not supported by the API. HTTP/2 improves performance by adding support for; multiplexing, header compression, and server push.
+V2 adds [HTTP/2](https://httpwg.org/specs/rfc7540.html) support for supported API endpoints. The module will gracefully fallback to HTTP/1.1 when HTTP/2 is not supported by the API. HTTP/2 improves performance by adding support for; multiplexing, header compression, and server push.
 
 #### Success status code range support