Dela via

Get-AzureEnvironment

  • Referens
Modul:
Azure

Hämtar Azure-miljöer

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Syntax

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

Description

Cmdleten Get-AzureEnvironment hämtar de Azure-miljöer som är tillgängliga för Windows PowerShell.

En Azure-miljö en oberoende distribution av Microsoft Azure, till exempel AzureCloud för globala Azure och AzureChinaCloud för Azure som drivs av 21Vianet i Kina. Du kan också skapa lokala Azure-miljöer med hjälp av Azure Pack och WAPack-cmdletarna. Mer information finns i Azure Pack).

Cmdleten Get-AzureEnvironment hämtar miljöer från din prenumerationsdatafil, inte från Azure. Om prenumerationsdatafilen är inaktuell kör du cmdleten Add-AzureAccount eller Import-PublishSettingsFile för att uppdatera den.

Det här avsnittet beskriver cmdleten i 0.8.10-versionen av Microsoft Azure PowerShell-modulen. Om du vill hämta den version av modulen som du använder skriver (Get-Module -Name Azure).Versiondu i Azure PowerShell-konsolen .

Exempel

Exempel 1: Hämta alla miljöer

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

Det här kommandot hämtar alla miljöer som är tillgängliga för Windows PowerShell.

Exempel 2: Hämta en miljö efter namn

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/

Det här exemplet hämtar AzureCloud-miljön.

Exempel 3: Hämta alla egenskaper för alla miljöer

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

Det här kommandot hämtar alla egenskaper för alla miljöer.

Kommandot använder cmdleten Get-AzureEnvironment för att hämta alla Azure-miljöer för det här kontot. Sedan använder den cmdleten Foreach-Object för att köra ett Get-AzureEnvironment-kommando med parametern Namn i varje miljö. Värdet för parametern Namn är egenskapen EnvironmentName för varje miljö.

Utan parametrar hämtar Get-AzureEnvironment endast valda egenskaper för en miljö.

Parametrar

-Name

Hämtar endast den angivna miljön. Ange miljönamnet. Parametervärdet är skiftlägeskänsligt. Jokertecken tillåts inte.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan skicka indata till den här cmdleten efter egenskapsnamn, men inte efter värde.

Utdata

PSCustomObject

Som standard returnerar Get-AzureEnvironment ett anpassat objekt.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

När du kör Get-AzureEnvironment med parametern Namn returneras ett WindowsAzureEnvironment-objekt .