共用方式為

Get-AzureEnvironment

  • 參考
模組:
Azure

取得 Azure 環境

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

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

Description

Get-AzureEnvironment Cmdlet 會取得 Windows PowerShell 可用的 Azure 環境。

Azure 環境是獨立部署Microsoft Azure，例如適用於全球 Azure 的 Azure 雲端，以及由中國 21Vianet 營運的 AzureChinaCloud。 您也可以使用 Azure Pack 和 WAPack Cmdlet 來建立內部部署 Azure 環境。 如需詳細資訊，請參閱 Azure Pack。

Get-AzureEnvironment Cmdlet 會從您的訂用帳戶數據檔取得環境，而不是從 Azure 取得環境。 如果訂用帳戶數據檔已過期，請執行 Add-AzureAccount 或 Import-PublishSettingsFile Cmdlet 來重新整理它。

本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版本中的 Cmdlet。 若要取得您所使用的模組版本，請在 Azure PowerShell 控制台中輸入 (Get-Module -Name Azure).Version。

範例

範例 1：取得所有環境

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

此命令會取得 Windows PowerShell 可用的所有環境。

範例 2：依名稱取得環境

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/

此範例會取得 AzureCloud 環境。

範例 3：取得所有環境的所有屬性

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

此命令會取得所有環境的所有屬性。

此命令會 使用 Get-AzureEnvironment Cmdlet 來取得此帳戶的所有 Azure 環境。 然後，它會使用 Foreach-Object Cmdlet，在每個環境上使用 Name 參數來執行 Get-AzureEnvironment 命令。 Name 參數的值是每個環境的 EnvironmentName 屬性。

如果沒有參數， Get-AzureEnvironment 只會取得環境選取的屬性。

參數

-Name

只取得指定的環境。 輸入環境名稱。 參數值會區分大小寫。 不允許通配符。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

您可以透過屬性名稱將輸入管線傳送至此 Cmdlet，但不能依值傳送。

輸出

PSCustomObject

根據預設， Get-AzureEnvironment 會傳回自定義物件。

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment

當您使用 Name 參數執行 Get-AzureEnvironment 時，它會傳回 WindowsAzureEnvironment 物件。