Get-AzureEnvironment
Ruft Azure-Umgebungen ab
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
None
Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.
Ausgaben
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.