通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 PowerShell 部署 Azure API for FHIR

  • 项目

重要

Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略在该日期之前转换到 Azure Health Data Services FHIR® 服务。 由于 Azure API for FHIR 停用，在 2025 年 4 月 1 日开始前不会允许新的部署。 Azure Health Data Services FHIR 服务是 Azure API for FHIR 的演化版本，可让客户管理 FHIR、DICOM 和医疗技术服务，并集成到其他 Azure 服务。

本快速入门介绍如何使用 PowerShell 部署 Azure API for FHIR。

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

Azure Cloud Shell

Azure 托管 Azure Cloud Shell（一个可通过浏览器使用的交互式 shell 环境）。 可以将 Bash 或 PowerShell 与 Cloud Shell 配合使用来使用 Azure 服务。 可以使用 Cloud Shell 预安装的命令来运行本文中的代码，而不必在本地环境中安装任何内容。

若要启动 Azure Cloud Shell，请执行以下操作：

选项 示例/链接
选择代码或命令块右上角的“试用”。 选择“试用”不会自动将代码或命令复制到 Cloud Shell。 显示 Azure Cloud Shell 的“试用”示例的屏幕截图。
转到 https://shell.azure.com 或选择“启动 Cloud Shell”按钮可在浏览器中打开 Cloud Shell。 用于启动 Azure Cloud Shell 的按钮。
选择 Azure 门户右上角菜单栏上的 Cloud Shell 按钮。 显示 Azure 门户中的 Cloud Shell 按钮的屏幕截图

若要使用 Azure Cloud Shell，请执行以下操作：

  1. 启动 Cloud Shell。

  2. 选择代码块（或命令块）上的“复制”按钮以复制代码或命令。

  3. 在 Windows 和 Linux 上选择 Ctrl+Shift+V，或在 macOS 上选择 Cmd+Shift+V 将代码或命令粘贴到 Cloud Shell 会话中。

  4. 选择“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

注意

根据安装的 Az PowerShell 模块的版本，预配的 FHIR 服务器可能会配置为使用本地基于角色的访问控制 (RBAC)，并将当前登录的 PowerShell 用户添加到已部署 FHIR 服务的允许标识对象 ID 列表中。 建议使用 Azure RBAC 来分配数据平面角色。 部署后，可能需要删除此用户的对象 ID，以启用 Azure RBAC 模式。

提取功能语句

可以使用以下命令提取 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 的详细信息，请参阅

Azure API for FHIR 中的其他设置

注册应用程序概览

配置 Azure RBAC

配置本地 RBAC

配置数据库设置

配置客户管理的密钥

配置 CORS

配置专用链接

注意

FHIR® 是 HL7 的注册商标，经 HL7 许可使用。