Share via


Get-AdminPowerAppConnector

Returns information about one or more custom connectors.

Syntax

Filter (Default)

Get-AdminPowerAppConnector
    [[-Filter] <String[]>]
    [-EnvironmentName <String>]
    [-CreatedBy <String>]
    [-ApiVersion <String>]
    [<CommonParameters>]

User

Get-AdminPowerAppConnector
    [[-Filter] <String[]>]
    -CreatedBy <String>
    [-EnvironmentName <String>]
    [-ApiVersion <String>]
    [<CommonParameters>]

Connector

Get-AdminPowerAppConnector
    -ConnectorName <String>
    [-EnvironmentName <String>]
    [-ApiVersion <String>]
    [<CommonParameters>]

Description

The Get-AdminPowerAppConnector cmdlet looks up information about one or more custom connectors depending on parameters. Use Get-Help Get-AdminPowerAppConnector -Examples for more detail.

Examples

EXAMPLE 1

Get-AdminPowerAppConnector

Returns all custom connector from all environments where the calling user is an Environment Admin. For Global admins, this will search across all environments in the tenant.

EXAMPLE 2

Get-AdminPowerAppConnector *customapi*

Returns all custom connectors with the text "customapi" in the name/display name from all environments where the calling user is an Environment Admin For Global admins, this will search across all environments in the tenant.

EXAMPLE 3

Get-AdminPowerAppConnector -CreatedBy foo@bar.onmicrosoft.com

Returns all apps created by the user with an email address of "foo@bar.onmicrosoft.com" from all environment where the calling user is an environment admin. For global admins, this will search across all environments in the tenant.

EXAMPLE 4

Get-AdminPowerAppConnector -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f

Finds custom connectors within the 0fc02431-15fb-4563-a5ab-8211beb2a86f environment.

EXAMPLE 5

Get-AdminPowerAppConnector -ConnectorName shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698

Finds all custom connectors created with name shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 from all environments where the calling user is an environment admin. For global admins, this searches across all environments in the tenant.

EXAMPLE 6

Get-AdminPowerAppConnector -ConnectorName shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f

Finds connections within the 0fc02431-15fb-4563-a5ab-8211beb2a86f environment that are created against the shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698.

EXAMPLE 7

Get-AdminPowerAppConnector *customapi* -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f

Finds all connections in environment 0fc02431-15fb-4563-a5ab-8211beb2a86f that contain the string "customapi" in their display name.

Parameters

-ApiVersion

The api version to call with. Default 2017-05-01

Parameter properties

Type:String
Default value:2017-05-01
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ConnectorName

Limit custom connectors returned to those of a specified connector.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Connector
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CreatedBy

Limit custom connectors returned to those created by the specified user (email or Microsoft Entra ID principal object ID).

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnvironmentName

Limit custom connectors returned to those in a specified environment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Filter

Finds custom connector matching the specified filter (wildcards supported).

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
User
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.