Share via


Get-AdminPowerAppConnection

Returns information about one or more connections.

Syntax

Filter (Default)

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

User

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

Connector

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

Description

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

Examples

EXAMPLE 1

Get-AdminPowerAppConnection

Returns all connections from all environments where the calling user is an environment admin. For global admins, this searches across all environments in the tenant.

EXAMPLE 2

Get-AdminPowerAppConnection *PowerApps*

Returns all connection with the text "PowerApps" in the display name from all environments where the calling user is an environment admin. For global admins, this searches across all environments in the tenant.

EXAMPLE 3

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

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

EXAMPLE 4

Get-AdminPowerAppConnection -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Finds connections within the 3c2f7648-ad60-4871-91cb-b77d7ef3c239 environment.

EXAMPLE 5

Get-AdminPowerAppConnection -ConnectorName shared_runtimeservice

Finds all connections created against the shared_runtimeservice Dataverse connector 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-AdminPowerAppConnection -ConnectorName shared_runtimeservice -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Finds connections within the 3c2f7648-ad60-4871-91cb-b77d7ef3c239 environment that are created against the shared_runtimeservice Dataverse connector.

EXAMPLE 7

Get-AdminPowerAppConnection *Foobar* -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Finds all connections in environment 3c2f7648-ad60-4871-91cb-b77d7ef3c239 that contain the string "Foobar" in their display name.

Parameters

-ApiVersion

The api version to call with.

Parameter properties

Type:String
Default value:2016-11-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 connections 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 connections returned to those created by by the specified user (email or AAD 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 connections 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 connection 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.