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

az iot dps policy

管理Azure IoT 中心设备预配服务实例的共享访问策略。

命令

名称	说明	类型	状态
az iot dps policy create	在Azure IoT 中心设备预配服务实例中创建新的共享访问策略。	核心	GA
az iot dps policy delete	删除Azure IoT 中心设备预配服务实例中的共享访问策略。	核心	GA
az iot dps policy list	列出Azure IoT 中心设备预配服务实例中的所有共享访问策略。	核心	GA
az iot dps policy show	在Azure IoT 中心设备预配服务实例中显示共享访问策略的详细信息。	核心	GA
az iot dps policy update	更新Azure IoT 中心设备预配服务实例中的共享访问策略。	核心	GA

az iot dps policy create

在Azure IoT 中心设备预配服务实例中创建新的共享访问策略。

az iot dps policy create --dps-name
                         --pn
                         --rights {DeviceConnect, EnrollmentRead, EnrollmentWrite, RegistrationStatusRead, RegistrationStatusWrite, ServiceConfig}
                         [--no-wait]
                         [--primary-key]
                         [--resource-group]
                         [--secondary-key]

示例

在具有 EnrollmentRead 权限的Azure IoT 中心设备预配服务实例中创建新的共享访问策略

az iot dps policy create --dps-name MyDps --resource-group MyResourceGroup --policy-name MyPolicy --rights EnrollmentRead

必需参数

--dps-name -n

IoT 中心设备预配服务名称。

--pn --policy-name

DPS 访问策略的友好名称。

--rights -r

IoT 中心设备预配服务的访问权限。 对多个权限使用空格分隔的列表。

接受的值: DeviceConnect, EnrollmentRead, EnrollmentWrite, RegistrationStatusRead, RegistrationStatusWrite, ServiceConfig

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False

--primary-key

主 SAS 密钥值。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--secondary-key

辅助 SAS 密钥值。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot dps policy delete

删除Azure IoT 中心设备预配服务实例中的共享访问策略。

az iot dps policy delete --dps-name
                         --pn
                         [--no-wait]
                         [--resource-group]

示例

在Azure IoT 中心设备预配服务实例“MyDps”中删除共享访问策略“MyPolicy”

az iot dps policy delete --dps-name MyDps --resource-group MyResourceGroup --policy-name MyPolicy

必需参数

--dps-name -n

IoT 中心设备预配服务名称。

--pn --policy-name

DPS 访问策略的友好名称。

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot dps policy list

列出Azure IoT 中心设备预配服务实例中的所有共享访问策略。

az iot dps policy list --dps-name
                       [--resource-group]

示例

列出 Azure IoT 中心 设备预配服务实例“MyDps”中 MyDps 中的所有共享访问策略

az iot dps policy list --dps-name MyDps --resource-group MyResourceGroup

必需参数

--dps-name -n

IoT 中心设备预配服务名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot dps policy show

在Azure IoT 中心设备预配服务实例中显示共享访问策略的详细信息。

az iot dps policy show --dps-name
                       --pn
                       [--resource-group]

示例

在Azure IoT 中心设备预配服务实例“MyDps”中显示共享访问策略“MyPolicy”的详细信息

az iot dps policy show --dps-name MyDps --resource-group MyResourceGroup --policy-name MyPolicy

必需参数

--dps-name -n

IoT 中心设备预配服务名称。

--pn --policy-name

DPS 访问策略的友好名称。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot dps policy update

更新Azure IoT 中心设备预配服务实例中的共享访问策略。

az iot dps policy update --dps-name
                         --pn
                         [--no-wait]
                         [--primary-key]
                         [--resource-group]
                         [--rights {DeviceConnect, EnrollmentRead, EnrollmentWrite, RegistrationStatusRead, RegistrationStatusWrite, ServiceConfig}]
                         [--secondary-key]

示例

使用 EnrollmentWrite 权限更新Azure IoT 中心设备预配服务实例中的共享访问策略“MyPolicy”

az iot dps policy update --dps-name MyDps --resource-group MyResourceGroup --policy-name MyPolicy --rights EnrollmentWrite

必需参数

--dps-name -n

IoT 中心设备预配服务名称。

--pn --policy-name

DPS 访问策略的友好名称。

可选参数

--no-wait

不等待长时间运行的操作完成。

默认值: False

--primary-key

主 SAS 密钥值。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--rights -r

IoT 中心设备预配服务的访问权限。 对多个权限使用空格分隔的列表。

接受的值: DeviceConnect, EnrollmentRead, EnrollmentWrite, RegistrationStatusRead, RegistrationStatusWrite, ServiceConfig

--secondary-key

辅助 SAS 密钥值。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。