Get-PowerAppEnvironment

PowerApps: Retrieves PowerApps environments

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.PowerApps.PowerShell

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [pscredential]$PACredential,

    [string]$EnvironmentName,
    [string]$Filter,
    [switch]$CreatedByMe,
    [switch]$Default,
    [string]$ApiVersion,

    [ValidateSet('*', 'DisplayName', 'EnvironmentName', 'Location', 'CreatedTime', 'CreatedBy', 'IsDefault', 'LastModifiedTime', 'LastModifiedBy', 'Internal')]
    [string[]]$Properties = @('DisplayName', 'EnvironmentName', 'Location', 'LastModifiedTime', 'LastModifiedBy')
)

Process {
    try {
        ConnectPowerApps4Creators -PAFCredential $PACredential

        $getArgs = @{ ErrorAction = 'Stop' }

        if ($PSBoundParameters.ContainsKey('Filter')) {
            $getArgs.Add('Filter', $Filter)
            $getArgs.Add('CreatedByMe', $CreatedByMe)
        }
        elseif ($PSBoundParameters.ContainsKey('EnvironmentName')) {
            $getArgs.Add('EnvironmentName', $EnvironmentName)
        }
        else { $getArgs.Add('Default', $Default) }

        if ($PSBoundParameters.ContainsKey('ApiVersion')) { $getArgs.Add('ApiVersion', $ApiVersion) }

        $result = Get-PowerAppEnvironment @getArgs -ErrorAction Stop | Select-Object $Properties

        if ($null -ne $result) {
            foreach ($item in $result) {
                $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force
            }
        }
    }
    catch { throw }
    finally { DisconnectPowerApps4Creators }
}

Customize

PACredential pscredential

PowerApps credentials for authentication

EnvironmentName string

Find a specific environment

Filter string

Find environments by wildcard filter

CreatedByMe switch

Off

Show only environments created by the calling user

Default switch

Off

Find the default environment

ApiVersion string

API version to call

Properties string

Properties to retrieve. Use * for all.