Get-AzureEnvironment
Azure-környezetek lekérálása
Feljegyzés
A jelen dokumentációban hivatkozott parancsmagok az Azure Service Manager (ASM) API-kat használó örökölt Azure-erőforrások kezelésére szolgálnak. Ez az örökölt PowerShell-modul nem ajánlott új erőforrások létrehozásakor, mivel az ASM a kivonásra van ütemezve. További információkért lásd az Azure Service Manager kivonását.
Az Az PowerShell-modul az ajánlott PowerShell-modul az Azure Resource Manager-erőforrások PowerShell-lel való kezeléséhez.
Syntax
Get-AzureEnvironment
[-Name <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
A Get-AzureEnvironment parancsmag lekéri a Windows PowerShell számára elérhető Azure-környezeteket.
Az Azure-környezet a Microsoft Azure független üzembe helyezése, például az AzureCloud a globális Azure-hoz és az Azure Azure-hoz készült AzureChinaCloud, amelyet a 21Vianet üzemeltet Kínában. Helyszíni Azure-környezeteket az Azure Pack és a WAPack parancsmagok használatával is létrehozhat. További információ: Azure Pack).
A Get-AzureEnvironment parancsmag nem az Azure-ból, hanem az előfizetés adatfájljából szerzi be a környezeteket. Ha az előfizetés adatfájlja elavult, futtassa az Add-AzureAccount vagy az Import-PublishSettingsFile parancsmagot a frissítéséhez.
Ez a témakör a Microsoft Azure PowerShell modul 0.8.10-es verziójában található parancsmagot ismerteti.
A használt modul verziójának lekéréséhez írja be (Get-Module -Name Azure).Version
az Azure PowerShell-konzolba.
Példák
1. példa: Az összes környezet lekérése
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...
Ez a parancs lekéri az összes olyan környezetet, amely elérhető a Windows PowerShell számára.
2. példa: Környezet lekérése név alapján
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/
Ez a példa lekéri az AzureCloud-környezetet.
3. példa: Az összes környezet összes tulajdonságának lekérése
PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}
Ez a parancs az összes környezet összes tulajdonságát lekéri.
A parancs a Get-AzureEnvironment parancsmagot használja a fiók összes Azure-környezetének lekéréséhez. Ezután a Foreach-Object parancsmaggal futtat egy Get-AzureEnvironment parancsot az egyes környezetek Név paraméterével. A Név paraméter értéke az egyes környezetek EnvironmentName tulajdonsága.
Paraméterek nélkül a Get-AzureEnvironment csak a környezet kiválasztott tulajdonságait kapja meg.
Paraméterek
-Name
Csak a megadott környezetet kapja meg. Írja be a környezet nevét. A paraméter értéke megkülönbözteti a kis- és nagybetűk értékét. A helyettesítő karakterek nem engedélyezettek.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Profile
Azt az Azure-profilt adja meg, amelyből a parancsmag beolvassa. Ha nem ad meg profilt, ez a parancsmag a helyi alapértelmezett profilból olvas be.
Típus: | AzureSMProfile |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz a bemenetet tulajdonságnév alapján, érték alapján azonban nem lehet becsúszni.
Kimenetek
Alapértelmezés szerint a Get-AzureEnvironment egy egyéni objektumot ad vissza.
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment
Ha a Get-AzureEnvironment parancsot a Név paraméterrel futtatja, az egy WindowsAzureEnvironment objektumot ad vissza.