在 Visual Studio Code 中使用 Azure 帳戶擴充功能連線到 Azure Stack Hub

發行項
03/20/2025

本文說明如何使用 Azure 帳戶擴充功能連線到 Azure Stack Hub，這可讓您直接從 Visual Studio Code 使用 Azure。您必須更新 Visual Studio Code （VS Code）設定。

VS Code 是一種輕量型編輯器，可用於建置和偵錯 Web 和雲端應用程式。 ASP.NET Core、Python、NodeJS、Go 和其他開發人員使用 VS Code。透過 Azure 帳戶延伸模組，您可以使用單一 Azure 登入，並進行其他 Azure 延伸模組的訂閱篩選。此擴充功能可在 VS Code 整合式終端機中使用 Azure Cloud Shell。使用此擴充功能，您可以透過 Microsoft Entra ID 和 Active Directory 同盟服務 (AD FS) 身分識別管理員，連線至您的 Azure Stack Hub 訂用帳戶。您可以登入 Azure Stack Hub、選取您的訂用帳戶，然後在 Cloud Shell 中開啟新的命令行。

注意

您可以針對 Active Directory 同盟服務（AD FS）環境使用本文中的步驟。使用您的 AD FS 認證和端點。

Visual Studio Code 和 Azure Stack Hub

除了適用於 Visual Studio 的 Azure 帳戶擴充功能之外，還支援其他一些 Azure 擴充功能搭配 Azure Stack Hub 和 Visual Studio Code 使用。這些包括：

Azure 帳戶擴充功能的必要條件

Azure Stack Hub 環境。
Visual Studio Code。
Azure 帳戶擴充功能。
具有 Azure Stack Hub 存取權的 Azure Stack Hub 訂用帳戶和認證。
使用適用於 Azure Stack Hub 的 AZ 模組搭配 PowerShell 的環境。如需指示，請參閱安裝適用於 Azure Stack Hub 的 PowerShell Az 模組。

取得您的認證

在本節中，您將使用您的認證來取得租戶 ID。您需要 Azure Stack Hub 資源管理員 URL 和租使用者識別碼。

Azure Stack Hub Resource Manager 是一種管理架構，可讓您部署、管理及監視 Azure 資源。

Azure Stack 開發工具包的 Resource Manager URL 為：https://management.local.azurestack.external/
整合式系統的 Resource Manager URL 是：https://management.region.<fqdn>/，其中 <fqdn> 是您的完整合格網域名稱。

以具有提升權限的提示字元開啟 PowerShell，然後執行下列指令程式：

Add-AzEnvironment -Name "<username@contoso.com>" -ArmEndpoint "https://management.region.<fqdn>"

Name  Resource Manager Url                            ActiveDirectory Authority
----  --------------------                            -------------------------
username@contoso.com https://management.region.<fqdn> https://login.microsoftonline.com/

在相同的會話中執行下列 cmdlet：

$AuthEndpoint = (Get-AzEnvironment -Name "sethm@microsoft.com").ActiveDirectoryAuthority.TrimEnd('/')
$AADTenantName = "masselfhost.onmicrosoft.com"
$TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]
Add-AzAccount -EnvironmentName "sethm@microsoft.com" -TenantId $TenantId

Account               SubscriptionName  TenantId                             Environment
-------               ----------------  --------                             -----------
username@contoso.com   azure-stack-sub  aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb username@contoso.com

記下租用戶標識碼。當您新增設定 Azure 帳戶擴充功能的 JSON 區段時，您將需要它。

設定 Azure 帳戶擴充功能

開啟 VS Code。
請在左側角落選擇 擴充功能。
在搜尋方塊中，輸入 Azure Account。
選取 [Azure 帳戶]，然後選取 [安裝]。
重新啟動 VS Code 以載入延伸模組。
按 Ctrl+Shift+P，然後選取 [喜好設定：開啟使用者設定（JSON）]。

在程式代碼編輯器中，使用您環境的值更新下列 JSON 代碼段，然後將代碼段貼到設定區塊中。

價值觀：

參數	描述
`azure.cloud`	您必須針對此參數使用常值常數「AzureCustomCloud」。。
`azure.tenant`	Azure Stack Hub 的值租使用者標識碼。
`azure.customCloud.resourceManagerEndpointUrl`	這是 Azure Stack Hub 的 Azure Resource Manager 根 URL。
`validateAuthority`	如果您使用 Microsoft Entra ID 作為身分識別管理員，則可以省略此參數。如果您使用 AD FS，請使用 `false` 值新增參數。

JSON 代碼段：

  "azure.cloud": "AzureCustomCloud",
  "azure.customCloud.resourceManagerEndpointUrl": "https://management.region.<fqdn>",
  "azure.tenant": "<your-tenant-ID>",

儲存使用者設定（JSON），並再次使用 Ctrl+Shift+P。選取 [Azure：登入。驗證頁面會在瀏覽器中載入。登入您的端點。
若要測試您是否已成功登入 Azure Stack Hub 訂用帳戶，請使用 ctrl+Shift+ P ，然後選取 [Azure：選取訂用帳戶，並查看是否有可用的訂用帳戶。

命令

Azure：登入	登入您的 Azure 訂用帳戶
Azure：使用裝置程式代碼登入	使用裝置程式代碼登入您的 Azure 訂用帳戶。在 [登入] 命令無法運作的設定中使用裝置程序代碼。
Azure：登入 Azure 雲端	在其中一個主權雲端中登入您的 Azure 訂用帳戶。
Azure：註銷	註銷您的 Azure 訂用帳戶。
Azure：選取訂用帳戶	挑選您想要管理的訂閱組合。延伸模組只會顯示篩選訂用帳戶內的資源。
Azure：建立帳戶	如果您沒有 Azure 帳戶，您可以立即註冊，並收到 200 美元的免費點數。
Azure：在 Cloud Shell 中開啟 Bash	開啟在 Cloud Shell 中執行 Bash 的新終端機。
Azure：在 Cloud Shell 中開啟 PowerShell	在 Cloud Shell 中開啟執行 PowerShell 的新終端機。
Azure：上傳至「Cloud Shell」	將檔案上傳至 Cloud Shell 記憶體帳戶。

後續步驟

在 Azure Stack Hub 中設定開發環境

從 Visual Studio Code 在 Azure Stack Hub 中設定 Azure 記憶體

共用方式為