Get-Connector

PowerApps: Retrieves connectors

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.PowerApps.PowerShell

[CmdletBinding(DefaultParameterSetName = "Filter")]
Param(
    [Parameter(Mandatory = $true, ParameterSetName = "Connector")]
    [Parameter(Mandatory = $true, ParameterSetName = "Filter")]
    [pscredential]$PACredential,

    [Parameter(Mandatory = $true, ParameterSetName = "Connector")]
    [string]$ConnectorName,

    [Parameter(Mandatory = $true, ParameterSetName = "Connector")]
    [string]$EnvironmentName,

    [Parameter(Mandatory = $true, ParameterSetName = "Filter")]
    [string]$Filter,

    [Parameter(ParameterSetName = "Filter")]
    [switch]$FilterNonCustomConnectors,

    [Parameter(ParameterSetName = "Connector")]
    [switch]$ReturnConnectorSwagger,

    [Parameter(ParameterSetName = "Filter")]
    [string]$Environment,

    [Parameter(ParameterSetName = "Filter")]
    [Parameter(ParameterSetName = "Connector")]
    [string]$ApiVersion,

    [Parameter(ParameterSetName = "Filter")]
    [Parameter(ParameterSetName = "Connector")]
    [ValidateSet('*', 'DisplayName', 'ConnectorName', 'ConnectorId', 'EnvironmentName', 'CreatedTime', 'Description', 'ApiDefinitions', 'Publisher', 'Source', 'Tier', 'Url', 'ChangedTime', 'ConnectionParameters', 'Swagger', 'WadlUrl', 'Internal')]
    [string[]]$Properties = @('DisplayName', 'Description', 'ConnectorName', 'ConnectorId', 'EnvironmentName', 'ChangedTime')
)

Process {
    try {
        ConnectPowerApps4Creators -PAFCredential $PACredential

        $getArgs = @{ ErrorAction = 'Stop' }

        if ($PSCmdlet.ParameterSetName -eq "Connector") {
            $getArgs.Add('ConnectorName', $ConnectorName)
            $getArgs.Add('EnvironmentName', $EnvironmentName)
            if ($PSBoundParameters.ContainsKey('ReturnConnectorSwagger')) { $getArgs.Add('ReturnConnectorSwagger', $ReturnConnectorSwagger) }
        }
        else {
            $getArgs.Add('Filter', $Filter)
            if ($PSBoundParameters.ContainsKey('Environment')) { $getArgs.Add('EnvironmentName', $Environment) }
            if ($PSBoundParameters.ContainsKey('FilterNonCustomConnectors')) { $getArgs.Add('FilterNonCustomConnectors', $FilterNonCustomConnectors) }
        }

        if ($PSBoundParameters.ContainsKey('ApiVersion')) { $getArgs.Add('ApiVersion', $ApiVersion) }

        $result = Get-PowerAppConnector @getArgs -ErrorAction Stop | Select-Object $Properties

        if ($null -ne $result) {
            foreach ($item in $result) {
                $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force
            }
        }
    }
    catch { throw }
    finally { DisconnectPowerApps4Creators }
}

Customize

PACredential pscredential

PowerApps credentials for authentication

ConnectorName string

Retrieve a specific connector by name

EnvironmentName string

Environment containing the connector

Filter string

Filter connectors by name or display name (wildcards supported)

FilterNonCustomConnectors switch

Off

Exclude Microsoft-built shared connectors

ReturnConnectorSwagger switch

Off

Include Swagger and runtime URLs (requires ConnectorName)

Environment string

Limit to connectors in a specific environment (for Filter mode)

ApiVersion string

API version to call

Properties string

Properties to retrieve. Use * for all.