Sdílet prostřednictvím

Get-AzureEnvironment

  • Reference
Modul:
Azure

Získá prostředí Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Description

Rutina Get-AzureEnvironment získá prostředí Azure, která jsou k dispozici pro Windows PowerShell.

Prostředí Azure nezávislé nasazení Microsoft Azure, jako je AzureCloud pro globální Azure a AzureChinaCloud pro Azure provozované společností 21Vianet v Číně. Místní prostředí Azure můžete vytvořit také pomocí azure Packu a rutin WAPacku. Další informace najdete v tématu Azure Pack).

Rutina Get-AzureEnvironment získává prostředí z datového souboru předplatného, nikoli z Azure. Pokud je datový soubor předplatného zastaralý, aktualizujte ho spuštěním rutiny Add-AzureAccount nebo Import-PublishSettingsFile .

Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell. Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .

Příklady

Příklad 1: Získání všech prostředí

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

Tento příkaz získá všechna prostředí, která jsou k dispozici pro Windows PowerShell.

Příklad 2: Získání prostředí podle názvu

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/

Tento příklad získá prostředí AzureCloud.

Příklad 3: Získání všech vlastností všech prostředí

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

Tento příkaz získá všechny vlastnosti všech prostředí.

Tento příkaz používá rutinu Get-AzureEnvironment k získání všech prostředí Azure pro tento účet. Pak pomocí rutiny Foreach-Object spustí příkaz Get-AzureEnvironment s parametrem Name v každém prostředí. Hodnota parametru Name je vlastnost EnvironmentName každého prostředí.

Bez parametrů získá Get-AzureEnvironment pouze vybrané vlastnosti prostředí.

Parametry

-Name

Získá pouze zadané prostředí. Zadejte název prostředí. V hodnotě parametru se rozlišují malá a velká písmena. Zástupné znaky nejsou povoleny.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny můžete řadit podle názvu vlastnosti, ale ne podle hodnoty.

Výstupy

PSCustomObject

Ve výchozím nastavení vrátí Get-AzureEnvironment vlastní objekt.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Když spustíte Get-AzureEnvironment s parametrem Name , vrátí windowsAzureEnvironment objekt.