Freigeben über

Get-AzureEnvironment

  • Referenz
Modul:
Azure

Ruft Azure-Umgebungen ab

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureEnvironment ruft die Azure-Umgebungen ab, die für Windows PowerShell verfügbar sind.

Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack).

Das Cmdlet "Get-AzureEnvironment " ruft Umgebungen aus Ihrer Abonnementdatendatei ab, nicht aus Azure. Wenn die Abonnementdatendatei veraltet ist, führen Sie das Cmdlet Add-AzureAccount oder Import-PublishSettingsFile aus, um sie zu aktualisieren.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Abrufen aller Umgebungen

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...

Dieser Befehl ruft alle Umgebungen ab, die für Windows PowerShell verfügbar sind.

Beispiel 2: Abrufen einer Umgebung anhand des Namens

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 diesem Beispiel wird die AzureCloud-Umgebung angezeigt.

Beispiel 3: Abrufen aller Eigenschaften aller Umgebungen

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

Dieser Befehl ruft alle Eigenschaften aller Umgebungen ab.

Der Befehl verwendet das Cmdlet Get-AzureEnvironment , um alle Azure-Umgebungen für dieses Konto abzurufen. Anschließend wird das Cmdlet Foreach-Object verwendet, um einen Get-AzureEnvironment-Befehl mit dem Parameter Name in jeder Umgebung auszuführen. Der Wert des Name-Parameters ist die EnvironmentName-Eigenschaft jeder Umgebung.

Ohne Parameter ruft Get-AzureEnvironment nur ausgewählte Eigenschaften einer Umgebung ab.

Parameter

-Name

Ruft nur die angegebene Umgebung ab. Geben Sie den Namen der Umgebung ein. Bei dem Parameterwert wird die Groß-/Kleinschreibung beachtet. Platzhalterzeichen sind nicht zulässig.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

PSCustomObject

Standardmäßig gibt Get-AzureEnvironment ein benutzerdefiniertes Objekt zurück.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Wenn Sie Get-AzureEnvironment mit dem Parameter Name ausführen, wird ein WindowsAzureEnvironment-Objekt zurückgegeben.