Merge branch 'dev' into po/AddNewGroupMember

Author: peombwa

.azure-pipelines/generate-auth-module.yml

@@ -36,6 +36,13 @@ jobs:
       filePath: '$(System.DefaultWorkingDirectory)/tools/GenerateAuthenticationModule.ps1'
       arguments: '-RepositoryName $(Repository_Name) -RepositoryApiKey $(Api_Key) -ModuleVersion $(Module_Version) -ArtifactsLocation $(Build.ArtifactStagingDirectory) -Build -EnableSigning'
       pwsh: true
+
+  - task: DotNetCoreCLI@2
+    displayName: 'Run Enabled Tests'
+    inputs:
+      command: 'test'
+      projects: '$(System.DefaultWorkingDirectory)/src/Authentication/Authentication.Test/*.csproj'
+      testRunTitle: 'Run Enabled Tests'
 
   - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@1
     displayName: 'ESRP DLL Strong Name (Graph Auth Module)'

.azure-pipelines/generate-beta-rollup-module.yml

@@ -37,7 +37,7 @@ jobs:
     inputs:
       ConnectedServiceName: 'microsoftgraph ESRP CodeSign DLL and NuGet'
       FolderPath: $(MODULE_PATH)
-      Pattern: '$(MODULE_PREFIX).psd1, $(MODULE_PREFIX).*.psd1, $(MODULE_PREFIX).*.format.ps1xml, *.ps1'
+      Pattern: '$(MODULE_PREFIX).psm1, $(MODULE_PREFIX).*.format.ps1xml, *.ps1'
       signConfigType: inlineSignParams
       inlineOperation: |
        [

.azure-pipelines/generate-v1.0-rollup-module.yml

@@ -37,7 +37,7 @@ jobs:
     inputs:
       ConnectedServiceName: 'microsoftgraph ESRP CodeSign DLL and NuGet'
       FolderPath: $(MODULE_PATH)
-      Pattern: '$(MODULE_PREFIX).psd1, $(MODULE_PREFIX).*.psd1, $(MODULE_PREFIX).*.format.ps1xml, *.ps1'
+      Pattern: '$(MODULE_PREFIX).psm1, $(MODULE_PREFIX).*.format.ps1xml, *.ps1'
       signConfigType: inlineSignParams
       inlineOperation: |
        [

.azure-pipelines/validate-pr-auth-module.yml

@@ -33,6 +33,13 @@ jobs:
       filePath: '$(System.DefaultWorkingDirectory)/tools/GenerateAuthenticationModule.ps1'
       arguments: '-RepositoryName $(Repository_Name) -RepositoryApiKey $(Api_Key) -ModuleVersion $(Module_Version) -ArtifactsLocation $(Build.ArtifactStagingDirectory) -Build'
       pwsh: true
+
+  - task: DotNetCoreCLI@2
+    displayName: 'Run Enabled Tests'
+    inputs:
+      command: 'test'
+      projects: '$(System.DefaultWorkingDirectory)/src/Authentication/Authentication.Test/*.csproj'
+      testRunTitle: 'Run Enabled Tests'
 
   - task: YodLabs.O365PostMessage.O365PostMessageBuild.O365PostMessageBuild@0
     displayName: 'Graph Client Tooling pipeline fail notification'

.gitignore

@@ -351,3 +351,6 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
+
+# Visual Studio Code
+.vscode/

README.md

@@ -1,20 +1,15 @@
-# Microsoft Graph PowerShell SDK (alpha)
-The Microsoft Graph PowerShell SDK is a collection of PowerShell modules that contain cmdlets for calling Microsoft Graph. 
+# Microsoft Graph PowerShell SDK Preview
+The Microsoft Graph PowerShell SDK is a collection of PowerShell modules that contain cmdlets for calling Microsoft Graph.
 
-## Installing the Microsoft.Graph.Beta Module
+## Installing the Microsoft.Graph Module
 
-In the future, the modules will be published to the PowerShell Gallery, however in the short term they are hosted on our own nuget feed. Use the following commands to register repository and then install the `Microsoft.Graph.Beta` module from there.
+The modules are now published on the PowerShell Gallery. Installing is as simple as:
 
 ```ps
-Register-PSRepository `
--Name GraphPowerShell `
--SourceLocation https://graphpowershellrepository.azurewebsites.net/nuget
-
-# Installing the Graph PowerShell module for the Beta API 
-Install-module Microsoft.Graph.Beta -Repository GraphPowerShell
+Install-module Microsoft.Graph
 ```
 
-There are a set of samples in the `samples` folder to help getting started with the library.
+There are a set of samples in the `samples` folder to help getting started with the library.  If you have an older version of these modules installed, there are uninstall instructions in the [InstallModule](./samples/0-InstallModule.ps1) script.
 
 ## Generate Module
 
@@ -134,3 +129,12 @@ There are a set of samples in the `samples` folder to help getting started with
     ```ps
     Disconnect-Graph
     ```
+
+## Troubleshooting Permission Related Errors
+
+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-Application` command if the appropriate permissions are not granted.
+
+If permission related errors occur and the user you authenticated with in the popup has the appropriate permissions to peform the operation try these steps.
+
+- You can try running `Disconnect-Graph`, then `Connect-Graph`.  Then, run the code that encountered the permission issues to see if it works.
+- You can try running `Connect-Graph -ForceRefresh`.  This will trigger a refresh of the access token in your cache. MSAL will only refresh the access token in your cache if it has expired (usually an hour), or if you explicitly refresh it via `-ForceRefresh`.  Then, run the code that encountered the permission issues to see if it works.

Repo.props

@@ -0,0 +1,9 @@
+
+<Project>
+    <PropertyGroup>
+      <RepoRoot>$(MSBuildThisFileDirectory)</RepoRoot>
+      <RepoSrc>$(RepoRoot)src/</RepoSrc>
+      <RepoArtifacts>$(RepoRoot)artifacts/</RepoArtifacts>
+      <RepoTools>$(RepoRoot)tools/</RepoTools>
+    </PropertyGroup>
+  </Project>

config/ModuleMetadata.json

@@ -8,6 +8,7 @@
     "projectUri": "https://github.com/microsoftgraph/msgraph-sdk-powershell",
     "iconUri": "https://raw.githubusercontent.com/microsoftgraph/g-raph/master/g-raph.png",
     "tags": "MicrosoftGraph;Microsoft;Office365;Graph;PowerShell;GraphServiceClient;Outlook;OneDrive;AzureAD;GraphAPI;Productivity;SharePoint;Intune;SDK;",
-    "releaseNotes": "",
-    "assemblyOriginatorKeyFile": "35MSSharedLib1024.snk"
+    "releaseNotes": "Initial release of Microsoft.Graph module.",
+    "assemblyOriginatorKeyFile": "35MSSharedLib1024.snk",
+    "version": "0.2.0"
 }

samples/0-InstallModule.ps1

@@ -1,9 +1,16 @@
 # Installing the Module
 
-# Temporarily, register this repository
-Register-PSRepository `
--Name GraphPowerShell `
--SourceLocation https://graphpowershellrepository.azurewebsites.net/nuget
+# Installing the Graph PowerShell module for the Beta API with no previous versions installed
+Install-module Microsoft.Graph
+
+# Uninstalling the old preview version, before installing the new
+
+# Remove the main meta module
+Uninstall-Module Microsoft.Graph.Beta
+
+# Remove all the dependent modules
+Get-InstalledModule Microsoft.Graph.Beta.* | uninstall-module
+
+# Update the authentication module from 0.1.4 to 0.1.5
+Install-Module Microsoft.Graph.Authentication -Repository PSGallery -force
 
-# Installing the Graph PowerShell module for the Beta API 
-Install-module Microsoft.Graph.Beta -Repository GraphPowerShell

samples/1-FindCommands.ps1

@@ -1,12 +1,12 @@
 
 # Modules Current Available
-Find-Module -Repository GraphPowerShell | Select-Object Name
+Find-module Microsoft.Graph* | Select-Object Name
 
 # Commands Available for licenses 
-Get-Command -Module Microsoft.Graph.Beta* *license*
+Get-Command -Module Microsoft.Graph* *license*
 
 # Commands Available for Outlook tasks 
-Get-Command -Module Microsoft.Graph.Beta* *OutlookTask*
+Get-Command -Module Microsoft.Graph* *OutlookTask*
 
 # Commands Available for Teams  
-Get-Command -Module Microsoft.Graph.Beta* *Team*
+Get-Command -Module Microsoft.Graph* *Team*