Get-AdminPowerAppConnection

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

Returns information about 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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

The Get-AdminPowerAppConnection cmdlet looks up information about one or more connections.

Examples

EXAMPLE 1

Get-AdminPowerAppConnection

Returns all connections 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-AdminPowerAppConnection *PowerApps*

Returns all connections with the text "PowerApps" in the 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-AdminPowerAppConnection -CreatedBy john@contoso.com

Returns all apps created by the user with an email of "john@contoso.com" from all environments where the calling user is an Environment Admin. For Global admins, this will search across all environments in the tenant.

EXAMPLE 4

Get-AdminPowerAppConnection -EnvironmentName [Guid]

Finds connections within the specified 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 will search across all environments in the tenant.

EXAMPLE 6

Get-AdminPowerAppConnection -ConnectorName shared_runtimeservice -EnvironmentName [Guid]

Finds connections within the specified environment that are created against the shared_runtimeservice (Dataverse) connector.

EXAMPLE 7

Get-AdminPowerAppConnection *Contoso* -EnvironmentName [Guid]

Finds all connections in the specified environment that contain the string "Contoso" in their display name.

Parameters

-ApiVersion

Version of Power Apps API to use.

Type:	String
Position:	Named
Default value:	2016-11-01
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
Accept pipeline input:	True
Accept wildcard characters:	False

-CreatedBy

Limit connections returned to those created by the specified user (email or Azure AD object ID).

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Filter

Finds connections matching the specified filter. Wildcards are supported.

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

Remove-AdminPowerAppConnection