Add-AzureEnvironment
建立 Azure 環境。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。
Syntax
Add-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Add-AzureEnvironment Cmdlet 會建立新的自訂 Azure 帳戶環境，並將它儲存在您的漫遊使用者設定檔中。 Cmdlet 會傳回代表新環境的物件。 當命令完成時，您可以在 Windows PowerShell 中使用環境。
Azure 環境是 Microsoft Azure 的獨立部署，例如適用于全球 Azure 的 Azure 雲端，以及由中國 21Vianet 營運的 AzureChinaCloud。 您也可以使用 Azure Pack 和 WAPack Cmdlet 來建立內部部署 Azure 環境。 如需詳細資訊，請參閱 Azure Pack 。
只有這個 Cmdlet 的 Name 參數是必要的。 如果您省略參數，其值為 null（$Null），且使用該端點的服務可能無法正常運作。 若要新增或變更環境屬性的值，請使用 Set-AzureEnvironment Cmdlet。
注意：變更您的環境可能會導致您的帳戶失敗。 一般而言，環境只會新增以進行測試或疑難排解。
本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版中的 Cmdlet。
若要取得您所使用的模組版本，請在 Azure PowerShell 主控台中輸入 (Get-Module -Name Azure).Version 。
範例
範例 1：新增 Azure 環境
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :此命令會建立 ContosoEnv Azure 環境。
參數
-ActiveDirectoryEndpoint
指定新環境中的 Microsoft Entra 驗證端點。
| Type: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
指定管理 API 的資源識別碼，其存取權由 Microsoft Entra ID 管理。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
| Type: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
指定儲存資源群組資源庫範本的 Azure Resource Manager 資源庫端點。 如需 Azure 資源群組和資源庫範本的詳細資訊，請參閱 Get-AzureResourceGroupGalleryTemplate 的說明主題https://go.microsoft.com/fwlink/?LinkID=393052.
| Type: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
| Type: | String |
| Aliases: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
指定新環境中的 Azure 管理入口網站的 URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定環境的名稱。 此為必要參數。 請勿使用預設環境、AzureCloud 和 AzureChinaCloud 的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設設定檔讀取。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublishSettingsFileUrl
指定您帳戶之發佈設定檔的 URL。 Azure 發佈設定檔案是一個 XML 檔案，其中包含您的帳戶相關資訊，以及允許 Windows PowerShell 代表您登入 Azure 帳戶的管理憑證。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceManagerEndpoint
指定 Azure Resource Manager 資料的端點，包括與帳戶相關聯的資源群組相關資料。 如需 Azure Resource Manager 的詳細資訊，請參閱 Azure Resource Manager Cmdlet （ https://go.microsoft.com/fwlink/?LinkID=394765 ） 和使用 Windows PowerShell 搭配 Resource Manager （ https://go.microsoft.com/fwlink/?LinkID=394767 ）。
| Type: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceEndpoint
指定 Azure 服務端點的 URL。 Azure 服務端點會決定您的應用程式是由全球 Azure 平臺管理、由中國 21Vianet 運作的 Azure，還是私人 Azure 安裝。
| Type: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
指定新環境中儲存體服務的預設端點。
| Type: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸入
None
您可以透過屬性名稱將輸入管線傳送至此 Cmdlet，但不能依值傳送。
輸出
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment