Get-AdminPowerAppConnection

Returns information about one or more connections.

Syntax

PowerShell
Get-AdminPowerAppConnection
   [[-Filter] <String[]>]
   [-EnvironmentName <String>]
   [-CreatedBy <String>]
   [-ApiVersion <String>]
   [<CommonParameters>]
PowerShell
Get-AdminPowerAppConnection
   [[-Filter] <String[]>]
   [-EnvironmentName <String>]
   -CreatedBy <String>
   [-ApiVersion <String>]
   [<CommonParameters>]
PowerShell
Get-AdminPowerAppConnection
   [-EnvironmentName <String>]
   -ConnectorName <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

PowerShell
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

PowerShell
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

PowerShell
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

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

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

EXAMPLE 5

PowerShell
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

PowerShell
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

PowerShell
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.

Type:String
Position:Named
Default value:2016-11-01
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectorName

Limit connections returned to those of a specified connector.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CreatedBy

Limit connections returned to those created by by the specified user (email or AAD object id).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-EnvironmentName

Limit connections returned to those in a specified environment.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

Finds connection matching the specified filter (wildcards supported).

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False