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

通过 Azure CLI 或 PowerShell 管理 IoT Central

可以使用 Azure CLIAzure PowerShell 来管理应用程序,而不是在Azure 门户中创建和管理 IoT Central 应用程序。

如果想要使用 JavaScript、Python、C#、Ruby 或 Go 等语言来创建、更新、列出和删除 Azure IoT Central 应用程序,请参阅 Azure IoT Central ARM SDK 示例 存储库。

先决条件

警告

需要对 Azure 订阅拥有参与者访问权限才能创建 IoT Central 应用。 虽然可使用其他访问级别来创建应用,但推荐的路径是对订阅拥有参与者级别的访问权限。

创建应用程序

使用 az iot central app create 命令在 Azure 订阅中创建 IoT Central 应用程序。 例如:

# Create a resource group for the IoT Central application
az group create --location "East US" \
    --name "MyIoTCentralResourceGroup"
# Create an IoT Central application
az iot central app create \
  --resource-group "MyIoTCentralResourceGroup" \
  --name "myiotcentralapp" --subdomain "mysubdomain" \
  --sku ST1 --template "iotc-pnp-preview" \
  --display-name "My Custom Display Name"

这些命令首先在“美国东部”区域为应用程序创建一个资源组。 下表描述了与“az iot central app create”命令配合使用的参数:

参数 说明
resource-group 包含该应用程序的资源组。 此资源组必须已存在于订阅中。
location 此命令默认使用资源组中的位置。 目前,可以在以下区域创建 IoT Central 应用程序:澳大利亚东部、加拿大中部、美国中部、美国东部、美国东部 2、日本东部、北欧、美国中南部、东南亚、英国南部、西欧和美国西部。
name 应用程序在 Azure 门户中的名称。 避免使用特殊字符,而应改用小写字母 (a-z)、数字 (0-9) 和破折号 (-)。
subdomain 应用程序 URL 中的子域。 在该示例中,应用程序 URL 为 https://mysubdomain.azureiotcentral.com
sku 目前,可以使用 ST1 或 ST2 。 请参阅 Azure IoT Central 定价
template 要使用的应用程序模板。 有关详细信息,请参阅下表。
display-name UI 中显示的应用程序名称。

应用程序模板

模板 ID 名称 行业 说明
iotc-pnp-preview 自定义应用程序 N/A 创建一个空的应用程序,以便在其中填充你自己的设备模板和设备。
iotc-condition 店内分析 - 环境监视 零售 创建一个应用程序来连接和监视商店环境。
iotc-consumption 水消耗量监测 Government 创建一个应用程序来监视和控制水流。
iotc-distribution 数字分发中心 零售 创建一个应用程序,通过对关键资产和操作进行数字化来提高仓库输出效率。
iotc-inventory 智能库存管理 零售 创建一个应用程序来自动执行接收、产品移动、周期计数和跟踪操作。
iotc-logistics 联网物流 零售 创建一个应用程序,通过位置和状态监视功能实时跟踪航运、水运和陆运情况。
iotc-meter 智能计量分析 能源 创建一个应用程序,监视能源消耗、网络状态并确定改进客户支持和智能计量管理的趋势。
iotc-mfc 微履行中心 零售 创建一个应用程序,以数字方式连接和管理全自动履行中心。
iotc-patient 持续患者监控 健康产业 创建一个应用程序来扩展病人护理、减少再次入院次数和管理疾病。
iotc-power 太阳能监测 能源 创建一个应用程序来监视太阳能板的状态和能源生成趋势。
iotc-quality 水质监测 Government 创建一个应用程序来以数字方式监测水质。
iotc-store 店内分析 - 结帐 零售 创建一个应用程序来监视和管理商店中的结帐流程。
iotc-waste 联网废弃物管理 Government 创建一个应用程序来监视垃圾箱和调度现场工作人员。

如果你创建了自己的应用程序模板,则可以用它来创建新的应用程序。 当系统提示你提供应用程序模板时,请在应用的应用程序模板导出部分下,输入导出应用的 URL 可共享链接中显示的应用 ID。

查看应用程序

使用 az iot central app list 命令列出 IoT Central 应用程序和查看元数据。

修改应用程序

使用 az iot central app update 命令更新 IoT Central 应用程序的元数据。 例如,若要更改应用程序的显示名称:

az iot central app update --name myiotcentralapp \
  --resource-group MyIoTCentralResourceGroup \
  --set displayName="My new display name"

删除应用程序

使用 az iot central app delete 命令删除 IoT Central 应用程序。 例如:

az iot central app delete --name myiotcentralapp \
  --resource-group MyIoTCentralResourceGroup

配置托管标识

IoT Central 应用程序可以使用系统分配的托管标识确保到数据导出目标的连接安全。

若要启用托管标识,请使用 Microsoft Azure 门户 - 配置托管标识或 CLI。 创建 Azure IoT Central 应用程序时,可以启用托管标识:

# Create an IoT Central application with a managed identity
az iot central app create \
  --resource-group "MyIoTCentralResourceGroup" \
  --name "myiotcentralapp" --subdomain "mysubdomain" \
  --sku ST1 --template "iotc-pnp-preview" \
  --display-name "My Custom Display Name" \
  --mi-system-assigned

或者,可以在现有的 Azure IoT Central 应用程序中启用托管标识:

# Enable a system-assigned managed identity
az iot central app identity assign --name "myiotcentralapp" \
  --resource-group "MyIoTCentralResourceGroup" \
  --system-assigned

启用托管标识后,可以使用 CLI 配置角色分配。

使用 az role assignment create 命令创建角色分配。 例如,以下命令首先检索托管标识的主体 ID。 第二个命令将 Azure Event Hubs Data Sender 角色分配到 MyIoTCentralResourceGroup 资源组范围内的主体 ID:

scope=$(az group show -n "MyIoTCentralResourceGroup" --query "id" --output tsv)
spID=$(az iot central app identity show \
  --name "myiotcentralapp" \
  --resource-group "MyIoTCentralResourceGroup" \
  --query "principalId" --output tsv)
az role assignment create --assignee $spID --role "Azure Event Hubs Data Sender" \
  --scope $scope

若要了解有关角色分配的详细信息,请参阅:

后续步骤

了解如何从 Azure CLI 或 PowerShell 管理 Azure IoT Central 应用程序后,建议接下来执行以下步骤: