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

快速入门：使用 Bicep 文件和 Azure PowerShell 或 Azure CLI 部署医疗技术服务

项目
11/20/2023

Bicep 是一种特定于域的语言 (DSL)，使用声明性语法来部署 Azure 资源。在 Bicep 文件中，定义要部署到 Azure 的基础结构，然后在整个开发生命周期中使用该文件重复部署基础结构。你的资源以一致的方式部署。Bicep 提供简明的语法、可靠的类型安全性以及对代码重用的支持。 Bicep 会针对你的 Azure 基础结构即代码解决方案提供一流创作体验。

本快速入门介绍如何使用 Azure PowerShell 或 Azure CLI 通过 Bicep 文件部署医疗技术服务实例。

提示

若要详细了解 Bicep，请参阅什么是 Bicep？

先决条件

若要开始部署并完成本快速入门，必须满足以下先决条件：

一个有效的 Azure 订阅帐户。如果没有 Azure 订阅，请参阅订阅决策指南。
Azure 订阅中的“所有者”、“参与者和用户访问管理员”角色分配。有关详细信息，请参阅什么是 Azure 基于角色的访问控制 (Azure RBAC)？
已在 Azure 订阅中注册的 Microsoft.HealthcareApis 和 Microsoft.EventHub 资源提供程序。若要详细了解如何注册资源提供程序，请参阅 Azure 资源提供程序和类型。
本地安装的 Azure PowerShell 和/或 Azure CLI。
- 对于 Azure PowerShell，请安装 Bicep CLI 以部署本快速入门中使用的 Bicep 文件。

满足上述先决条件后，即可部署 Bicep 文件。

查阅 Bicep 文件

本快速入门中用于部署资源的 Bicep 文件在 Azure 快速入门模板中提供，可通过使用 GitHub 上的 main.bicep 文件获取。

在本地保存 Bicep 文件

在本地将 Bicep 文件的保存为 main.bicep。需要让 Azure PowerShell 或 Azure CLI 控制台的工作目录指向保存此文件的位置。

使用 Bicep 文件和 Azure PowerShell 部署医疗技术服务

完成以下五个步骤，使用 Azure PowerShell 部署医疗技术服务：

登录 Azure。
```
Connect-AzAccount
```
使用订阅 ID 设置 Azure 订阅部署上下文。若要了解如何获取订阅 ID，请参阅在 Azure 门户中获取订阅和租户 ID。
```
Set-AzContext <AzureSubscriptionId>
```
例如：Set-AzContext abcdef01-2345-6789-0abc-def012345678
确认要部署的位置。有关提供 Azure Health Data Services 的当前 Azure 区域，请参阅可用产品（按区域）网站。

还可以查看本地保存的 main.bicep 文件的“位置”部分。

如果需要 Azure 区域位置名称的列表，可以使用以下代码显示列表：
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
如果尚未为本快速入门创建资源组，可以使用以下代码创建一个：
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
例如：New-AzResourceGroup -name BicepTestDeployment -location southcentralus

重要

为了成功部署医疗技术服务，需要对资源的基名称使用数字和小写字母。基名称至少需要 3 个字符，最多为 16 个字符。
使用以下代码通过 Bicep 文件部署医疗技术服务：
```
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>
```
例如：New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -basename abc123 -location southcentralus
重要

如果要允许从多个服务访问事件中心，强烈建议每个服务建立自己的事件中心使用者组。

通过使用者组，多个消耗应用程序会有各自独立的事件流视图，并按自身节奏和偏移量独立读取流。有关详细信息，请参阅使用者组。

示例：
- 访问同一事件中心的两个医疗技术服务。
- 访问同一事件中心的医疗技术服务和存储编写器应用程序。

使用 Bicep 文件和 Azure CLI 部署医疗技术服务

完成以下五个步骤，使用 Azure CLI 部署医疗技术服务：

登录 Azure。
```
az login
```
使用订阅 ID 设置 Azure 订阅部署上下文。若要了解如何获取订阅 ID，请参阅在 Azure 门户中获取订阅和租户 ID。
```
az account set <AzureSubscriptionId>
```
例如：az account set abcdef01-2345-6789-0abc-def012345678
确认要部署的位置。有关提供 Azure Health Data Services 的当前 Azure 区域，请参阅可用产品（按区域）网站。

还可以查看本地保存的 main.bicep 文件的“位置”部分。

如果需要 Azure 区域位置名称的列表，可以使用以下代码显示列表：
```
az account list-locations -o table
```
如果尚未为本快速入门创建资源组，可以使用以下代码创建一个：
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
例如：az group create --resource-group BicepTestDeployment --location southcentralus

重要

为了成功部署医疗技术服务，需要对资源的基名称使用数字和小写字母。
使用以下代码通过 Bicep 文件部署医疗技术服务：
```
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>
```
例如：az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus
重要

如果要允许从多个服务访问设备消息事件中心，强烈建议每个服务建立自己的事件中心使用者组。

通过使用者组，多个消耗应用程序会有各自独立的事件流视图，并按自身节奏和偏移量独立读取流。有关详细信息，请参阅使用者组。

示例：
- 访问同一事件中心的两个医疗技术服务。
- 医疗技术服务和存储编写器应用程序访问同一事件中心。

查看已部署的资源和访问权限

部署完成后，将在 Bicep 文件部署中创建以下资源和访问角色：

Azure 事件中心命名空间和事件中心。在此部署中，事件中心命名为 devicedata。
- 事件中心使用者组。在此部署中，使用者组命名为$Default。
- Azure 事件中心数据发送方角色。在此部署中，发送方角色命名为 devicedatasender，可用于使用共享访问签名 (SAS) 提供对设备事件中心的访问权限。若要详细了解如何使用 SAS 进行授权，请参阅使用共享访问签名授权访问事件中心资源。
Health Data Services 工作区。
Health Data Services FHIR® 服务。
具有所需系统分配的托管标识角色的 Health Data Services 医疗技术服务：
- 对于事件中心，在事件中心的访问控制部分 (IAM) 中分配“Azure 事件中心数据接收方”角色。
- 对于 FHIR 服务，在 FHIR 服务的访问控制部分 (IAM) 中分配“FHIR 数据写入者”角色。

重要

在本快速入门中，ARM 模板将医疗技术服务配置为在“创建”模式下运行。将为向 FHIR 服务发送数据的每台设备创建患者资源和设备资源。

若要详细了解医疗技术服务解决类型“创建”和“查找”，请参阅配置目标选项卡。

部署后的映射

成功部署医疗技术服务的实例后，仍需提供一致且有效的设备和 FHIR 目标映射。

若要了解设备映射，请参阅设备映射概述。
若要了解 FHIR 目标映射，请参阅 FHIR 目标映射概述。

清理 Azure PowerShell 部署的资源

不再需要资源组和已部署的 Bicep 文件资源时，可以删除资源组，这将删除资源组中的资源。

Remove-AzResourceGroup -Name <ResourceGroupName>

例如：Remove-AzResourceGroup -Name BicepTestDeployment

清理 Azure CLI 部署的资源

不再需要资源组和已部署的 Bicep 文件资源时，可以删除资源组，这将删除资源组中的资源。

az group delete --name <ResourceGroupName>

例如：az group delete --resource-group BicepTestDeployment

提示

有关引导你完成 Bicep 文件创建过程的分步教程，请参阅生成你的第一个 Bicep 模板。

后续步骤

为医疗技术服务选择部署方法

医疗技术服务设备数据处理阶段概述

有关医疗技术服务的常见问题解答

注意

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

通过