Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Get-EnvironmentRegion

Retrieves the region where the specified environment is deployed.

Syntax

Default (Default)

Get-EnvironmentRegion
 [-EnvironmentId] <String>
 [[-TenantId] <String>]
 [[-Endpoint] <PPEndpoint>]
 [-ForceAuth]
 [<CommonParameters>]

Description

The Get-EnvironmentRegion cmdlet retrieves the region where the specified environment is deployed. The region is the Power Platform region, but it's aligned with an Azure region.

Examples

EXAMPLE 1

Get-EnvironmentRegion -EnvironmentId "00000000-0000-0000-0000-000000000000"

Retrieves the region where the specified environment is deployed using default settings.

EXAMPLE 2

Get-EnvironmentRegion -EnvironmentId "00000000-0000-0000-0000-000000000000" -Endpoint usgovhigh

Retrieves the region where the specified environment is deployed for an environment in the US Government High cloud.

Parameters

-Endpoint

The Power Platform endpoint to connect to. Defaults to 'prod'.

Parameter properties

Type:PPEndpoint
Default value:Prod
Accepted values:unknown, tip1, tip2, prod, usgovhigh, dod, china
Supports wildcards:False
DontShow:False

Parameter sets

-EnvironmentId

The Id of the environment to get the region for.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

-ForceAuth

Force re-authentication to Azure.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

-TenantId

The id of the tenant that the environment belongs to.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

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.

Outputs

System.String

A string representing the region of the environment.