Udostępnij za pośrednictwem

Get-AzureEnvironment

  • Odwołanie
Moduł:
Azure

Pobiera środowiska platformy Azure

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Get-AzureEnvironment pobiera środowiska platformy Azure dostępne dla programu Windows PowerShell.

Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack).

Polecenie cmdlet Get-AzureEnvironment pobiera środowiska z pliku danych subskrypcji, a nie z platformy Azure. Jeśli plik danych subskrypcji jest nieaktualny, uruchom polecenie cmdlet Add-AzureAccount lub Import-PublishSettingsFile , aby je odświeżyć.

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Pobieranie wszystkich środowisk

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

To polecenie pobiera wszystkie środowiska dostępne dla programu Windows PowerShell.

Przykład 2. Pobieranie środowiska według nazwy

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/

Ten przykład pobiera środowisko usługi AzureCloud.

Przykład 3. Pobieranie wszystkich właściwości wszystkich środowisk

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

To polecenie pobiera wszystkie właściwości wszystkich środowisk.

Polecenie używa polecenia cmdlet Get-AzureEnvironment , aby pobrać wszystkie środowiska platformy Azure dla tego konta. Następnie używa polecenia cmdlet Foreach-Object do uruchomienia polecenia Get-AzureEnvironment z parametrem Name w każdym środowisku. Wartość parametru Name to właściwość EnvironmentName każdego środowiska.

Bez parametrów polecenie Get-AzureEnvironment pobiera tylko wybrane właściwości środowiska.

Parametry

-Name

Pobiera tylko określone środowisko. Wpisz nazwę środowiska. W wartości parametru jest uwzględniana wielkość liter. Symbole wieloznaczne nie są dozwolone.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.

Dane wyjściowe

PSCustomObject

Domyślnie polecenie Get-AzureEnvironment zwraca obiekt niestandardowy.

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

Po uruchomieniu polecenia Get-AzureEnvironment z parametrem Name zwraca obiekt WindowsAzureEnvironment.