快速入門：使用 Azure Resource Manager 範本和 Azure PowerShell 或 Azure CLI 部署醫療技術服務

發行項
05/16/2024

若要為 Azure 解決方案實作基礎結構即程式碼，請使用 Azure Resource Manager 範本 (ARM 範本)。範本是一個 JavaScript 物件標記法 (JSON) 檔案，會定義專案的基礎結構和設定。範本會使用宣告式語法，可讓您陳述您要部署的項目，而不需要撰寫一連串程式設計命令來加以建立。在該範本中，您可以指定要部署的資源和這些資源的屬性。

在本快速入門中，了解如何使用 Azure PowerShell 或 Azure CLI，使用 Azure Resource Manager 範本 (ARM 範本) 來部署醫療技術服務執行個體。

提示

若要深入了解 ARM 範本，請參閱什麼是 ARM 範本？

必要條件

若要開始部署並完成本快速入門，您必須具備下列先決條件：

有效的 Azure 訂用帳戶。如果您沒有 Azure 訂用帳戶，請參閱訂用帳戶決策指南。
在 Azure 訂用帳戶中的擁有者或參與者和使用者存取系統管理員角色。如需詳細資訊，請參閱什麼是 Azure 角色型存取控制 (Azure RBAC)？
已在 Azure 訂用帳戶註冊的 Microsoft.HealthcareApis 和 Microsoft.EventHub 資源提供者。若要深入了解註冊資源提供者，請參閱 Azure 資源提供者和類型。
Azure PowerShell 和/或本機安裝的 Azure CLI。

當您具備這些必要條件時，即可部署 ARM 範本。

檢閱 ARM 範本

本快速入門中用來部署資源的 ARM 範例可在 Azure 快速入門範例使用 GitHub 上的 azuredeploy.json 檔案來取得。

使用 Azure Resource Manager 範本和 Azure PowerShell 部署醫療技術服務

完成下列五個步驟，以使用 Azure PowerShell 部署醫療技術服務：

登入 Azure。
```
Connect-AzAccount
```
使用訂用帳戶識別碼設定您的 Azure 訂用帳戶部署內容。若要了解如何取得訂用帳戶識別碼，請參閱 Azure 入口網站中的取得訂用帳戶和租用戶識別碼。
```
Set-AzContext <AzureSubscriptionId>
```
例如：Set-AzContext abcdef01-2345-6789-0abc-def012345678
確認您要部署的位置。如需 Azure 健康資料服務目前可用的 Azure 區域，請參閱依區域網站提供的產品。

您也可以檢閱 azuredeploy.json 檔案的位置一節。

如果您需要 Azure 區域位置名稱的清單，您可以使用此程式碼來顯示清單：
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
如果您尚未為此快速入門建立資源群組，可使用此程式碼來建立：
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
例如：New-AzResourceGroup -name ArmTestDeployment -location southcentralus

重要

若要成功部署醫療技術服務，您必須針對資源的基底名稱使用數字和小寫字母。基底名稱需求下限為三個字元，最多 16 個字元。
使用下列程式碼，利用 ARM 範本來部署醫療技術服務：
```
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json -basename <BaseName> -location <AzureRegion>
```
例如：New-AzResourceGroupDeployment -ResourceGroupName ArmTestDeployment -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json -basename abc123 -location southcentralus
重要

如果您要允許從多個服務存事件中樞，強烈建議每個服務都有自己的事件中樞取用者群組。

取用者群組能讓多個取用應用程式擁有自己的事件串流檢視，以及按照自己的步調及運用自己的位移自行讀取串流。如需詳細資訊，請參閱取用者群組。

範例：
- 存取相同事件中樞的兩個醫療技術服務。
- 醫療技術服務和存取相同事件中樞的儲存體寫入應用程式。

使用 Azure Resource Manager 範本和 Azure CLI 部署醫療技術服務

完成下列五個步驟，以使用 Azure CLI 部署醫療技術服務：

登入 Azure。
```
az login
```
使用訂用帳戶識別碼設定您的 Azure 訂用帳戶部署內容。若要了解如何取得訂用帳戶識別碼，請參閱 Azure 入口網站中的取得訂用帳戶和租用戶識別碼。
```
az account set <AzureSubscriptionId>
```
例如：az account set abcdef01-2345-6789-0abc-def012345678
確認您要部署的位置。如需 Azure 健康資料服務目前可用的 Azure 區域，請參閱依區域網站提供的產品。

您也可以檢閱 azuredeploy.json 檔案的位置一節。

如果您需要 Azure 區域位置名稱的清單，您可以使用此程式碼來顯示清單：
```
az account list-locations -o table
```
如果您尚未為此快速入門建立資源群組，可使用此程式碼來建立：
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
例如：az group create --resource-group ArmTestDeployment --location southcentralus

重要

若要成功部署醫療技術服務，您必須針對資源的基底名稱使用數字和小寫字母。
使用下列程式碼，利用 ARM 範本來部署醫療技術服務：
```
az deployment group create --resource-group <ResourceGroupName> --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json --parameters basename=<BaseName> location=<AzureRegion>
```
例如：az deployment group create --resource-group ArmTestDeployment --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json --parameters basename=abc123 location=southcentralus
重要

如果您要允許從多個服務存事件中樞，強烈建議每個服務都有自己的事件中樞取用者群組。

取用者群組能讓多個取用應用程式擁有自己的事件串流檢視，以及按照自己的步調及運用自己的位移自行讀取串流。如需詳細資訊，請參閱取用者群組。

範例：
- 存取相同事件中樞的兩個醫療技術服務。
- 醫療技術服務和存取相同事件中樞的儲存體寫入應用程式。

檢閱已部署的資源和存取權限

部署完成時，ARM 範本部署中會建立下列資源和存取角色：

Azure 事件中樞命名空間與事件中樞。在此部署中，事件中樞名為 devicedata。
- 事件中樞取用者群組。在此部署中，取用者群組名為 $Default。
- [Azure 事件中樞資料傳送者] 角色。在此部署中，傳送者角色名為 devicedatasender，而且可用來使用共用存取簽章 (SAS) 提供事件中樞的存取權。若要深入了解使用 SAS 進行授權，請參閱使用共用存取簽章授與對事件中樞資源的存取權。
健康資料服務工作區。
Health Data Services FHIR® 服務。
具有必要系統指派受控識別角色的健康資料服務醫療技術服務服務：
- 針對事件中樞，Azure 事件中樞資料接收器角色會指派在事件中樞存取控制區段 (IAM)。
- 針對 FHIR 服務，FHIR 服務 FHIR 資料寫入器角色會在 FHIR 服務的存取控制區段 (IAM) 區段中指派。

重要

在本快速入門中，ARM 範本會設定醫療技術服務，以建立模式運作。系統會為每個傳送資料至 FHIR 服務的裝置建立病患資源和裝置資源。

若要深入了解醫療技術服務解析類型建立和查閱，請參閱設定目的地索引標籤。

部署後對應

成功部署醫療技術服務的執行個體之後，您仍然需要提供符合規範且有效的裝置和 FHIR 目的地對應。

若要瞭解裝置對應，請參閱醫療技術服務裝置對應概觀。
若要瞭解 FHIR 目的地對應，請參閱 FHIR 目的地對應概觀。

清除 Azure PowerShell 資源

如果您不再需要資源群組和 Bicep 檔案，請刪除資源群組，這麼做會刪除資源群組中的資源。

Remove-AzResourceGroup -Name <ResourceGroupName>

例如：Remove-AzResourceGroup -Name ArmTestDeployment

清除 Azure CLI 資源

如果您不再需要資源群組和 Bicep 檔案，請刪除資源群組，這麼做會刪除資源群組中的資源。

az group delete --name <ResourceGroupName>

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

提示

如需可引導您完成建立 ARM 範本程序的逐步教學課程，請參閱教學課程：建立及部署您的第一個 ARM 範本。

下一步

選擇醫療技術服務的部署方法

醫療技術服務裝置資料處理階段概觀

關於醫療技術服務服務的常見問題

注意

FHIR® 是 HL7 的註冊商標，在 HL7 的許可下使用。

共用方式為