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

發行項
12/01/2023

本文說明如何使用 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 識別碼和 Active Directory 同盟服務 (AD FS) 連線到 Azure Stack Hub 訂用帳戶。您可以登入 Azure Stack Hub、選取訂用帳戶，以及在 Cloud Shell 中開啟新的命令列。

注意

針對 Active Directory Federated Services (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 模組。

取得認證

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

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

Azure Stack 開發套件 (ASDK) 的 Resource Manager URL 為：https://management.local.azurestack.external/
整合系統中的 Resource Manager URL 為：https://management.region.<fqdn>/，其中 <fqdn> 是完整網域名稱。

開啟已提升權限的 PowerShell 提示字元，然後執行下列 Cmdlet：

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  6d5ff183-b37f-4a5b-9a2f-19959cb4224a username@contoso.com

記下租用戶識別碼。在新增 JSON 區段 (會設定 Azure 帳戶擴充功能) 時，您將需要進行此動作。

設定 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識別碼作為身分識別管理員，則可以省略此參數。如果您使用 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 訂用帳戶。 Sign In 命令無法運作時，請在設定中使用裝置程式碼。
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 儲存體