从Terraform调用PowerShell脚本时Add-AzIotHubDevice cmdlet未被识别

问题原因 #

报错Add-AzIotHubDevice : 该术语未被识别为 cmdlet、函数、脚本文件或可运行程序的名称，本质是当前PowerShell环境未安装或未加载Az.IotHub模块，该命令属于Azure PowerShell的Az.IotHub模块。

解决步骤 #

1. 安装Az.IotHub模块 #

打开PowerShell（建议用管理员权限），执行以下命令安装模块：

# 安装Az.IotHub模块，强制覆盖现有版本
Install-Module -Name Az.IotHub -Force -AllowClobber

如果首次安装PowerShell模块，可能需要先调整执行策略（请自行评估风险）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 确保脚本加载模块 #

修改你的sample.ps1，在开头添加模块导入命令，确保执行时能找到对应cmdlet：

# 强制导入Az.IotHub模块，加载失败则终止脚本
Import-Module Az.IotHub -ErrorAction Stop

# 后续执行你的Add-AzIotHubDevice命令
Add-AzIotHubDevice -ResourceGroupName "你的资源组" -IotHubName "你的IoT Hub名称" -DeviceId "设备ID" ...

3. 调整Terraform的local-exec命令（可选） #

如果不想修改脚本，也可以在Terraform的command中直接指定加载模块再执行脚本：

resource "null_resource" "example2" {
  provisioner "local-exec" {
    command = "powershell -Command \"Import-Module Az.IotHub; & ./sample.ps1\""
  }
}

4. 解决32/64位环境不兼容问题 #

如果你的Terraform是32位版本，可能默认调用32位PowerShell，而模块安装在64位环境中。此时可以指定64位PowerShell的完整路径执行：

resource "null_resource" "example2" {
  provisioner "local-exec" {
    command = "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe -file ./sample.ps1"
  }
}

内容的提问来源于stack exchange，提问作者Manoj R