New graph helper (#4617)

* Update use of GraphHelper

* Renamed GraphHelper to ApiRequestHelper

* Simplified examples

* simplified URL

* renamed file and updated url handling

* Nightly publish to PowerShell Gallery

* Update to version checker

* Rewrote to use tracelog and added Format-PnPTraceLog cmdlet

* Added automatic login: more work to do

* switched to settings.json

* Nightly publish to PowerShell Gallery

* Add ExtendPermissionsToUnprotectedFiles parameter to Set-PnPTenant cmdlet (#4602)

Co-authored-by: Gautam Sheth <[email protected]>

* Nightly publish to PowerShell Gallery

* Added deprecation notice on the SharePoint Mail API

* Nightly publish to PowerShell Gallery

* Added paramset for working with doclibs

* Finalized implementation of Get-PnPFolderItem

* Added same logic to Get-PnPFileInFolder and Get-PnPFolderInFolder as well

* Added changelog entry

* moved from cachesettings.json to settings.json

* Updated handling of tracelog

* refactored private field name

* Updated tracelogging

* renamed file

* Updated tracelogging cmdlets

* Nightly publish to PowerShell Gallery

* removed unneeded include

* Removed unused usings

* Fixed using

* Changed warning message

* Updated cleaning

* Updated cache enabled message

* Fixed JSON escaping in log message

---------

Co-authored-by: Gautam Sheth <[email protected]>
Co-authored-by: Gautam Sheth <[email protected]>
Co-authored-by: Koen Zomers <[email protected]>

Author: 4 people

documentation/Invoke-PnPGraphMethod.md

@@ -96,48 +96,48 @@ Set the new displayName of the group with a Patch request.
 
 ### Example 4
 ```powershell
-Invoke-PnPGraphMethod -Url "v1.0/users?$filter=accountEnabled ne true&$count=true" -Method Get -ConsistencyLevelEventual
+Invoke-PnPGraphMethod -Url "users?`$filter=accountEnabled ne true&`$count=true" -Method Get -ConsistencyLevelEventual
 ```
 
 Get users with advanced query capabilities. Use of -ConsistencyLevelEventual.
 
 ### Example 5
 ```powershell
-Invoke-PnPGraphMethod -Url "https://graph.microsoft.com/v1.0/users"
+Invoke-PnPGraphMethod -Url "users"
 ```
 
 Performs a GET request to retrieve users from the Microsoft Graph API using the full URL.
 
 ### Example 6
 ```powershell
-Invoke-PnPGraphMethod -Url "https://graph.microsoft.com/v1.0/users/[email protected]/photo/`$value" -OutFile c:\temp\photo.jpg
+Invoke-PnPGraphMethod -Url "users/[email protected]/photo/`$value" -OutFile c:\temp\photo.jpg
 ```
 
 Downloads the user profile photo of the specified user to the specified file.
 
 ### Example 7
 ```powershell
-Invoke-PnPGraphMethod -Url "https://graph.microsoft.com/v1.0/users/[email protected]/photo/`$value" -OutStream | Add-PnPFile -FileName user.jpg -Folder "Shared Documents"
+Invoke-PnPGraphMethod -Url "users/[email protected]/photo/`$value" -OutStream | Add-PnPFile -FileName user.jpg -Folder "Shared Documents"
 ```
 
 Takes the user profile photo of the specified user and uploads it to the specified library in SharePoint Online.
 
 ### Example 8
 ```powershell
-$task = Invoke-PnPGraphMethod -Url "https://graph.microsoft.com/v1.0/planner/tasks/23fasefxcvzvsdf32e" # retrieve the task so we can figure out the etag which is needed to update the task
+$task = Invoke-PnPGraphMethod -Url "planner/tasks/23fasefxcvzvsdf32e" # retrieve the task so we can figure out the etag which is needed to update the task
 $etag = $task.'@odata.etag'
 $headers = @{"If-Match"=$etag} 
 $content = @{"title"="My new task title"}
-Invoke-PnPGraphMethod -Url "https://graph.microsoft.com/v1.0/planner/tasks/23fasefxcvzvsdf32e" -Method PATCH -Content $content -AdditionalHeaders $headers
+Invoke-PnPGraphMethod -Url "planner/tasks/23fasefxcvzvsdf32e" -Method PATCH -Content $content -AdditionalHeaders $headers
 ```
 
 This example retrieves a Planner task to find the etag value which is required to update the task. In order to update the task through call to the Microsoft Graph API we need to include an If-Match header with the value of the etag. It then creates the content to update, in this case the title of the task, and calls the PATCH method on the Graph end-point to update the specific task.
 
 ### EXAMPLE 9
 ```powershell
 $batch = New-PnPBatch -RetainRequests
-Invoke-PnPSPRestMethod -Method Get -Url "https://graph.microsoft.com/v1.0/users" -Batch $batch
-Invoke-PnPSPRestMethod -Method Get -Url "https://graph.microsoft.com/v1.0/groups" -Batch $batch
+Invoke-PnPSPRestMethod -Method Get -Url "users" -Batch $batch
+Invoke-PnPSPRestMethod -Method Get -Url "groups" -Batch $batch
 $response = Invoke-PnPBatch $batch -Details
 $response
 ```

src/Commands/Admin/AddHomeSite.cs

@@ -2,9 +2,6 @@
 using Microsoft.SharePoint.Client;
 using PnP.PowerShell.Commands.Base;
 using System.Management.Automation;
-using PnP.PowerShell.Commands.Base.PipeBinds;
-using PnP.Core.Model;
-using System;
 
 namespace PnP.PowerShell.Commands.Admin
 {

src/Commands/Admin/AddHubToHubAssociation.cs

@@ -1,9 +1,7 @@
 using Microsoft.Online.SharePoint.TenantAdministration;
 using Microsoft.SharePoint.Client;
-
 using PnP.PowerShell.Commands.Base;
 using System.Management.Automation;
-using PnP.PowerShell.Commands.Base.PipeBinds;
 using System;
 
 namespace PnP.PowerShell.Commands.Admin

src/Commands/Admin/AddOrgAssetsLibrary.cs

@@ -1,5 +1,4 @@
 using Microsoft.SharePoint.Client;
-
 using PnP.PowerShell.Commands.Base;
 using System.Management.Automation;
 using Microsoft.Online.SharePoint.TenantAdministration;

src/Commands/Admin/GetContainer.cs

@@ -3,7 +3,6 @@
 using Microsoft.SharePoint.Client;
 using PnP.PowerShell.Commands.Base;
 using PnP.PowerShell.Commands.Base.PipeBinds;
-using PnP.PowerShell.Commands.Model.SharePoint;
 using System;
 using System.Collections.Generic;
 using System.Management.Automation;

src/Commands/Admin/GetContainerType.cs

@@ -1,9 +1,6 @@
 using Microsoft.Online.SharePoint.TenantAdministration;
 using Microsoft.SharePoint.Client;
 using PnP.PowerShell.Commands.Base;
-using PnP.PowerShell.Commands.Base.PipeBinds;
-using PnP.PowerShell.Commands.Utilities;
-using System;
 using System.Collections.Generic;
 using System.Management.Automation;
 

src/Commands/Admin/GetDeletedContainer.cs

@@ -1,9 +1,6 @@
 using Microsoft.Online.SharePoint.TenantAdministration;
 using Microsoft.SharePoint.Client;
 using PnP.PowerShell.Commands.Base;
-using PnP.PowerShell.Commands.Base.PipeBinds;
-using PnP.PowerShell.Commands.Utilities;
-using System;
 using System.Collections.Generic;
 using System.Management.Automation;
 

src/Commands/Admin/GetHubSite.cs

@@ -1,5 +1,4 @@
 using Microsoft.SharePoint.Client;
-
 using PnP.PowerShell.Commands.Base;
 using PnP.PowerShell.Commands.Base.PipeBinds;
 using System.Management.Automation;

src/Commands/Admin/GetStorageEntity.cs

@@ -1,5 +1,4 @@
-using System.Linq;
-using System.Management.Automation;
+using System.Management.Automation;
 using Microsoft.SharePoint.Client;
 using PnP.PowerShell.Commands.Enums;
 using System.Collections.Generic;

src/Commands/Admin/GetTenant.cs

@@ -1,5 +1,4 @@
 using Microsoft.SharePoint.Client;
-
 using PnP.PowerShell.Commands.Base;
 using System.Management.Automation;
 using PnP.PowerShell.Commands.Model;