Add Get-O365CopilotPin function and example script for retrieving Cop…

…ilot PIN

Examples/GetO365CopilotPin.ps1

@@ -0,0 +1,8 @@
+Import-Module .\O365Essentials.psd1 -Force
+
+# This makes a connection to Office 365 tenant
+# since we don't want to save the data we null it out
+# keep in mind that if there's an MFA you would be better left without Credentials and just let it prompt you
+$null = Connect-O365Admin -Verbose
+
+Get-O365CopilotPin -Verbose

Public/Get-O365CopilotPin.ps1

@@ -0,0 +1,9 @@
+function Get-O365CopilotPin {
+    [cmdletbinding()]
+    param(
+        [alias('Authorization')][System.Collections.IDictionary] $Headers
+    )
+    $Uri = "https://admin.microsoft.com/admin/api/settings/company/copilotpolicy/pin"
+    $OutputSettings = Invoke-O365Admin -Uri $Uri -Headers $Headers -Method GET
+    $OutputSettings
+}