Delen via

Get-AzureEnvironment

  • Referentie
Module:
Azure

Haalt Azure-omgevingen op

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

Get-AzureEnvironment
   [-Name <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

De cmdlet Get-AzureEnvironment haalt de Azure-omgevingen op die beschikbaar zijn voor Windows PowerShell.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie).

De cmdlet Get-AzureEnvironment haalt omgevingen op uit uw abonnementsgegevensbestand, niet uit Azure. Als het abonnementsgegevensbestand verouderd is, voert u de cmdlet Add-AzureAccount of Import-PublishSettingsFile uit om het te vernieuwen.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Alle omgevingen ophalen

PS C:\> Get-AzureEnvironment

EnvironmentName               ServiceEndpoint               ResourceManagerEndpoint       PublishSettingsFileUrl
---------------               ---------------               -----------------------       ----------------------

AzureCloud                    https://management.core.wi... https://management.azure.com/ https://go.microsoft.com/fw...
AzureChinaCloud               https://management.core.ch... https://not-supported-serv... https://go.microsoft.com/fw...

Met deze opdracht worden alle omgevingen ophaalt die beschikbaar zijn voor Windows PowerShell.

Voorbeeld 2: Een omgeving ophalen op naam

PS C:\> Get-AzureEnvironment -Name AzureCloud

Name                          : AzureCloud

PublishSettingsFileUrl        : https://go.microsoft.com/fwlink/?LinkID=301775

ServiceEndpoint               : https://management.core.windows.net/

ResourceManagerEndpoint       : https://management.azure.com/

ManagementPortalUrl           : https://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/

In dit voorbeeld wordt de AzureCloud-omgeving ophaalt.

Voorbeeld 3: Alle eigenschappen van alle omgevingen ophalen

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

Met deze opdracht worden alle eigenschappen van alle omgevingen ophaalt.

De opdracht maakt gebruik van de Cmdlet Get-AzureEnvironment om alle Azure-omgevingen voor dit account op te halen. Vervolgens wordt de Cmdlet Foreach-Object gebruikt om een Get-AzureEnvironment-opdracht uit te voeren met de parameter Name in elke omgeving. De waarde van de parameter Name is de eigenschap EnvironmentName van elke omgeving.

Zonder parameters krijgt Get-AzureEnvironment alleen geselecteerde eigenschappen van een omgeving.

Parameters

-Name

Hiermee haalt u alleen de opgegeven omgeving op. Typ de naam van de omgeving. De parameterwaarde is hoofdlettergevoelig. Jokertekens zijn niet toegestaan.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

PSCustomObject

Get-AzureEnvironment retourneert standaard een aangepast object.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Wanneer u Get-AzureEnvironment uitvoert met de parameter Name, wordt een WindowsAzureEnvironment-object geretourneerd.