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

az batch node user

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

命令

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

az batch node user create

编辑

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

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

示例

使用公钥创建常规（非管理员）用户。

az batch node user create --pool-id pool1 --node-id node1 --name example_user --ssh-public-key example_public_key

必需参数

--node-id

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

--pool-id

包含计算节点的池的 ID。 Required.

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-endpoint

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

属性	值
参数组:	Batch Account Arguments

--account-key

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

属性	值
参数组:	Batch Account Arguments

--account-name

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

属性	值
参数组:	Batch Account Arguments

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--expiry-time

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

属性	值
参数组:	User Arguments

--is-admin

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

属性	值
参数组:	User Arguments

--json-file

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

--name

帐户的用户名。 Required.

属性	值
参数组:	User Arguments

--password

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

属性	值
参数组:	User Arguments

--ssh-public-key

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

属性	值
参数组:	User Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az batch node user delete

编辑

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

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

az batch node user delete --node-id
                          --pool-id
                          --user-name
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--acquire-policy-token]
                          [--change-reference]
                          [--yes]

必需参数

--node-id

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

--pool-id

包含计算节点的池的 ID。 Required.

--user-name

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

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-endpoint

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

属性	值
参数组:	Batch Account Arguments

--account-key

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

属性	值
参数组:	Batch Account Arguments

--account-name

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

属性	值
参数组:	Batch Account Arguments

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--yes -y

不要提示确认。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az batch node user reset

编辑

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

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

示例

在现有用户上设置新的 SSH 公钥，并将所有其他属性重置为其默认值。

az batch node user reset --pool-id pool1 --node-id node1 --user-name example_user --ssh-public-key new_public_key

必需参数

--node-id

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

--pool-id

包含计算节点的池的 ID。 Required.

--user-name

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

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--account-endpoint

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

属性	值
参数组:	Batch Account Arguments

--account-key

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

属性	值
参数组:	Batch Account Arguments

--account-name

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

属性	值
参数组:	Batch Account Arguments

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--expiry-time

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

属性	值
参数组:	Content Arguments

--json-file

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

--password

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

属性	值
参数组:	Content Arguments

--ssh-public-key

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

属性	值
参数组:	Content Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

反馈

此页面是否有帮助？

通过

az batch node user

命令

az batch node user create

示例

必需参数

可选参数

az batch node user delete

必需参数

可选参数

az batch node user reset

示例

必需参数

可选参数

反馈