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

az acr task credential

  • 参考

管理任务的凭据。 有关详细信息，请参阅 https://aka.ms/acr/tasks/cross-registry-authentication。

命令

名称 说明 类型 状态
az acr task credential add

将自定义注册表登录凭据添加到任务。

 核心 GA
az acr task credential list

列出任务的所有自定义注册表凭据。

 核心 GA
az acr task credential remove

删除任务的凭据。

 核心 GA
az acr task credential update

更新任务的注册表登录凭据。

 核心 GA

az acr task credential add

编辑

将自定义注册表登录凭据添加到任务。

az acr task credential add --login-server
                           --name
                           --registry
                           [--password]
                           [--resource-group]
                           [--use-identity]
                           [--username]

示例

使用纯文本用户名和密码将注册表登录凭据添加到任务。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    -u myusername -p mysecret

使用密钥保管库机密 URI 为用户名和密码和任务系统分配的标识将注册表登录凭据添加到任务。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    -u https://mykeyvault.vault.azure.net/secrets/secretusername -p https://mykeyvault.vault.azure.net/secrets/secretpassword \
    --use-identity [system]

使用密钥保管库机密 URI 将注册表登录凭据添加到任务中，以获取用户名和密码，以及其客户端 ID 提供的任务用户分配标识。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    -u https://mykeyvault.vault.azure.net/secrets/secretusername -p https://mykeyvault.vault.azure.net/secrets/secretpassword \
    --use-identity 00000000-0000-0000-0000-000000000000

使用密码的纯文本用户名和密码密钥保管库机密 URI 及其客户端 ID 提供的任务用户分配的标识，将注册表登录凭据添加到任务。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    -u myusername -p https://mykeyvault.vault.azure.net/secrets/secretpassword \
    --use-identity 00000000-0000-0000-0000-000000000000

使用密码的纯文本用户名和密码密钥保管库机密 URI 以及任务的默认托管标识（如果存在）将注册表登录凭据添加到任务。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    -u myusername -p https://mykeyvault.vault.azure.net/secrets/secretpassword

将注册表登录凭据添加到仅使用任务系统分配的标识向注册表进行身份验证的任务。

az acr task credential add -n taskname -r registryname --login-server myregistry.docker.io \
    --use-identity [system]

必需参数

--login-server

自定义注册表的登录服务器。 例如，“myregistry.azurecr.io”。

--name -n

任务的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

可选参数

--password -p

登录到自定义注册表的密码。 这可以是纯文本或密钥保管库机密 URI。

--resource-group -g

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

--use-identity

用于凭据的任务托管标识。 使用“[system]”来引用系统分配的标识或客户端 ID 来引用用户分配的标识。 有关详细信息，请参阅 https://aka.ms/acr/tasks/cross-registry-authentication。

--username -u

登录到自定义注册表的用户名。 这可以是纯文本或密钥保管库机密 URI。

全局参数
--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 acr task credential list

编辑

列出任务的所有自定义注册表凭据。

az acr task credential list --name
                            --registry
                            [--resource-group]

示例

列出任务的凭据。

az acr task credential list -n taskname -r registryname

必需参数

--name -n

任务的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

可选参数

--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 acr task credential remove

编辑

删除任务的凭据。

az acr task credential remove --login-server
                              --name
                              --registry
                              [--resource-group]

示例

从任务中删除注册表登录凭据。

az acr task credential remove -n taskname -r registryname --login-server myregistry.docker.io

必需参数

--login-server

自定义注册表的登录服务器。 例如，“myregistry.azurecr.io”。

--name -n

任务的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

可选参数

--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 acr task credential update

编辑

更新任务的注册表登录凭据。

az acr task credential update --login-server
                              --name
                              --registry
                              [--password]
                              [--resource-group]
                              [--use-identity]
                              [--username]

示例

更新任务的凭据

az acr task credential update -n taskname -r registryname --login-server myregistry.docker.io \
    -u myusername2 -p mysecret

必需参数

--login-server

自定义注册表的登录服务器。 例如，“myregistry.azurecr.io”。

--name -n

任务的名称。

--registry -r

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 az configure --defaults acr=<registry name>。

可选参数

--password -p

登录到自定义注册表的密码。 这可以是纯文本或密钥保管库机密 URI。

--resource-group -g

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

--use-identity

用于凭据的任务托管标识。 使用“[system]”来引用系统分配的标识或客户端 ID 来引用用户分配的标识。 有关详细信息，请参阅 https://aka.ms/acr/tasks/cross-registry-authentication。

--username -u

登录到自定义注册表的用户名。 这可以是纯文本或密钥保管库机密 URI。

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