Get-AzureEnvironment
Mendapatkan lingkungan Azure
Catatan
Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.
Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.
Sintaks
Get-AzureEnvironment
[-Name <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Deskripsi
Cmdlet Get-AzureEnvironment mendapatkan lingkungan Azure yang tersedia untuk Windows PowerShell.
Lingkungan Azure merupakan penyebaran independen Microsoft Azure, seperti AzureCloud untuk Azure global dan AzureChinaCloud untuk Azure yang dioperasikan oleh 21Vianet di Tiongkok. Anda juga dapat membuat lingkungan Azure lokal dengan menggunakan Azure Pack dan cmdlet WAPack. Untuk informasi selengkapnya, lihat Paket Azure).
Cmdlet Get-AzureEnvironment mendapatkan lingkungan dari file data langganan Anda, bukan dari Azure. Jika file data langganan kedaluarsa, jalankan cmdlet Add-AzureAccount atau Import-PublishSettingsFile untuk merefreshnya.
Topik ini menjelaskan cmdlet dalam modul Microsoft Azure PowerShell versi 0.8.10.
Untuk mendapatkan versi modul yang Anda gunakan, di konsol Azure PowerShell, ketik (Get-Module -Name Azure).Version
.
Contoh
Contoh 1: Mendapatkan semua lingkungan
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...
Perintah ini mendapatkan semua lingkungan yang tersedia untuk Windows PowerShell.
Contoh 2: Mendapatkan lingkungan berdasarkan nama
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/
Contoh ini mendapatkan lingkungan AzureCloud.
Contoh 3: Mendapatkan semua properti dari semua lingkungan
PS C:\> Get-AzureEnvironment | ForEach-Object {Get-AzureEnvironment -Name $_.EnvironmentName}
Perintah ini mendapatkan semua properti dari semua lingkungan.
Perintah menggunakan cmdlet Get-AzureEnvironment untuk mendapatkan semua lingkungan Azure untuk akun ini. Kemudian, menggunakan cmdlet Foreach-Object untuk menjalankan perintah Get-AzureEnvironment dengan parameter Nama di setiap lingkungan. Nilai parameter Nama adalah properti EnvironmentName dari setiap lingkungan.
Tanpa parameter, Get-AzureEnvironment hanya mendapatkan properti lingkungan yang dipilih.
Parameter
-Name
Hanya mendapatkan lingkungan yang ditentukan. Ketik nama lingkungan. Nilai parameter peka huruf besar/kecil. Karakter kartubebas tidak diizinkan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Profile
Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.
Jenis: | AzureSMProfile |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
None
Anda dapat menyalurkan input ke cmdlet ini berdasarkan nama properti, tetapi tidak berdasarkan nilai.
Output
Secara default, Get-AzureEnvironment mengembalikan objek kustom.
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment
Saat Anda menjalankan Get-AzureEnvironment dengan parameter Nama , itu mengembalikan objek WindowsAzureEnvironment .