Public/FlyConnectApi.ps1

<#
.SYNOPSIS
 
Connect to Fly Public API
 
.DESCRIPTION
 
Connect to Fly Public API
 
.PARAMETER Url
The public API URL varies with your data center, you can find it in Fly user guide.
 
.PARAMETER ClientId
The application (client) ID you have retrieved from AvePoint Online Service App registrations.
 
.PARAMETER Certificate
The corresponding .pfx certificate file of the .cer certificate you used while registering the AvePoint app.
 
.OUTPUTS
 
None
#>

function Connect-Fly {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory = $true)]
        [String]
        ${Url},
        [Parameter(Mandatory = $true)]
        [String]
        ${ClientId},
        [Parameter(Mandatory = $true)]
        [Alias("Cert")]
        [System.Security.Cryptography.X509Certificates.X509Certificate2]
        ${Certificate},
        [Parameter(Mandatory = $false)]
        [String]
        ${IdentityServiceUri}
    )
    PROCESS {
        if (!$IdentityServiceUri) {
            $IdentityServiceUri = 'https://identity.avepointonlineservices.com'
            if ($Url -eq 'https://graph-gov.avepointonlineservices.com/fly') {
                $IdentityServiceUri = 'https://identity-gov.avepointonlineservices.com'
            }
            elseif ($Url.StartsWith('https://graph-public.sharepointguild.com/')) {
                $IdentityServiceUri = 'https://identity-public.sharepointguild.com'
            }
            elseif ($Url -eq 'https://flyusgovapi.online15.net') {
                $IdentityServiceUri = 'https://identity.online15.net'
            }
            elseif ($Url -eq 'https://flyapi.online15.net') {
                $IdentityServiceUri = 'https://identity-stage.online15.net'
            }
        }
        $Configuration = Get-FlyConfiguration
        $Token = Get-IdentityServiceToken -IdentityServiceUri $IdentityServiceUri -Scope fly.graph.readwrite.all -ClientId $ClientId -Cert $Certificate
        $CustomerId = (Convert-JWTtoken $Token).realm
        if ($Configuration.containsKey("CustomerId") -and $CustomerId -ne $Configuration["CustomerId"]) {
            $continue = Read-Host "Are you sure you want to connect to another tenant? (Y/N)"
            if ($continue -eq "N") {
                return;
            }
        }
        $Configuration["BaseUrl"] = $Url
        $Configuration["AccessToken"] = $Token
        $Configuration["IdentityServiceUri"] = $IdentityServiceUri
        $Configuration["ClientId"] = $ClientId
        $Configuration["CustomerId"] = $CustomerId
        $Configuration["Certificate"] = $Certificate
    }
}

<#
.SYNOPSIS
 
Disconnect from Fly Public API
 
.DESCRIPTION
 
Disconnect from Fly Public API
 
.OUTPUTS
 
None
#>

function Disconnect-Fly {
    [CmdletBinding()]
    Param()
    PROCESS {
        $Configuration = Get-FlyConfiguration
        $Configuration["BaseUrl"] = $null
        $Configuration["AccessToken"] = $null
        $Configuration["IdentityServiceUri"] = $null
        $Configuration["ClientId"] = $null
        $Configuration["CustomerId"] = $null
        $Configuration["Certificate"] = $null
    }
}