Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Get-AzureEnvironment

Updated: May 12, 2014

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Get-AzureEnvironment

Gets Azure environments

Syntax

Parameter Set: Default
Get-AzureEnvironment [[-Name] <String> ] [ <CommonParameters>]




Detailed Description

The Get-AzureEnvironment cmdlet gets the Azure environments that are available to Windows PowerShell.

An Azure environment an independent deployment of Microsoft Azure, such as AzureCloud for global Azure and AzureChinaCloud for Azure operated by 21Vianet in China. You can also create on-premises Azure environments by using Azure Pack and the WAPack cmdlets. For more information, see Azure Pack (http://www.microsoft.com/en-us/server-cloud/products/windows-azure-pack/default.aspx).

The Get-AzureEnvironment cmdlet gets environments from your subscription data file, not from Azure. If the subscription data file is outdated, run the Add-AzureAccount or Import-PublishSettingsFile cmdlet to refresh it.

This topic describes the cmdlet in the 0.8.1 version of the Microsoft Azure PowerShell module. To find out the version of the module you're using, from the Azure PowerShell console, type (get-module azure).version.

Parameters

-Name<String>

Gets only the specified environment. Type the environment name. The parameter value is case-sensitive. Wildcard characters are not permitted.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

    You can pipe input to this cmdlet by property name, but not by value.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • System.Management.Automation.PSCustomObject

    By default, Get-AzureEnvironment returns a custom object.


  • Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

    When you run Get-AzureEnvironment with the Name parameter, it returns a WindowsAzureEnvironment object.


Examples

Example 1: Get all environments

This command gets all environments that are available to Windows PowerShell.


PS C:\> Get-AzureEnvironment
EnvironmentName               ServiceEndpoint               ResourceManagerEndpoint       PublishSettingsFileUrl
--------------- --------------- ----------------------- ----------------------
AzureCloud https://management.core.wi... https://management.azure.com/ http://go.microsoft.com/fw...
AzureChinaCloud https://management.core.ch... https://not-supported-serv... http://go.microsoft.com/fw...

Example 2: Get an environment by name

This example gets the AzureCloud environment.


PS C:\> Get-AzureEnvironment -Name AzureCloud
Name                          : AzureCloud
PublishSettingsFileUrl : http://go.microsoft.com/fwlink/?LinkID=301775
ServiceEndpoint : https://management.core.windows.net/
ResourceManagerEndpoint : https://management.azure.com/
ManagementPortalUrl : http://go.microsoft.com/fwlink/?LinkId=254433
ActiveDirectoryEndpoint : https://login.windows.net/
ActiveDirectoryCommonTenantId : common
StorageEndpointSuffix : core.windows.net
StorageBlobEndpointFormat : {0}://{1}.blob.core.windows.net/
StorageQueueEndpointFormat : {0}://{1}.queue.core.windows.net/
StorageTableEndpointFormat : {0}://{1}.table.core.windows.net/
GalleryEndpoint : https://gallery.azure.com/

Example 3: Get all properties of all environments

This command gets all properties of all environments.

The command uses the Get-AzureEnvironment cmdlet to get all Azure environments for this account. Then, it uses the Foreach-Object cmdlet to run a Get-AzureEnvironment command with the Name parameter on each environment. The value of the Name parameter is the EnvironmentName property of each environment.

Without parameters, Get-AzureEnvironment gets only selected properties of an environment.


PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}

Related topics

Show:
© 2015 Microsoft