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

az batch node user

管理 Batch 计算节点的用户帐户。

命令

名称	说明	类型	Status
az batch node user create	将用户帐户添加到 Batch 计算节点。	核心	GA
az batch node user delete	从指定的计算节点中删除用户帐户。	核心	GA
az batch node user reset	更新 Batch 计算节点上用户帐户的属性。 可以更新的未指定属性将重置为其默认值。	核心	GA

az batch node user create

将用户帐户添加到 Batch 计算节点。

az batch node user create --node-id
                          --pool-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--expiry-time]
                          [--is-admin]
                          [--json-file]
                          [--name]
                          [--password]
                          [--ssh-public-key]

必需参数

--node-id

要在其中创建用户帐户的计算机的 ID。

--pool-id

包含计算节点的池的 ID。

可选参数

--account-endpoint

Batch 服务终结点。 或者，由环境变量设置：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者，由环境变量设置：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者，按环境变量设置：AZURE_BATCH_ACCOUNT。

--expiry-time

如果省略，则默认值为从当前时间起的 1 天。 对于 Linux 计算节点，expiryTime 的精度高达一天。 预期格式为 ISO-8601 时间戳。

--is-admin

帐户是否应是计算节点上的管理员。 默认值为 false。 如此 如果存在标志。

--json-file

一个文件，其中包含 JSON 中的用户规范（格式与相应的 REST API 正文匹配）。 如果指定此参数，则忽略所有“User Arguments”。

--name

必需。

--password

Windows 计算节点（使用“cloudServiceConfiguration”创建的节点）或使用 Windows 映像引用的“virtualMachineConfiguration”创建的密码是必需的。 对于 Linux 计算节点，可以选择指定密码以及 sshPublicKey 属性。

--ssh-public-key

公钥应与 OpenSSH 编码兼容，并且应进行 base 64 编码。 只能为 Linux 计算节点指定此属性。 如果为 Windows 计算节点指定了此项，则 Batch 服务将拒绝请求;如果直接调用 REST API，则 HTTP 状态代码为 400（请求错误）。

全局参数

--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 batch node user delete

从指定的计算节点中删除用户帐户。

仅当用户帐户处于空闲或正在运行状态时，才能将其删除到计算节点。

az batch node user delete --node-id
                          --pool-id
                          --user-name
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--yes]

必需参数

--node-id

要删除用户帐户的计算机的 ID。

--pool-id

包含计算节点的池的 ID。

--user-name

要删除的用户帐户的名称。

可选参数

--account-endpoint

Batch 服务终结点。 或者，由环境变量设置：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者，由环境变量设置：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者，按环境变量设置：AZURE_BATCH_ACCOUNT。

--yes -y

不提示确认。

默认值: False

全局参数

--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 batch node user reset

更新 Batch 计算节点上用户帐户的属性。 可以更新的未指定属性将重置为其默认值。

az batch node user reset --node-id
                         --pool-id
                         --user-name
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--expiry-time]
                         [--json-file]
                         [--password]
                         [--ssh-public-key]

必需参数

--node-id

要在其中更新用户帐户的计算机的 ID。

--pool-id

包含计算节点的池的 ID。

--user-name

要更新的用户帐户的名称。

可选参数

--account-endpoint

Batch 服务终结点。 或者，由环境变量设置：AZURE_BATCH_ENDPOINT。

--account-key

Batch 帐户密钥。 或者，由环境变量设置：AZURE_BATCH_ACCESS_KEY。

--account-name

Batch 帐户名称。 或者，按环境变量设置：AZURE_BATCH_ACCOUNT。

--expiry-time

如果省略，则默认值为从当前时间起的 1 天。 对于 Linux 计算节点，expiryTime 的精度高达一天。 预期格式为 ISO-8601 时间戳。

--json-file

一个文件，其中包含 JSON 中的节点更新用户参数规范（格式与相应的 REST API 正文匹配）。 如果指定此参数，则忽略所有“Node Update User Arguments”。

--password

Windows 计算节点（使用“cloudServiceConfiguration”创建的节点）或使用 Windows 映像引用的“virtualMachineConfiguration”创建的密码是必需的。 对于 Linux 计算节点，可以选择指定密码以及 sshPublicKey 属性。 如果省略，则会删除任何现有密码。

--ssh-public-key

公钥应与 OpenSSH 编码兼容，并且应进行 base 64 编码。 只能为 Linux 计算节点指定此属性。 如果为 Windows 计算节点指定了此项，则 Batch 服务将拒绝请求;如果直接调用 REST API，则 HTTP 状态代码为 400（请求错误）。 如果省略，将删除任何现有的 SSH 公钥。

全局参数

--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 获取完整的调试日志。