Powershell/Private/JumpCloudFunctions/Get-MtpOrganization.ps1
|
function Get-MtpOrganization { [CmdletBinding()] [OutputType([System.Object[]])] param ( [Parameter(Mandatory = $true)] [System.String] $apiKey, [Parameter()] [System.String] $orgID, [parameter()] [switch] $inputType ) begin { # initialize variable to record whether or not the API key belongs to a MPT administrator $mtpAdmin = $false # set headers $skip = 0 $limit = 100 $paginate = $true $Headers = @{ 'Content-Type' = 'application/json'; 'Accept' = 'application/json'; 'x-api-key' = "$($apiKey)"; } $results = @() $regions = @("US", "EU", "IN") $currentRegion = $null $Request = $null # Found correct region foreach ($region in $regions) { Set-JcUrl -Region $region $baseUrl = "$($global:JCUrl)/api/organizations/$($orgID)" try { $Request = Invoke-WebRequest -Uri "$($baseUrl)?limit=1&skip=0" -Method Get -Headers $Headers -UseBasicParsing } catch { continue; } $currentRegion = $region break; } if ([string]::IsNullOrEmpty($currentRegion)) { throw "Failed to connect to JumpCloud API endpoints. Please verify network connectivity and that the provided API Key is valid. Global URI: $($global:JCUrl)" } if ($orgID) { Write-ToLog -Message "OrgID specified, attempting to validate org..." -Level Verbose -Step "Get-MtpOrganization" try { $Request = Invoke-WebRequest -Uri "$($baseUrl)?limit=$($limit)&skip=$($skip)" -Method Get -Headers $Headers -UseBasicParsing } catch { throw "Failed to connect to JumpCloud API endpoints. Please verify network connectivity and that the provided API Key and OrgID are valid. Global URI: $($global:JCUrl) $($_.Exception.Message)" } $Content = $Request.Content | ConvertFrom-Json $results += $Content } else { $baseUrl = "$($global:JCUrl)/api/organizations" Write-ToLog -Message "No OrgID specified, attempting to search for valid orgs..." -Level Verbose -Step "Get-MtpOrganization" while ($paginate) { try { $Request = Invoke-WebRequest -Uri "$($baseUrl)?limit=$($limit)&skip=$($skip)" -Method Get -Headers $Headers -UseBasicParsing } catch { throw "Failed to connect to JumpCloud API endpoints. Please verify network connectivity and that the provided API Key is valid. $($_.Exception.Message)" } $Content = $Request.Content | ConvertFrom-Json $results += $Content.results if ($Content.results.Count -eq $limit) { $skip += $limit } else { $paginate = $false } } } } process { # if there's only one org return found org, else prompt for selection if (($results.count -eq 1) -and ($($results._id))) { Write-ToLog -Message "API Key Validated`nOrgName: $($results.DisplayName)" -Level Verbose -Step "Get-MtpOrganization" $orgs = $results._id, $results.DisplayName } elseif (($results.count -gt 1)) { Write-ToLog -Message "Found $($results.count) orgs with the specified API Key" -Level Verbose -Step "Get-MtpOrganization" # Set the MTP Admin variable to true $mtpAdmin = $true # initial prompt for MTP selection switch ($inputType) { $true { Write-ToLog -Message "Prompting for MTP Admin Selection" -Level Verbose -Step "Get-MtpOrganization" $orgs = Show-MtpSelection -Orgs $results $orgs = $orgs.Id, $orgs.DisplayName Write-ToLog -Message "API Key Validated`nOrgName: $($orgs[1])" -Level Verbose -Step "Get-MtpOrganization" } default { Write-ToLog -Message "API Key appears to be a MTP Admin Key. Please specify the JumpCloudOrgID Parameter and try again" -Level Verbose -Step "Get-MtpOrganization" throw "API Key appears to be a MTP Admin Key. Please specify the JumpCloudOrgID Parameter and try again" } } } else { Write-ToLog -Message "No orgs matched provided API Key" -Level Verbose -Step "Get-MtpOrganization" $orgs = $false } } end { # $orgs returned as an object [0]=id [1]=displayName # mtpAdmin returned as boolean return $orgs, $mtpAdmin } } |