private/Test-MSGraphRequirements.ps1
|
<#
.DESCRIPTION Test and verify that Microsoft Graph requirements are met for the Admintoolbox.Office365 Module .PARAMETER Scopes Specify an array of scopes that must be imported prior to the function continueing. .EXAMPLE Test-MSGraphRequirements -scopes 'Reports.Read.All' Used in the function Get-msgMFAStatus .EXAMPLE Test-MSGraphRequirements -Scopes 'openid', 'email', 'profile', 'user.read' Test requirements needed to sign in with the Microsoft.Graph.Authentication module. #> function Test-MSGraphRequirements { [CmdletBinding()] Param ( [Parameter(Mandatory = $false)][string[]]$scopes ) # Test for required module and prompt for install $query = Get-Module Microsoft.Graph -ListAvailable if ($null -eq $query) { try { Import-Module Microsoft.Graph.Authentication -ErrorAction Stop } catch { Write-Warning "[-] Required Microsoft Graph Module not found. First install the needed module or abort the function using ctrl + c" Install-Module -Name Microsoft.Graph -AllowPrerelease -Force -AllowClobber } } # Sets the MSGraph profile to beta if not already set. This is required by some functions if ((Get-MgProfile).name -ne 'beta') { Select-MgProfile -Name "beta" -Verbose } # Test that required scopes are imported and import them if they are not. $importedscopes = (Get-MgContext).scopes foreach ($scope in $scopes) { if ($importedscopes -notcontains $scope) { Write-Output "[+] Apply and/or Register required scopes." Write-Output "[?] If terminal is not progressing, check your web browser for a login and a possible app registration prompt." Connect-MgGraph -Scopes $scopes } } } |