Merge pull request #2115 from microsoftgraph/po/UpdateReadMeDocs

Update Readme and Samples

Author: peombwa

README.md

@@ -27,10 +27,10 @@ The Microsoft Graph PowerShell module consists of a collection of PowerShell mod
 ## Modules
 
 The table below contains links to our latest and preview versions of the Microsoft Graph module. The meta modules will install all the service modules as their dependencies.
-| Module                                  | Latest             | Preview                        |
-| --------------------------------------- | ------------------ | ------------------------------ |
-| [`Microsoft.Graph`][mggallery]          | [![mg]][mggallery] | [![mgnext]][mggallery]         |
-| [`Microsoft.Graph.Beta`][mggallerybeta] | -                  | [![mgbetaNext]][mggallerybeta] |
+| Module                                  | Latest                       | Preview                        |
+| --------------------------------------- | ---------------------------- | ------------------------------ |
+| [`Microsoft.Graph`][mggallery]          | [![mg]][mggallery]           | -                              |
+| [`Microsoft.Graph.Beta`][mggallerybeta] | [![mgbeta]][mggallerybeta]   | -                              |
 
 See [Microsoft Graph PowerShell modules](https://github.com/microsoftgraph/msgraph-sdk-powershell/wiki/MS-Graph-PowerShell-Modules) for a list of all modules supported by this repository.
 
@@ -41,13 +41,13 @@ See [Microsoft Graph PowerShell modules](https://github.com/microsoftgraph/msgra
 Microsoft Graph PowerShell module is published on [PowerShell Gallery](https://www.powershellgallery.com/packages/Microsoft.Graph). Installing is as simple as:
 
 ```powershell
-Install-Module Microsoft.Graph -AllowPrerelease
+Install-Module Microsoft.Graph
 ```
 
 > Run `Install-Module` with AllowClobber and Force parameters if you run into command name conflicts when upgrading to older versions of the module:
 >
 > ```powershell
-> Install-Module Microsoft.Graph -AllowPrerelease -AllowClobber -Force
+> Install-Module Microsoft.Graph -AllowClobber -Force
 > ```
 
 See [Install the Microsoft Graph PowerShell Module](https://learn.microsoft.com/powershell/microsoftgraph/installation) guide for detailed installation instructions.
@@ -74,7 +74,7 @@ Get access to Microsoft Graph resources using the identity on an app and not on
 Connect-MgGraph -ClientId "YOUR_APP_ID" -TenantId "YOUR_TENANT_ID" -CertificateThumbprint "YOUR_CERT_THUMBPRINT"
 ```
 
-See [Authentication](./docs/authentication.md) for more information on usage of `Connect-MgGraph`.
+See [Authentication](./docs/authentication.md) for more information on the usage of `Connect-MgGraph`.
 
 ### 3. List users in your tenant
 
@@ -107,7 +107,7 @@ Disconnect-MgGraph
 Install `Microsoft.Graph.Beta` module to commands that call Microsoft Graph Beta API endpoint.
 
 ```powershell
-Install-Module Microsoft.Graph.Beta -AllowPrerelease
+Install-Module Microsoft.Graph.Beta
 # Consume Microsoft Graph beta resources.
 Connect-MgGraph
 $Users = Get-MgBetaUser
@@ -133,19 +133,19 @@ See [v2 upgrade guide](https://github.com/microsoftgraph/msgraph-sdk-powershell/
 
 When working with various operations in the Graph, you may encounter an error such as "Insufficient privileges to complete the operation." For example, this particular error can occur when using the `New-MgApplication` command if the appropriate permissions are not granted.
 
-If permission-related errors occur and the signed in user/app has been granted the appropriate permissions to perform the operation, you can explicitly fetch a new access token by running `Disconnect-MgGraph`, then `Connect-MgGraph`. This will trigger a refresh of the access token in your cache. Microsoft Authentication Library (MSAL) will only refresh access tokens in your cache if they have expired (usually an hour).
+If permission-related errors occur and the signed-in user/app has been granted the appropriate permissions to perform the operation, you can explicitly fetch a new access token by running `Disconnect-MgGraph`, then `Connect-MgGraph`. This will trigger a refresh of the access token in your cache. Microsoft Authentication Library (MSAL) will only refresh access tokens in your cache if they have expired (usually an hour).
 
 ### Common Errors
 
-See our [troubleshooting guide](https://learn.microsoft.com/powershell/microsoftgraph/troubleshooting) for detailed view on how to troubleshoot common errors when using Microsoft Graph.
+See our [troubleshooting guide](https://learn.microsoft.com/powershell/microsoftgraph/troubleshooting) for a detailed view of how to troubleshoot common errors when using Microsoft Graph.
 
 ## Known Issues
 
 - Using `-Property {PropertyName}` parameter will not select the property as the output of the command. All commands return CLR objects, and customers should pipe the command outputs to `Format-Table` or `Select-Object` to return individual properties.
 
 - Customers upgrading from previous versions of the SDK may encounter auth prompts on every command call. If this happens, one can use the following steps to reset their token cache:
   - Use `Disconnect-MgGraph` to sign out of the current session.
-  - Run `Remove-Item "$env:USERPROFILE\.graph" -Recurse -Force` to delete your token cache.
+  - Run `Remove-Item "$env:USERPROFILE\.mg" -Recurse -Force` to delete your token cache.
   - Run `Connect-MgGraph` to reconstruct a clean token cache.
 
 ## Feedback
@@ -163,6 +163,7 @@ Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT
 <!-- Shields -->
 
 [mg]: https://img.shields.io/powershellgallery/v/Microsoft.Graph.svg?style=flat-square&label=Microsoft.Graph
+[mgbeta]: https://img.shields.io/powershellgallery/v/Microsoft.Graph.Beta.svg?style=flat-square&label=Microsoft.Graph.Beta
 [mgnext]: https://img.shields.io/powershellgallery/v/Microsoft.Graph.svg?include_prereleases&style=flat-square&label=Microsoft.Graph
 [mgbetanext]: https://img.shields.io/powershellgallery/v/Microsoft.Graph.Beta.svg?include_prereleases&style=flat-square&label=Microsoft.Graph.Beta
 

samples/5-Teams.ps1

@@ -1,68 +1,67 @@
-# Switch to beta profile. This loads cmdlets that call MS Graph beta endpoint.
-Select-MgProfile -Name beta
+# Install Microsoft.Graph.Beta module. The following samples call the Microsoft Graph beta endpoint.
 
 # Create a new team.
 $TeamName = "2020 Interns"
-New-MgTeam -DisplayName $TeamName -Description $TeamName `
+New-MgBetaTeam -DisplayName $TeamName -Description $TeamName `
     -AdditionalProperties @{
         "[email protected]" = "https://graph.microsoft.com/beta/teamsTemplates('standard')"
     }
 
 # Filter groups by displayName and resourceProvisioningOptions to find team.
-$InternsTeam = Get-MgGroup -Filter "StartsWith(DisplayName, '$TeamName')" `
+$InternsTeam = Get-MgBetaGroup -Filter "StartsWith(DisplayName, '$TeamName')" `
                | Where-Object { $_.ResourceProvisioningOptions -Contains "Team" }
 
 # Add team owner.
-$teamOwner = Get-MgUser -UserId "{TEAM_OWNER_UPN}"
-New-MgTeamMember -TeamId $InternsTeam.Id -Roles "owner" `
+$teamOwner = Get-MgBetaUser -UserId "{TEAM_OWNER_UPN}"
+New-MgBetaTeamMember -TeamId $InternsTeam.Id -Roles "owner" `
     -AdditionalProperties @{ 
         "@odata.type" = "#microsoft.graph.aadUserConversationMember"; 
         "[email protected]" = "https://graph.microsoft.com/beta/users/" + $teamOwner.Id
     }
 
 # Filter users to find users who have a UPN that starts with 't-'.
-$TeamMembers = Get-MgUser -Filter "startswith(userPrincipalName, 't-')"
+$TeamMembers = Get-MgBetaUser -Filter "startswith(userPrincipalName, 't-')"
 
 # Add team members.
 foreach ($teamMember in $TeamMembers) {
-    New-MgTeamMember -TeamId $InternsTeam.Id -Roles "member" `
+    New-MgBetaTeamMember -TeamId $InternsTeam.Id -Roles "member" `
         -AdditionalProperties @{
             "@odata.type" = "#microsoft.graph.aadUserConversationMember";
             "[email protected]" = "https://graph.microsoft.com/beta/users/" + $teamMember.Id
         }
 }
 
 # Send a welcome message to the channel.
-$PrimaryChannel = Get-MgTeamPrimaryChannel -TeamId $InternsTeam.Id
-New-MgTeamChannelMessage -TeamId $InternsTeam.Id `
+$PrimaryChannel = Get-MgBetaTeamPrimaryChannel -TeamId $InternsTeam.Id
+New-MgBetaTeamChannelMessage -TeamId $InternsTeam.Id `
                          -ChannelId $PrimaryChannel.Id `
                          -Body @{
                              Content = "Welcome to Teams!"
                             }
 
 # Delete team.
-Remove-MgGroup -GroupId $InternsTeam.Id
+Remove-MgBetaGroup -GroupId $InternsTeam.Id
 
 # Teams Chat snippets
 
 # Get list of 1:1 chats
-Get-MgChat
+Get-MgBetaChat
 
 # Get Messages from Chat
-Get-MgChatMessage -chatId $chatId 
+Get-MgBetaChatMessage -chatId $chatId 
 
 # Send a message in that 1:1 chat
-New-MgChatMessage -chatId $chatId -Body @{ Content = "Hi from VSCode again!" }
+New-MgBetaChatMessage -chatId $chatId -Body @{ Content = "Hi from VSCode again!" }
 
 # Mention a user in a channel message.
-$User = Get-MgUser -UserId $userUPN | select id, displayName, userIdentityType
+$User = Get-MgBetaUser -UserId $userUPN | select id, displayName, userIdentityType
 $UserToMention  = @{
     Id = $User.Id;
     DisplayName = $User.DisplayName;
     UserIdentityType = "aadUser";
 }
 
-New-MgTeamChannelMessage -ChannelId $ChannelId -TeamId $TeamId `
+New-MgBetaTeamChannelMessage -ChannelId $ChannelId -TeamId $TeamId `
     -Body @{ `
         ContentType = "html"; `
         Content = "Welcome to the channel! <at id='0'>$($UserToMention.DisplayName)</at>" `

samples/Scripts/Get-TeamMembers.ps1

@@ -5,27 +5,25 @@ Connect-Graph -ClientId "YOUR_CLIENT_ID" `
               -TenantId "YOUR_TENANT_ID" `
               -CertificateName "YOUR_CERTIFICATE_NAME"
 
-# Switch to beta profile to use these samples.
-Select-MgProfile -Name beta
-
-$groups = Get-MgGroup
+# Install beta SDK to use these samples.
+$groups = Get-MgBetaGroup
 $teams = $groups | Where-Object { $_.ResourceProvisioningOptions -Contains "Team" }
 
 # List owners and memebers of all Teams team in your tenant.
 foreach($team in $teams) {
     Write-Host "Team: " + $team.DisplayName -ForegroundColor Blue
 
     Write-Host "Owners: " -ForegroundColor Yellow
-    $owners = Get-MgGroupOwner -GroupId $team.Id 
+    $owners = Get-MgBetaGroupOwner -GroupId $team.Id 
     foreach($owner in $owners) {
-        $o = Get-MgUser -UserId $owner.Id 
+        $o = Get-MgBetaUser -UserId $owner.Id
         Write-Host $o.DisplayName -ForegroundColor Yellow
     }
 
     Write-Host "Members: " -ForegroundColor Green
-    $members = Get-MgGroupMember -GroupId $team.Id
+    $members = Get-MgBetaGroupMember -GroupId $team.Id
     foreach($member in $members) {
-        $u = Get-MgUser -UserId $member.Id 
+        $u = Get-MgBetaUser -UserId $member.Id 
         Write-Host $u.DisplayName -ForegroundColor Green
     }
 }

src/Users.Actions/v1.0/examples/Set-MgUserLicense.md

@@ -95,7 +95,6 @@ This example updates the **EMSPREMIUM** license assigned to the user to add **AA
 ```powershell
 Connect-Graph -Scopes User.ReadWrite.All, Organization.Read.All
 
-Select-MgProfile -Name Beta
 $mgUser = Get-MgUser -UserId '38955658-c844-4f59-9430-6519430ac89b'
 
 Set-MgUserLicense -UserId "82f51c98-7221-442f-8329-3faf9fe022f1" -AddLicenses $mgUser.AssignedLicenses -RemoveLicenses @()

tools/Tests/DebugTests.ps1

@@ -8,7 +8,6 @@ BeforeAll {
     Import-Module $TestModulePath -Force
 
     Connect-MgGraph
-    Select-MgProfile beta
 }
 Describe 'Cmdlets Streams' {
     It 'Should Not Throw Exception when Debug Preference is Set'{