Get-AdminPowerAppConnection

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

Returns information about one or more connections.

Syntax

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

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

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

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.

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