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

az acr

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 详细了解扩展。

使用 Azure 容器注册表管理专用注册表。

命令

名称	说明	类型	Status
az acr agentpool	使用 Azure 容器注册表管理专用任务代理池。	核心	预览
az acr agentpool create	为Azure 容器注册表创建代理池。	核心	预览
az acr agentpool delete	删除代理池。	核心	预览
az acr agentpool list	列出Azure 容器注册表的代理池。	核心	预览
az acr agentpool show	获取Azure 容器注册表的指定代理池的属性。	核心	预览
az acr agentpool update	更新Azure 容器注册表的代理池。	核心	预览
az acr artifact-streaming	管理 ACR 中任何存储库或支持的映像的项目流式处理。	核心	预览
az acr artifact-streaming create	为 ACR 中的特定映像创建引用者流项目。	核心	预览
az acr artifact-streaming operation	管理 ACR 的流项目创建操作。	核心	预览
az acr artifact-streaming operation cancel	取消 ACR 的给定流项目操作。	核心	预览
az acr artifact-streaming operation show	检查 ACR 中项目流式处理的操作状态。	核心	预览
az acr artifact-streaming show	显示是否在存储库中为Azure 容器注册表启用了项目流式处理。	核心	预览
az acr artifact-streaming update	为给定注册表下新推送的映像启用或禁用自动创建流项目。	核心	预览
az acr build	对快速生成进行排队，为Azure 容器注册表提供流式处理日志。	核心	GA
az acr cache	管理 Azure 容器注册表中的缓存规则。	核心	GA
az acr cache create	创建缓存规则。	核心	GA
az acr cache delete	删除缓存规则。	核心	GA
az acr cache list	列出Azure 容器注册表中的缓存规则。	核心	GA
az acr cache show	显示缓存规则。	核心	GA
az acr cache update	更新缓存规则上的凭据集。	核心	GA
az acr check-health	获取环境中的运行状况信息以及目标注册表（可选）。	核心	GA
az acr check-name	检查 Azure 容器注册表名称是否有效且可供使用。	核心	GA
az acr config	为 Azure 容器注册表配置策略。	核心	GA
az acr config authentication-as-arm	管理 Azure 容器注册表的“Azure AD 身份验证为 ARM”策略。	核心	预览
az acr config authentication-as-arm show	为Azure 容器注册表显示配置的“Azure AD 身份验证为 ARM”策略。	核心	预览
az acr config authentication-as-arm update	更新Azure 容器注册表的“Azure AD 身份验证为 ARM”策略。	核心	预览
az acr config content-trust	管理 Azure 容器注册表的内容信任策略。	核心	GA
az acr config content-trust show	显示为Azure 容器注册表配置的内容信任策略。	核心	GA
az acr config content-trust update	更新Azure 容器注册表的内容信任策略。	核心	GA
az acr config retention	管理 Azure 容器注册表的保留策略。	核心	预览
az acr config retention show	显示为Azure 容器注册表配置的保留策略。	核心	预览
az acr config retention update	更新Azure 容器注册表的保留策略。	核心	预览
az acr config soft-delete	管理 Azure 容器注册表的软删除策略。	核心	预览
az acr config soft-delete show	显示为Azure 容器注册表配置的软删除策略。	核心	预览
az acr config soft-delete update	更新Azure 容器注册表的软删除策略。	核心	预览
az acr connected-registry	使用 Azure 容器注册表管理连接的注册表资源。	核心	预览
az acr connected-registry create	为Azure 容器注册表创建连接的注册表。	核心	预览
az acr connected-registry deactivate	从Azure 容器注册表停用连接的注册表。	核心	预览
az acr connected-registry delete	从Azure 容器注册表中删除连接的注册表。	核心	预览
az acr connected-registry get-settings	检索激活连接注册表所需的信息，并创建或轮换同步令牌凭据。	核心	预览
az acr connected-registry install	帮助访问安装连接的注册表所需的信息。 有关详细信息，请参阅 https://aka.ms/acr/connected-registry。	核心	预览和弃用
az acr connected-registry install info	检索激活连接的注册表所需的信息。	核心	预览和弃用
az acr connected-registry install renew-credentials	检索激活连接注册表所需的信息，并续订同步令牌凭据。	核心	预览和弃用
az acr connected-registry list	列出当前父注册表下的所有已连接注册表。	核心	预览
az acr connected-registry list-client-tokens	列出与特定连接的注册表关联的所有客户端令牌。	核心	预览
az acr connected-registry permissions	跨多个连接的注册表管理存储库权限。 有关详细信息，请参阅 https://aka.ms/acr/connected-registry。	核心	预览
az acr connected-registry permissions show	显示连接的注册表同步范围映射信息。	核心	预览
az acr connected-registry permissions update	跨所有必需的连接注册表同步范围映射添加和删除存储库权限。	核心	预览
az acr connected-registry repo	更新所有必要的连接的注册表同步范围映射存储库权限。	核心	预览和弃用
az acr connected-registry show	显示连接的注册表详细信息。	核心	预览
az acr connected-registry update	更新Azure 容器注册表的连接注册表。	核心	预览
az acr create	创建 Azure 容器注册表。	核心	GA
az acr credential	管理 Azure 容器注册表的登录凭据。	核心	GA
az acr credential-set	管理 Azure 容器注册表中的凭据集。	核心	GA
az acr credential-set create	创建凭据集。	核心	GA
az acr credential-set delete	删除凭据集。	核心	GA
az acr credential-set list	列出Azure 容器注册表中的凭据集。	核心	GA
az acr credential-set show	显示凭据集。	核心	GA
az acr credential-set update	更新凭据集上的用户名或密码 Azure 密钥库机密 ID。	核心	GA
az acr credential renew	重新生成 Azure 容器注册表的登录凭据。	核心	GA
az acr credential show	获取 Azure 容器注册表的登录凭据。	核心	GA
az acr delete	删除 Azure 容器注册表。	核心	GA
az acr encryption	管理容器注册表加密。	核心	GA
az acr encryption rotate-key	轮换容器注册表的加密密钥（更新）。	核心	GA
az acr encryption show	显示容器注册表的加密详细信息。	核心	GA
az acr export-pipeline	管理 ACR 导出管道。	扩展	预览
az acr export-pipeline create	创建导出管道。	扩展	预览
az acr export-pipeline delete	删除导出管道。	扩展	预览
az acr export-pipeline list	列出容器注册表上的导出管道。	扩展	预览
az acr export-pipeline show	详细显示导出管道。	扩展	预览
az acr helm	管理 Azure 容器注册表的 helm 图表。	核心	已放弃
az acr helm delete	删除Azure 容器注册表中的 helm 图表版本。	核心	已放弃
az acr helm install-cli	下载并安装 Helm 命令行工具。	核心	预览和弃用
az acr helm list	列出Azure 容器注册表中的所有 helm 图表。	核心	已放弃
az acr helm push	将 helm 图表包推送到Azure 容器注册表。	核心	已放弃
az acr helm repo	管理 Azure 容器注册表的 helm 图表存储库。	核心	已放弃
az acr helm repo add	通过 Helm CLI 从Azure 容器注册表添加 helm 图表存储库。	核心	已放弃
az acr helm show	描述Azure 容器注册表中的 helm 图表。	核心	已放弃
az acr identity	管理容器注册表的服务（托管）标识。	核心	GA
az acr identity assign	将托管标识分配给容器注册表。	核心	GA
az acr identity remove	从容器注册表中删除托管标识。	核心	GA
az acr identity show	显示容器注册表的标识详细信息。	核心	GA
az acr import	将映像从另一个容器注册表导入到 Azure 容器注册表。 导入不再需要 docker 拉取、docker 标记、docker 推送。 对于较大的图像，请考虑使用 --no-wait。	核心	GA
az acr import-pipeline	管理 ACR 导入管道。	扩展	预览
az acr import-pipeline create	创建导入管道。	扩展	预览
az acr import-pipeline delete	删除导入管道。	扩展	预览
az acr import-pipeline list	列出容器注册表上的导入管道。	扩展	预览
az acr import-pipeline show	详细显示导入管道。	扩展	预览
az acr list	列出当前订阅下的所有容器注册表。	核心	GA
az acr login	通过 Docker CLI 登录到 Azure 容器注册表。	核心	GA
az acr manifest	管理 Azure 容器注册表中的项目清单。	核心	预览
az acr manifest delete	删除Azure 容器注册表中的清单。	核心	预览
az acr manifest list	列出Azure 容器注册表存储库中的清单。	核心	预览
az acr manifest list-deleted	列出Azure 容器注册表存储库中的软删除清单。	核心	预览
az acr manifest list-deleted-tags	列出Azure 容器注册表存储库中的软删除标记。	核心	预览
az acr manifest list-metadata	列出Azure 容器注册表存储库中清单的元数据。	核心	预览
az acr manifest list-referrers	列出Azure 容器注册表中清单的引用者。	核心	预览
az acr manifest metadata	管理 Azure 容器注册表中的项目清单元数据。	核心	预览和弃用
az acr manifest metadata list	列出Azure 容器注册表存储库中清单的元数据。	核心	预览和弃用
az acr manifest metadata show	获取Azure 容器注册表中的项目的元数据。	核心	预览和弃用
az acr manifest metadata update	更新Azure 容器注册表中项目的清单元数据。	核心	预览和弃用
az acr manifest restore	还原Azure 容器注册表中的软删除项目和标记。	核心	预览
az acr manifest show	获取Azure 容器注册表中的清单。	核心	预览
az acr manifest show-metadata	获取Azure 容器注册表中的项目的元数据。	核心	预览
az acr manifest update-metadata	更新Azure 容器注册表中项目的清单元数据。	核心	预览
az acr network-rule	管理 Azure 容器注册表的网络规则。	核心	GA
az acr network-rule add	添加网络规则。	核心	GA
az acr network-rule list	列出网络规则。	核心	GA
az acr network-rule remove	删除网络规则。	核心	GA
az acr pack	管理使用云本机生成包的Azure 容器注册表任务。	核心	预览
az acr pack build	将生成应用的快速生成任务排入队列，并将其推送到Azure 容器注册表。	核心	预览
az acr pipeline-run	管理 ACR 导入和导出管道运行。	扩展	预览
az acr pipeline-run clean	删除注册表上所有失败的管道运行。	扩展	预览
az acr pipeline-run create	创建管道运行。	扩展	预览
az acr pipeline-run delete	删除管道运行。	扩展	预览
az acr pipeline-run list	列出容器注册表上所有管道的管道运行。	扩展	预览
az acr pipeline-run show	详细显示管道运行。	扩展	预览
az acr private-endpoint-connection	管理容器注册表专用终结点连接。	核心	GA
az acr private-endpoint-connection approve	批准容器注册表的专用终结点连接请求。	核心	GA
az acr private-endpoint-connection delete	删除容器注册表的专用终结点连接请求。	核心	GA
az acr private-endpoint-connection list	列出与容器注册表的所有专用终结点连接。	核心	GA
az acr private-endpoint-connection reject	拒绝容器注册表的专用终结点连接请求。	核心	GA
az acr private-endpoint-connection show	显示容器注册表的专用终结点连接的详细信息。	核心	GA
az acr private-link-resource	管理注册表专用链接资源。	核心	GA
az acr private-link-resource list	列出注册表支持的专用链接资源。	核心	GA
az acr query	使用 Kusto 查询语言 查询 ACR 中的内容。	扩展	GA
az acr replication	管理 Azure 容器注册表的异地复制区域。	核心	GA
az acr replication create	为 Azure 容器注册表创建重复的区域。	核心	GA
az acr replication delete	从Azure 容器注册表中删除复制的区域。	核心	GA
az acr replication list	列出异地复制Azure 容器注册表的所有区域。	核心	GA
az acr replication show	获取复制区域的详细信息。	核心	GA
az acr replication update	更新复制。	核心	GA
az acr repository	管理 Azure 容器注册表的存储库（映像名称）。	核心	GA
az acr repository delete	删除 Azure 容器注册表中的存储库或映像。	核心	GA
az acr repository list	列出 Azure 容器注册表中的存储库。	核心	GA
az acr repository list-deleted	列出Azure 容器注册表中的软删除存储库。	核心	预览
az acr repository show	获取 Azure 容器注册表中的存储库或映像的属性。	核心	GA
az acr repository show-manifests	在Azure 容器注册表中显示存储库的清单。	核心	已放弃
az acr repository show-tags	显示 Azure 容器注册表中的存储库的标记。	核心	GA
az acr repository untag	取消标记 Azure 容器注册表中的映像。	核心	GA
az acr repository update	更新 Azure 容器注册表中的存储库或映像的属性。	核心	GA
az acr run	为Azure 容器注册表提供流式传输日志的快速运行排队。	核心	GA
az acr scope-map	管理 Azure 容器注册表的范围访问映射。	核心	GA
az acr scope-map create	为Azure 容器注册表创建范围映射。	核心	GA
az acr scope-map delete	删除Azure 容器注册表的范围映射。	核心	GA
az acr scope-map list	列出Azure 容器注册表的所有范围映射。	核心	GA
az acr scope-map show	显示Azure 容器注册表的范围映射的详细信息和属性。	核心	GA
az acr scope-map update	更新Azure 容器注册表的范围映射。	核心	GA
az acr show	获取 Azure 容器注册表的详细信息。	核心	GA
az acr show-endpoints	显示注册表终结点。	核心	GA
az acr show-usage	获取 Azure 容器注册表的存储使用情况。	核心	GA
az acr task	使用 Azure 容器注册表管理生成、测试和 OS 和框架修补容器映像的步骤集合。	核心	GA
az acr task cancel-run	取消指定的Azure 容器注册表运行。	核心	GA
az acr task create	创建用于生成、测试和 OS 和框架修补容器的一系列步骤。 任务支持 git 提交和基础映像更新中的触发器。	核心	GA
az acr task credential	管理任务的凭据。 有关详细信息，请参阅 https://aka.ms/acr/tasks/cross-registry-authentication。	核心	GA
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 delete	从Azure 容器注册表中删除任务。	核心	GA
az acr task identity	任务的托管标识。 有关详细信息，请参阅 https://aka.ms/acr/tasks/task-create-managed-identity。	核心	GA
az acr task identity assign	更新任务的托管标识。	核心	GA
az acr task identity remove	删除任务的托管标识。	核心	GA
az acr task identity show	显示任务的托管标识。	核心	GA
az acr task list	列出Azure 容器注册表的任务。	核心	GA
az acr task list-runs	列出Azure 容器注册表执行的所有运行，并能够按特定任务进行筛选。	核心	GA
az acr task logs	显示特定运行的日志。 如果未提供运行 ID，则显示上次创建的运行的日志。	核心	GA
az acr task run	手动触发可能正在等待 git 提交或基础映像更新触发器的任务。	核心	GA
az acr task show	获取Azure 容器注册表的命名任务的属性。	核心	GA
az acr task show-run	获取Azure 容器注册表任务的指定运行的属性。	核心	GA
az acr task timer	管理任务的计时器触发器。	核心	GA
az acr task timer add	将计时器触发器添加到任务。	核心	GA
az acr task timer list	列出任务的所有计时器触发器。	核心	GA
az acr task timer remove	从任务中删除计时器触发器。	核心	GA
az acr task timer update	更新任务的计时器触发器。	核心	GA
az acr task update	更新Azure 容器注册表的任务。	核心	GA
az acr task update-run	修补Azure 容器注册表任务的运行属性。	核心	GA
az acr taskrun	使用 Azure 容器注册表管理任务运行。	核心	预览
az acr taskrun delete	从Azure 容器注册表中删除任务运行。	核心	预览
az acr taskrun list	列出Azure 容器注册表的任务运行。	核心	预览
az acr taskrun logs	显示特定任务运行的运行日志。	核心	预览
az acr taskrun show	获取Azure 容器注册表的命名任务运行的属性。	核心	预览
az acr token	管理Azure 容器注册表的令牌。	核心	GA
az acr token create	创建与Azure 容器注册表的范围映射关联的令牌。	核心	GA
az acr token credential	管理Azure 容器注册表令牌的凭据。	核心	GA
az acr token credential delete	删除令牌凭据。	核心	GA
az acr token credential generate	为Azure 容器注册表生成或替换令牌的一个或两个密码。 有关使用令牌和密码访问容器注册表，请参阅 https://aka.ms/acr/repo-permissions。	核心	GA
az acr token delete	删除Azure 容器注册表的令牌。	核心	GA
az acr token list	列出Azure 容器注册表的所有令牌。	核心	GA
az acr token show	显示Azure 容器注册表令牌的详细信息和属性。	核心	GA
az acr token update	更新Azure 容器注册表的令牌（替换关联的范围映射）。	核心	GA
az acr update	更新 Azure 容器注册表。	核心	GA
az acr webhook	管理 Azure 容器注册表的 Webhook。	核心	GA
az acr webhook create	为 Azure 容器注册表创建 webhook。	核心	GA
az acr webhook delete	从 Azure 容器注册表中删除 webhook。	核心	GA
az acr webhook get-config	获取 webhook 的服务 URI 和自定义标头。	核心	GA
az acr webhook list	列出 Azure 容器注册表的所有 webhook。	核心	GA
az acr webhook list-events	列出 webhook 的最近事件。	核心	GA
az acr webhook ping	触发 webhook 的 ping 事件。	核心	GA
az acr webhook show	获取 webhook 详细信息。	核心	GA
az acr webhook update	更新 Webhook。	核心	GA

az acr build

对快速生成进行排队，为Azure 容器注册表提供流式处理日志。

az acr build --registry
             [--agent-pool]
             [--auth-mode {Default, None}]
             [--build-arg]
             [--file]
             [--image]
             [--log-template]
             [--no-format]
             [--no-logs]
             [--no-push]
             [--no-wait]
             [--platform]
             [--resource-group]
             [--secret-build-arg]
             [--target]
             [--timeout]
             [<SOURCE_LOCATION>]

示例

将本地上下文作为 Linux 生成排队，对其进行标记，并将其推送到注册表。

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry .

将本地上下文作为 Linux 生成排队，对其进行标记，并在不流式处理日志的情况下将其推送到注册表。

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-logs .

将本地上下文作为 Linux 生成排队，而不将其推送到注册表。

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-push .

将本地上下文作为 Linux 生成排队，而不将其推送到注册表。

az acr build -r myregistry .

将远程 GitHub 上下文作为 Windows 生成排队，对其进行标记，并将其推送到注册表。

az acr build -r myregistry https://github.com/Azure/acr-builder.git -f Windows.Dockerfile --platform windows

将远程 OCI 项目上下文生成排队。

az acr build -r myregistry oci://myregistry.azurecr.io/myartifact:mytag

在 arm/v7 体系结构上将本地上下文作为 Linux 版本排队，对其进行标记，并将其推送到注册表。

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --platform linux/arm/v7

必需参数

--registry -r

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

可选参数

--agent-pool

预览

代理池的名称。

--auth-mode

源注册表的身份验证模式。

接受的值: Default, None

--build-arg

“--build-arg name[=value]”格式的生成参数。 多次传递“--build-arg name[=value]”支持倍数。 重要说明：此参数不应包含任何类型的密码、访问令牌或敏感信息。 出于调试目的，ACR 团队将显示此参数值。

--file -f

docker 文件的相对路径，指向源代码根文件夹。 默认为“Dockerfile”。

--image -t

图像的名称和标记，格式为：“-t 存储库/image：tag”。 通过多次传递 -t 来支持多个标记。

--log-template

预览

使用“log/repo：tag”格式（例如“acr/logs：{{.Run.ID}}”）运行日志项目的存储库和标记模板。 仅适用于已启用 CMK 的注册表。

--no-format

指示日志是否应以原始格式显示。

默认值: False

--no-logs

成功排队生成后，不显示日志。

默认值: False

--no-push

指示是否应将生成的映像推送到注册表。

默认值: False

--no-wait

不要等待生成完成，并在排队生成后立即返回。

默认值: False

--platform

运行生成/任务的平台，例如“windows”和“linux”。 在生成命令中使用时，还可以在生成的图像的“os/arch/variant”格式中指定它。 例如，linux/arm/v7。 “arch”和“variant”部分是可选的。

--resource-group -g

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

--secret-build-arg

“--secret-build-arg name[=value]”格式的机密生成参数。 多次传递“--secret-build-arg name[=value]”支持倍数。 此参数值不会浮出 ACR 团队，更适合敏感信息。

--target

目标生成阶段的名称。

--timeout

超时（以秒为单位）。

<SOURCE_LOCATION>

本地源代码目录路径（例如，'./src'）或 git 存储库（例如，''https://github.com/Azure-Samples/acr-build-helloworld-node.git）或远程 tarball（例如，''http://server/context.tar.gz）的 URL 或 Azure 容器注册表中 OCI 项目的存储库（例如，“oci://myregistry.azurecr.io/myartifact:mytag”。

全局参数

--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 check-health

获取环境中的运行状况信息以及目标注册表（可选）。

az acr check-health [--ignore-errors]
                    [--name]
                    [--vnet]
                    [--yes]

示例

获取目标注册表“myregistry”的运行状况状态，跳过请求映像的确认。

az acr check-health -n myregistry -y

获取环境的运行状况状态，而不会在第一次错误时停止。

az acr check-health --ignore-errors

可选参数

--ignore-errors

提供所有运行状况检查，即使发现错误。

默认值: False

--name -n

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

--vnet

虚拟网络 ID，以便在 VNET 中运行此命令，以验证 DNS 路由到专用终结点。

--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 acr check-name

检查 Azure 容器注册表名称是否有效且可供使用。

az acr check-name --name

示例

检查注册表名称是否已存在。

az acr check-name -n doesthisnameexist

必需参数

--name -n

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

创建 Azure 容器注册表。

az acr create --name
              --resource-group
              --sku {Basic, Premium, Standard}
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--default-action {Allow, Deny}]
              [--identity]
              [--key-encryption-key]
              [--location]
              [--public-network-enabled {false, true}]
              [--tags]
              [--workspace]
              [--zone-redundancy {Disabled, Enabled}]

示例

使用标准 SKU 创建托管容器注册表。

az acr create -n myregistry -g MyResourceGroup --sku Standard

必需参数

--name -n

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

--resource-group -g

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

--sku

容器注册表的 SKU。

接受的值: Basic, Premium, Standard

可选参数

--admin-enabled

指示是否启用管理员用户。

接受的值: false, true

默认值: False

--allow-exports

预览

配置 exportPolicy 以允许/禁止从此注册表导出项目。 可以通过导入或传输操作导出项目。 有关详细信息，请访问 https://aka.ms/acr/export-policy。

接受的值: false, true

--allow-metadata-search

预览

启用或禁用注册表的元数据搜索功能。 如果未指定，则默认设置为禁用。

接受的值: false, true

--allow-trusted-services

预览

允许受信任的 Azure 服务访问网络受限注册表。 有关详细信息，请访问 https://aka.ms/acr/trusted-services。 默认值是允许的。

接受的值: false, true

--default-action

如果未匹配规则，则应用的默认操作。 仅适用于高级 SKU。

接受的值: Allow, Deny

--identity

如果在同一资源组中，请使用分配的托管标识资源 ID 或名称。

--key-encryption-key

密钥保管库密钥 URI。 若要启用自动轮换，请提供无版本密钥 URI。 对于手动轮换，请提供版本控制密钥 URI。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--public-network-enabled

允许对容器注册表进行公用网络访问。 默认值是允许的。

接受的值: false, true

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--workspace

预览

要向其发送注册表诊断日志的 Log Analytics 工作区的名称或 ID。 将启用所有事件。 可以使用“az monitor log-analytics workspace create”创建一个。 可能会应用额外的计费。

--zone-redundancy

预览

指示是否应为此注册表或复制启用区域冗余。 有关详细信息，如支持的位置，请访问 https://aka.ms/acr/az。 区域冗余无法更新。 默认值为“Disabled”。

接受的值: Disabled, Enabled

全局参数

--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 delete

删除 Azure 容器注册表。

az acr delete --name
              [--resource-group]
              [--yes]

示例

删除Azure 容器注册表。

az acr delete -n myregistry

必需参数

--name -n

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

可选参数

--resource-group -g

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

--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 acr import

将映像从另一个容器注册表导入到 Azure 容器注册表。 导入不再需要 docker 拉取、docker 标记、docker 推送。 对于较大的图像，请考虑使用 --no-wait。

az acr import --name
              --source
              [--force]
              [--image]
              [--no-wait]
              [--password]
              [--registry]
              [--repository]
              [--resource-group]
              [--username]

示例

将图像从“sourceregistry”导入到“myregistry”。 映像继承其源存储库和标记名称。

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag

从 Docker 中心上的公共存储库导入映像。 映像使用指定的存储库和标记名称。

az acr import -n myregistry --source docker.io/library/hello-world:latest -t targetrepository:targettag

使用专用存储库的用户名和密码从专用存储库导入映像。 这也适用于 Azure 外部的注册表。

az acr import -n myregistry --source myprivateregistry.azurecr.io/hello-world:latest -u username -p password

从其他订阅中的 Azure 容器注册表导入映像。

az acr import -n myregistry --source sourcerepository:sourcetag -t targetrepository:targettag \
    -r /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/sourceRegistry

导入映像，而无需等待成功完成。 导入期间失败不会反映。 运行“az acr repository show-tags”以确认导入成功。

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag --no-wait

必需参数

--name -n

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

--source

包含注册表登录服务器的源映像名称或完全限定的源。 如果使用 --registry ， --source 将始终解释为源图像，即使它包含登录服务器。

可选参数

--force

覆盖要导入的映像的现有标记。

默认值: False

--image -t

图像的名称和标记，格式为：“-t 存储库/image：tag”。 通过多次传递 -t 来支持多个标记。

--no-wait

不要等待导入完成，并在排队导入后立即返回。

默认值: False

--password -p

源容器注册表的密码。

--registry -r

源 Azure 容器注册表。 这可以是源注册表的名称、登录服务器或资源 ID。

--repository

仅清单映像副本的存储库名称。 通过多次传递 --repository 支持多个副本。

--resource-group -g

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

--username -u

源容器注册表的用户名。

全局参数

--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 list

列出当前订阅下的所有容器注册表。

az acr list [--resource-group]

示例

列出容器注册表，并在表中跨多个资源组显示结果。

az acr list -o table

列出资源组中的容器注册表，并在表中显示结果。

az acr list -g MyResourceGroup -o table

可选参数

--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 login

通过 Docker CLI 登录到 Azure 容器注册表。

必须在计算机上安装 Docker。 完成后，使用“docker 注销”注销。（如果只需要访问令牌，并且不想安装 Docker，请指定“--expose-token”。

az acr login --name
             [--expose-token]
             [--password]
             [--resource-group]
             [--suffix]
             [--username]

示例

登录到Azure 容器注册表

az acr login -n myregistry

获取Azure 容器注册表访问令牌

az acr login -n myregistry --expose-token

必需参数

--name -n

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

可选参数

--expose-token -t

公开访问令牌，而不是通过 Docker CLI 自动登录。

默认值: False

--password -p

用于登录到容器注册表的密码。

--resource-group -g

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

--suffix

注册表登录服务器中的租户后缀。 如果注册表登录服务器的格式为“registry-tenant.azurecr.io”，则可以指定“--suffix tenant”。 如果从其他订阅访问注册表，或者你有权访问映像，但无权管理注册表资源，则适用。

--username -u

用于登录到容器注册表的用户名。

全局参数

--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 query

使用 Kusto 查询语言 查询 ACR 中的内容。

使用Kusto 查询语言查询Azure 容器注册表中的项目和图像。 OCI 清单属性（如摘要、主题、批注等）可用于查询、筛选和排序搜索结果。

az acr query --kql-query
             --name
             [--password]
             [--repository]
             [--skip-token]
             [--username]

示例

提取单个清单

az acr query -n $MyRegistry -q "Manifests | limit 1"

对存储库中的所有清单进行计数$RepositoryName

az acr query -n $MyRegistry -q "Manifests" -o table

按创建日期的顺序列出存储库$RepositoryName中的所有清单

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | order by createdAt desc"

查询存储库中由$Signature签名的所有摘要$RepositoryName

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | where annotations['org.cncf.notary.signature.subject'] == $Signature | project createdAt, digest, subject"

使用跳过令牌查询注册表中的摘要并按摘要进行排序（对于分页结果）

az acr query -n $MyRegistry -q "Manifests | project digest | order by digest asc" --skip-token eyAibm8iOiAibHVjayIsICJidXQiOiAibmljZSIsICJ0cnkiOiAiISIgfQ==

必需参数

--kql-query -q

要执行的 KQL 查询。

--name -n

要对其运行查询的容器注册表的名称。

可选参数

--password -p

注册表密码。

--repository

要对其运行查询的存储库。 如果未提供存储库，则查询在注册表级别运行。

--skip-token

跳过令牌以获取查询的下一页（如果适用）。

--username -u

注册表用户名。

全局参数

--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 run

为Azure 容器注册表提供流式传输日志的快速运行排队。

az acr run --registry
           [--agent-pool]
           [--auth-mode {Default, None}]
           [--cmd]
           [--file]
           [--log-template]
           [--no-format]
           [--no-logs]
           [--no-wait]
           [--platform]
           [--resource-group]
           [--set]
           [--set-secret]
           [--timeout]
           [--values]
           [<SOURCE_LOCATION>]

示例

将运行排队以执行容器命令。

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null

使用标准输入中的任务定义对运行进行排队。 “Ctrl + Z”（Windows）或“Ctrl + D”（Linux）将终止输入流。

az acr run -r myregistry -f - /dev/null

将运行排队以执行通过管道传递的任务。

cat task.yaml | az acr run -r myregistry -f - /dev/null

使用流式处理日志将本地上下文排入队列，推送到 ACR。

az acr run -r myregistry -f bash-echo.yaml ./workspace

使用流式处理日志将远程 git 上下文排队。

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f hello-world.yaml

使用流式处理日志对远程 git 上下文进行排队，并在 Linux 平台上运行任务。

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f build-hello-world.yaml --platform linux

将远程 OCI 项目上下文排队并运行任务。

az acr run -r myregistry oci://myregistry.azurecr.io/myartifact:mytag -f hello-world.yaml

必需参数

--registry -r

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

可选参数

--agent-pool

预览

代理池的名称。

--auth-mode

源注册表的身份验证模式。

接受的值: Default, None

--cmd

要执行的命令。 这还支持其他 docker 运行参数（https://docs.docker.com/engine/reference/commandline/run/）甚至其他 docker 命令（https://docs.docker.com/engine/reference/commandline/docker/）。

--file -f

相对于源上下文的任务模板/定义文件路径。 可以通过标准输入通过管道传递文件，也可以是“-”。

--log-template

预览

使用“log/repo：tag”格式（例如“acr/logs：{{.Run.ID}}”）运行日志项目的存储库和标记模板。 仅适用于已启用 CMK 的注册表。

--no-format

指示日志是否应以原始格式显示。

默认值: False

--no-logs

成功排队生成后，不显示日志。

默认值: False

--no-wait

不要等待运行完成，并在运行排队后立即返回。

默认值: False

--platform

运行生成/任务的平台，例如“windows”和“linux”。 在生成命令中使用时，还可以在生成的图像的“os/arch/variant”格式中指定它。 例如，linux/arm/v7。 “arch”和“variant”部分是可选的。

--resource-group -g

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

--set

“name[=value]”格式的值。 传递 --set 多次支持的倍数。

--set-secret

“--set name[=value]”格式的机密值。 传递 --set 多次支持的倍数。

--timeout

超时（以秒为单位）。

--values

任务值相对于源上下文的文件路径。

<SOURCE_LOCATION>

本地源代码目录路径（例如，“./src”）或 git 存储库（例如，“”）https://github.com/Azure-Samples/acr-build-helloworld-node.git或远程 tarball（例如，“”）http://server/context.tar.gz或 Azure 容器注册表中 OCI 项目的存储库（例如，“oci://myregistry.azurecr.io/myartifact:mytag”）。 如果指定了“/dev/null”，该值将设置为“无”并忽略。

全局参数

--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 show

获取 Azure 容器注册表的详细信息。

az acr show --name
            [--resource-group]

示例

获取Azure 容器注册表的登录服务器。

az acr show -n myregistry --query loginServer

获取Azure 容器注册表的详细信息

az acr show --name myregistry --resource-group MyResourceGroup

必需参数

--name -n

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 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 show-endpoints

显示注册表终结点。

az acr show-endpoints --name
                      [--resource-group]

必需参数

--name -n

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 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 show-usage

获取 Azure 容器注册表的存储使用情况。

az acr show-usage --name
                  [--resource-group]

示例

获取 Azure 容器注册表的存储使用情况。

az acr show-usage -n myregistry

必需参数

--name -n

容器注册表的名称。 它应以小写形式指定。 可以使用 配置默认注册表名称 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 update

更新 Azure 容器注册表。

az acr update --name
              [--add]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--anonymous-pull-enabled {false, true}]
              [--data-endpoint-enabled {false, true}]
              [--default-action {Allow, Deny}]
              [--force-string]
              [--public-network-enabled {false, true}]
              [--remove]
              [--resource-group]
              [--set]
              [--sku {Basic, Premium, Standard}]
              [--tags]

示例

更新Azure 容器注册表的标记。

az acr update -n myregistry --tags key1=value1 key2=value2

为Azure 容器注册表启用管理员用户帐户。

az acr update -n myregistry --admin-enabled true

必需参数

--name -n

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

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--admin-enabled

指示是否启用管理员用户。

接受的值: false, true

--allow-exports

预览

配置 exportPolicy 以允许/禁止从此注册表导出项目。 可以通过导入或传输操作导出项目。 有关详细信息，请访问 https://aka.ms/acr/export-policy。

接受的值: false, true

--allow-metadata-search

预览

启用或禁用注册表的元数据搜索功能。

接受的值: false, true

--allow-trusted-services

预览

允许受信任的 Azure 服务访问网络受限注册表。 有关详细信息，请访问 https://aka.ms/acr/trusted-services。

接受的值: false, true

--anonymous-pull-enabled

从未经身份验证的客户端启用注册表范围的拉取。

接受的值: false, true

--data-endpoint-enabled

为客户端防火墙配置启用专用数据终结点。

接受的值: false, true

--default-action

如果未匹配规则，则应用的默认操作。 仅适用于高级 SKU。

接受的值: Allow, Deny

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--public-network-enabled

允许对容器注册表进行公用网络访问。

接受的值: false, true

--remove

从列表中删除属性或元素。 示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--resource-group -g

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

--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=<value>。

默认值: []

--sku

容器注册表的 SKU。

接受的值: Basic, Premium, Standard

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数

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