快速入門：使用 PowerShell 部署 Azure API for FHIR
重要
Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。
在本快速入門中，您將瞭解如何使用 PowerShell 部署 Azure API for FHIR。
如尚未擁有 Azure 訂用帳戶，請在開始之前先建立免費帳戶。
Azure Cloud Shell
Azure Cloud Shell 是裝載於 Azure 中的互動式殼層環境，可在瀏覽器中使用。 您可以使用 Bash 或 PowerShell 搭配 Cloud Shell，與 Azure 服務共同使用。 您可以使用 Cloud Shell 預先安裝的命令，執行本文提到的程式碼，而不必在本機環境上安裝任何工具。
要啟動 Azure Cloud Shell：
| 選項 | 範例/連結 |
|---|---|
| 選取程式碼或命令區塊右上角的 [試試看]。 選取 [試試看] 並不會自動將程式碼或命令複製到 Cloud Shell 中。 |  |
| 請前往 https://shell.azure.com，或選取 [啟動 Cloud Shell] 按鈕，在瀏覽器中開啟 Cloud Shell。 |  |
| 選取 Azure 入口網站右上方功能表列上的 [Cloud Shell] 按鈕。 |  |
若要使用 Azure Cloud Shell：
啟動 Cloud Shell。
選取程式碼區塊 (或命令區塊) 上的 [複製] 按鈕以複製程式碼或命令。
透過在 Windows 和 Linux 上選取 Ctrl+Shift+V；或在 macOS 上選取 Cmd+Shift+V，將程式碼或命令貼到 Cloud Shell 工作階段中。
選取 Enter 鍵執行程式碼或命令。
注意
建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 若要開始使用，請參閱安裝 Azure PowerShell (部分機器翻譯)。 若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。
註冊 Azure API for FHIR 資源提供者
Microsoft.HealthcareApis如果資源提供者尚未為您的訂用帳戶註冊，您可以使用下列命令進行註冊。
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
建立 Azure 資源群組
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
部署 Azure API for FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
注意
根據您安裝的PowerShell模組版本，布建的 Az FHIR伺服器可能會設定為使用 本機角色型訪問控制 （RBAC）， 並在已部署 FHIR 服務允許的識別物件識別符清單中登入 PowerShell 使用者。 建議您 使用 Azure RBAC 來指派數據平面角色。 部署之後，您可能需要刪除此使用者的物件識別碼，才能啟用 Azure RBAC 模式。
Fetch 功能陳述式
您可以使用下列命令來擷取 FHIR 功能語句，以驗證 Azure API for FHIR 帳戶是否正在執行。
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
清除資源
如果您不打算繼續使用此應用程式，請使用下列步驟刪除資源群組。
Remove-AzResourceGroup -Name myResourceGroupName
下一步
在本快速入門指南中，您已將 Azure API for FHIR 部署到您的訂用帳戶。 如需 Azure API for FHIR 和開始使用 Azure API for FHIR 中設定的詳細資訊，請參閱
注意
FHIR® 是 HL7 的註冊商標，在 HL7 的許可下使用。