az acr

Note

這個指令群組的指令在 Azure CLI 和至少一個擴充功能中都有定義。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

Manage private registries with Azure Container Registries.

命令

名稱	Description	類型	狀態
az acr agentpool	用 Azure 容器登錄管理私人任務代理池。	Core	Preview
az acr agentpool create	Create a agent pool for a Azure Container Registry.	Core	Preview
az acr agentpool delete	刪除代理程式集區。	Core	Preview
az acr agentpool list	列出 Azure Container Registry 的代理池。	Core	Preview
az acr agentpool show	取得 Azure Container Registry 指定代理池的屬性。	Core	Preview
az acr agentpool update	Update a agent pool for a Azure Container Registry.	Core	Preview
az acr artifact-streaming	管理 ACR 中任何存放庫或支援映像的成品串流。	Core	Preview
az acr artifact-streaming create	為 ACR 中的特定映像建立查閱者串流成品。	Core	Preview
az acr artifact-streaming operation	管理 ACR 的串流成品建立作業。	Core	Preview
az acr artifact-streaming operation cancel	取消 ACR 的指定串流成品作業。	Core	Preview
az acr artifact-streaming operation show	檢查 ACR 中成品串流的作業狀態。	Core	Preview
az acr artifact-streaming show	顯示 Azure Container Registry 的倉庫是否啟用了 artifact streaming。	Core	Preview
az acr artifact-streaming update	為指定登錄下新推送的映像啟用或停用串流成品的自動建立。	Core	Preview
az acr build	Queues a quick build ， provide streaming logs for a Azure Container Registry.	Core	GA
az acr cache	管理 Azure Container Registries 中的快取規則。	Core	GA
az acr cache create	建立快取規則。	Core	GA
az acr cache delete	刪除快取規則。	Core	GA
az acr cache list	在 Azure Container Registry 中列出快取規則。	Core	GA
az acr cache show	顯示快取規則。	Core	GA
az acr cache update	更新快取規則上的認證集。	Core	GA
az acr check-health	取得環境的健康情況資訊，並選擇性地取得目標登錄。	Core	GA
az acr check-name	檢查 Azure Container Registry 名稱是否有效且可用。	Core	GA
az acr config	Configure policies for Azure Container Registries.	Core	GA
az acr config authentication-as-arm	Manage 'Azure AD authenticate as ARM' policy for Azure Container Registries.	Core	Preview
az acr config authentication-as-arm show	顯示 configure 的 'Azure AD authenticate as ARM' 政策，針對 Azure Container Registry。	Core	Preview
az acr config authentication-as-arm update	Update 'Azure AD authenticate as ARM' policy for a Azure Container Registry.	Core	Preview
az acr config content-trust	Manage content-trust policy for Azure Container Registries.	Core	Deprecated
az acr config content-trust show	顯示 a Azure Container Registry 的 configedcontent-trust policy。	Core	Deprecated
az acr config content-trust update	Update content-trust policy for a Azure Container Registry.	Core	GA
az acr config retention	Manage retention policy for Azure Container Registries.	Core	Preview
az acr config retention show	顯示 Azure Container Registry 嘅 configured retention policy.	Core	Preview
az acr config retention update	Update retention policy for a Azure Container Registry.	Core	Preview
az acr config soft-delete	Manage soft-delete policy for Azure Container Registries.	Core	Preview
az acr config soft-delete show	顯示 Azure Container Registry 已設定的軟刪除政策。	Core	Preview
az acr config soft-delete update	Update soft delete policy for a Azure Container Registry.	Core	Preview
az acr connected-registry	用 Azure 容器登錄管理系統管理連接的登錄資源。	Core	GA
az acr connected-registry create	建立一個連接的 Azure Container Registry 登錄檔。	Core	GA
az acr connected-registry deactivate	從 Azure Container Registry 停用連接的登錄檔。	Core	GA
az acr connected-registry delete	從 Azure Container Registry 刪除已連接的登錄檔。	Core	GA
az acr connected-registry get-settings	擷取啟動連線登錄所需的資訊，並建立或輪替同步令牌認證。	Core	GA
az acr connected-registry list	列出目前父登錄下的所有已連線登錄。	Core	GA
az acr connected-registry list-client-tokens	列出與特定連線登錄相關聯的所有用戶端令牌。	Core	GA
az acr connected-registry permissions	管理多個已連線登錄的存放庫許可權。 如需詳細資訊，請參閱 https://aka.ms/acr/connected-registry 。	Core	GA
az acr connected-registry permissions show	顯示連線的登錄同步範圍對應資訊。	Core	GA
az acr connected-registry permissions update	在所有必要的連線登錄同步範圍對應中新增和移除存放庫許可權。	Core	GA
az acr connected-registry show	顯示線上的登錄詳細數據。	Core	GA
az acr connected-registry update	Update a connected registry for a Azure Container Registry.	Core	GA
az acr create	Create a Azure Container Registry.	Core	GA
az acr credential	Manage login credentials for Azure Container Registries.	Core	GA
az acr credential-set	Manage credential sets in Azure Container Registries.	Core	GA
az acr credential-set create	建立認證集。	Core	GA
az acr credential-set delete	刪除認證集。	Core	GA
az acr credential-set list	在 Azure Container Registry 中列出憑證集。	Core	GA
az acr credential-set show	顯示認證集。	Core	GA
az acr credential-set update	更新憑證設定上的 Azure Key Vault secret ID 的用戶名或密碼。	Core	GA
az acr credential renew	Regenerate login credentials for an Azure Container Registry.	Core	GA
az acr credential show	取得 Azure Container Registry 的登入憑證。	Core	GA
az acr delete	Deletes an Azure Container Registry.	Core	GA
az acr encryption	管理容器登錄加密。	Core	GA
az acr encryption rotate-key	輪替容器登錄的加密金鑰（更新）。	Core	GA
az acr encryption show	顯示容器登錄的加密詳細數據。	Core	GA
az acr export-pipeline	管理 ACR 匯出管線。	Extension	Preview
az acr export-pipeline create	建立導出管線。	Extension	Preview
az acr export-pipeline delete	刪除匯出管線。	Extension	Preview
az acr export-pipeline list	列出 Container Registry 上的導出管線。	Extension	Preview
az acr export-pipeline show	詳細顯示匯出管線。	Extension	Preview
az acr helm	Manage helm charts for Azure Container Registries.	Core	Deprecated
az acr helm delete	Delete a helm chart version in an Azure Container Registry.	Core	Deprecated
az acr helm install-cli	下載並安裝 Helm 命令行工具。	Core	預覽和已淘汰
az acr helm list	在 Azure Container Registry 中列出所有 helm charts。	Core	Deprecated
az acr helm push	Push a helm chart package to an Azure Container Registry.	Core	Deprecated
az acr helm repo	Manage helm chart repositories for Azure Container Registries.	Core	Deprecated
az acr helm repo add	透過 Helm CLI 從 Azure Container Registry 新增一個 helm chart repository。	Core	Deprecated
az acr helm show	描述 Azure Container Registry 中的 helm chart。	Core	Deprecated
az acr identity	管理容器登錄的服務（受控）身分識別。	Core	GA
az acr identity assign	將受控識別指派給容器登錄。	Core	GA
az acr identity remove	從容器登錄中移除受控識別。	Core	GA
az acr identity show	顯示容器登錄的身分識別詳細數據。	Core	GA
az acr import	從另一個容器登錄檔匯入映像到 Azure Container Registry。 匯入會移除 docker pull、docker tag、docker push 的需求。 對於較大的影像，請考慮使用 --no-wait。	Core	GA
az acr import-pipeline	管理 ACR 匯入管線。	Extension	Preview
az acr import-pipeline create	建立匯入管線。	Extension	Preview
az acr import-pipeline delete	刪除匯入管線。	Extension	Preview
az acr import-pipeline list	列出 Container Registry 上的匯入管線。	Extension	Preview
az acr import-pipeline show	詳細顯示匯入管線。	Extension	Preview
az acr list	列出目前訂用帳戶下的所有容器登錄。	Core	GA
az acr login	透過 Docker CLI 登入 Azure Container Registry。	Core	GA
az acr manifest	Manage artifact manifests in Azure Container Registries.	Core	Preview
az acr manifest delete	Delete a manifest in an Azure Container Registry.	Core	Preview
az acr manifest list	將清單列入 Azure Container Registry 的倉庫。	Core	Preview
az acr manifest list-deleted	在 Azure Container Registry 的倉庫中列出軟刪除的清單。	Core	Preview
az acr manifest list-deleted-tags	在 Azure Container Registry 的倉庫中列出軟刪除的標籤。	Core	Preview
az acr manifest list-metadata	在 Azure Container Registry 的倉庫中列出清單的元資料。	Core	Preview
az acr manifest list-referrers	List the referrers to a manifest in an Azure Container Registry.	Core	Preview
az acr manifest restore	在 Azure Container Registry 中還原一個軟刪除的 artifact and tag。	Core	Preview
az acr manifest show	Get a manifest in an Azure Container Registry.	Core	Preview
az acr manifest show-metadata	取得 Azure Container Registry 中 artifact 的元資料。	Core	Preview
az acr manifest update-metadata	Update the manifest metadata in an Azure Container Registry in an artifact.	Core	Preview
az acr network-rule	管理 Azure 容器註冊表的網路規則。	Core	GA
az acr network-rule add	新增網路規則。	Core	GA
az acr network-rule list	列出網路規則。	Core	GA
az acr network-rule remove	移除網路規則。	Core	GA
az acr pack	管理使用 Cloud Native Buildpacks 的 Azure Container Registry 任務。	Core	Preview
az acr pack build	會排隊一個快速建置任務，建立一個應用程式並推送到 Azure Container Registry。	Core	Preview
az acr pipeline-run	管理 ACR 匯入和匯出管線執行。	Extension	Preview
az acr pipeline-run clean	刪除登錄上所有失敗的管線執行。	Extension	Preview
az acr pipeline-run create	建立管線執行。	Extension	Preview
az acr pipeline-run delete	刪除管線執行。	Extension	Preview
az acr pipeline-run list	列出容器登錄上所有管線的管線執行。	Extension	Preview
az acr pipeline-run show	詳細顯示管線執行。	Extension	Preview
az acr private-endpoint-connection	管理容器登錄私人端點連線。	Core	GA
az acr private-endpoint-connection approve	核准容器登錄的私人端點連線要求。	Core	GA
az acr private-endpoint-connection delete	刪除容器登錄的私人端點連線要求。	Core	GA
az acr private-endpoint-connection list	列出容器登錄的所有私人端點連線。	Core	GA
az acr private-endpoint-connection reject	拒絕容器登錄的私人端點連線要求。	Core	GA
az acr private-endpoint-connection show	顯示容器登錄私人端點連線的詳細數據。	Core	GA
az acr private-link-resource	管理登錄私人鏈接資源。	Core	GA
az acr private-link-resource list	列出登錄支援的私人鏈接資源。	Core	GA
az acr query	使用 Kusto 查詢語言查詢 ACR 中的內容。	Extension	GA
az acr replication	管理 Azure 容器登錄庫的地理複製區域。	Core	GA
az acr replication create	為 Azure Container Registry 建立一個複製區域。	Core	GA
az acr replication delete	從 Azure Container Registry 刪除複製的區域。	Core	GA
az acr replication list	列出所有地理複製版 Azure Container Registry 的區域。	Core	GA
az acr replication show	取得複寫區域的詳細數據。	Core	GA
az acr replication update	更新複寫。	Core	GA
az acr repository	Manage repositories （image names） for Azure Container Registries.	Core	GA
az acr repository delete	刪除 Azure Container Registry 中的儲存庫或映像。	Core	GA
az acr repository list	List repositories in an Azure Container Registry.	Core	GA
az acr repository list-deleted	List soft deleted repositories in an Azure Container Registry.	Core	Preview
az acr repository show	取得 Azure Container Registry 中儲存庫或映像的屬性。	Core	GA
az acr repository show-tags	Show tags for a repository in an Azure Container Registry.	Core	GA
az acr repository untag	Untag an image in an Azure Container Registry.	Core	GA
az acr repository update	更新 Azure Container Registry 中儲存庫或映像的屬性。	Core	GA
az acr run	Queues a quick run provide streamed logs for a Azure Container Registry.	Core	GA
az acr scope-map	Manage scope access maps for Azure Container Registries.	Core	GA
az acr scope-map create	Create a scope map for an Azure Container Registry.	Core	GA
az acr scope-map delete	Delete a scope map for an Azure Container Registry.	Core	GA
az acr scope-map list	List all scope maps for a Azure Container Registry.	Core	GA
az acr scope-map show	顯示 Azure Container Registry 範圍地圖的詳細資料與屬性。	Core	GA
az acr scope-map update	Update a scope map for an Azure Container Registry.	Core	GA
az acr show	取得 Azure Container Registry 的詳細資訊。	Core	GA
az acr show-endpoints	顯示登錄端點，包括資料端點及區域端點（若已設定）。	Core	GA
az acr show-usage	取得 Azure Container Registry 的儲存使用情況。	Core	GA
az acr supply-chain	管理 acr 供應鏈資源的命令。	Extension	Preview
az acr supply-chain workflow	管理 acr 供應鏈工作流程的命令。	Extension	Preview
az acr supply-chain workflow cancel-run	取消目前正在執行的供應鏈工作流程。	Extension	Preview
az acr supply-chain workflow create	建立 acr 供應鏈工作流程。	Extension	Preview
az acr supply-chain workflow delete	刪除 acr 供應鏈工作流程。	Extension	Preview
az acr supply-chain workflow list	acr 供應鏈工作流程映像的清單狀態。	Extension	Preview
az acr supply-chain workflow show	顯示 acr 供應鏈工作流程工作。	Extension	Preview
az acr supply-chain workflow update	更新 acr 供應鏈工作流程。	Extension	Preview
az acr task	管理一系列建置、測試及作業系統與作業系統的步驟Framework patching container image using Azure Container Registries.	Core	GA
az acr task cancel-run	取消指定執行的 Azure Container Registry.	Core	GA
az acr task create	建立建置、測試和OS和架構修補容器的一系列步驟。 工作支援 Git 認可和基底映射更新的觸發程式。	Core	GA
az acr task credential	管理工作的認證。 如需詳細資訊，請參閱 https://aka.ms/acr/connected-registry 。	Core	GA
az acr task credential add	將自訂登錄登入認證新增至工作。	Core	GA
az acr task credential list	列出工作的所有自定義登錄認證。	Core	GA
az acr task credential remove	拿掉工作的認證。	Core	GA
az acr task credential update	更新工作的登錄登入認證。	Core	GA
az acr task delete	從 Azure Container Registry 刪除任務。	Core	GA
az acr task identity	工作的受控識別。 如需詳細資訊，請參閱 https://aka.ms/acr/connected-registry 。	Core	GA
az acr task identity assign	更新工作的受控識別。	Core	GA
az acr task identity remove	拿掉工作的受控識別。	Core	GA
az acr task identity show	顯示工作的受控識別。	Core	GA
az acr task list	列出 Azure Container Registry 的任務。	Core	GA
az acr task list-runs	列出所有執行的 Azure Container Registry 執行紀錄，並可依特定任務篩選。	Core	GA
az acr task logs	顯示特定執行的記錄。 如果未提供任何 run-id，則顯示上次建立回合的記錄。	Core	GA
az acr task run	手動觸發可能正在等候 Git 認可或基底映像更新觸發程式的工作。	Core	GA
az acr task show	取得 Azure Container Registry 的命名任務屬性。	Core	GA
az acr task show-run	取得 Azure Container Registry 任務指定執行的屬性。	Core	GA
az acr task timer	管理工作的定時器觸發程式。	Core	GA
az acr task timer add	將定時器觸發程式新增至工作。	Core	GA
az acr task timer list	列出工作的所有定時器觸發程式。	Core	GA
az acr task timer remove	從工作中移除定時器觸發程式。	Core	GA
az acr task timer update	更新工作的定時器觸發程式。	Core	GA
az acr task update	Update a task for an Azure Container Registry.	Core	GA
az acr task update-run	Patch the run properties of an Azure Container Registry Task.	Core	GA
az acr taskrun	使用 Azure 容器登錄管理 taskruns。	Core	Preview
az acr taskrun delete	從 Azure Container Registry 刪除 taskrun.	Core	Preview
az acr taskrun list	List the taskruns for a Azure Container Registry.	Core	Preview
az acr taskrun logs	顯示特定工作回合的執行記錄。	Core	Preview
az acr taskrun show	取得 Azure Container Registry 的 Task Run 屬性。	Core	Preview
az acr token	Manage tokens for an Azure Container Registry.	Core	GA
az acr token create	建立一個與 Azure Container Registry 範圍映射相關聯的 token 。	Core	GA
az acr token credential	Manage credentials of a token for a Azure Container Registry.	Core	GA
az acr token credential delete	刪除令牌認證。	Core	GA
az acr token credential generate	產生或替換一個 Azure Container Registry 令牌的密碼。 如需使用權杖和密碼來存取容器登錄，請參閱 https://aka.ms/acr/repo-permissions。	Core	GA
az acr token delete	Delete a token for an Azure Container Registry.	Core	GA
az acr token list	List all tokens for a Azure Container Registry.	Core	GA
az acr token show	顯示 Azure Container Registry 代幣的詳細資訊與屬性。	Core	GA
az acr token update	Update a token （replace associated scope map） for a Azure Container Registry.	Core	GA
az acr update	Update an Azure Container Registry.	Core	GA
az acr webhook	Manage webhooks for Azure Container Registries.	Core	GA
az acr webhook create	Create a webhook for an Azure Container Registry.	Core	GA
az acr webhook delete	從 Azure Container Registry 刪除 webhook。	Core	GA
az acr webhook get-config	取得 Webhook 的服務 URI 和自定義標頭。	Core	GA
az acr webhook list	列出所有 Azure Container Registry 的 webhooks。	Core	GA
az acr webhook list-events	列出 Webhook 的最新事件。	Core	GA
az acr webhook ping	觸發 Webhook 的 Ping 事件。	Core	GA
az acr webhook show	取得 Webhook 的詳細數據。	Core	GA
az acr webhook update	更新 Webhook。	Core	GA

az acr build

Queues a quick build ， provide streaming logs for a Azure Container Registry.

az acr build --registry
             [--acquire-policy-token]
             [--agent-pool]
             [--auth-mode {Default, None}]
             [--build-arg]
             [--change-reference]
             [--file]
             [--image]
             [--log-template]
             [--no-format]
             [--no-logs]
             [--no-push]
             [--no-wait]
             [--platform]
             [--resource-group]
             [--secret-build-arg]
             [--source-acr-auth-id {[caller], none}]
             [--target]
             [--timeout]
             []

範例

將本機內容排入佇列，作為 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

將本機內容排入佇列作為 Linux 組建、標記，並將其推送至已啟用 ABAC 的存放庫許可權登錄，並使用呼叫端的 Entra 身分識別向來源登錄進行驗證。

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --source-acr-auth-id [caller]

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--agent-pool

預覽

代理程式集區的名稱。

--auth-mode

來源登錄的驗證模式。

屬性	值
接受的值:	Default, None

--build-arg

'--build-arg name[=value]' 格式的組建自變數。 多次傳遞 '--build-arg name[=value]' 支援多個 。 重要：此參數不應包含任何種類的密碼、存取令牌或敏感性資訊。 ACR 小組將會看見此參數值以供偵錯之用。

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 小組，而且更適合敏感性資訊。

--source-acr-auth-id

指派用於來源登錄登入的身分識別。 使用 '[caller]' 進行呼叫端身分識別。

屬性	值
接受的值:	[caller], none

--target

目標建置階段的名稱。

--timeout

以秒為單位的逾時。

<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'）。

屬性	值
參數群組:	Positional

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr check-health

重大變更

在預定於 2026 年 6 月發布的下一個重大變更版本（2.87.0）中移除 Notary 客戶端版本驗證功能。 由於 Docker Content Trust 被棄用，公證客戶端版本檢查將不再作為「check-health」指令的一部分執行。 想了解更多關於重大變更的詳情，請造訪 https://aka.ms/acr/dctdeprecation。

取得環境的健康情況資訊，並選擇性地取得目標登錄。

az acr check-health [--acquire-policy-token]
                    [--change-reference]
                    [--ignore-errors]
                    [--name]
                    [--repository]
                    [--vnet]
                    [--yes]

範例

取得目標登錄 'myregistry' 的健康狀態，略過提取映射的確認。

az acr check-health -n myregistry -y

取得環境的健全狀態，而不會在第一次錯誤時停止。

az acr check-health --ignore-errors

取得目標登錄 『myregistry』 的健康狀態，並檢查特定存放庫 『myrepo』 的允許許可權。

az acr check-health -n myregistry --repository myrepo

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--ignore-errors

提供所有健康情況檢查，即使找到錯誤也一樣。

屬性	值
預設值:	False

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

--repository

存放庫的名稱。

--vnet

虛擬網路識別碼，以便在 VNET 內執行此命令，以驗證 DNS 路由至私人端點。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr check-name

檢查 Azure Container Registry 名稱是否有效且可用。

az acr check-name --name
                  [--acquire-policy-token]
                  [--change-reference]
                  [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
                  [--resource-group]

範例

檢查登錄名稱是否存在。

az acr check-name -n doesthisnameexist

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--dnl-scope

預覽

Domain name label 範圍將向資源名稱添加哈希值。 生成的登錄伺服器名稱將採用 .azurecr-io 格式 registry-name-hash。 預設值為 Unsecure。

屬性	值
預設值:	Unsecure
接受的值:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr create

Create a Azure Container Registry.

az acr create --name
              --resource-group
              --sku {Basic, Premium, Standard}
              [--acquire-policy-token]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--change-reference]
              [--default-action {Allow, Deny}]
              [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
              [--identity]
              [--key-encryption-key]
              [--location]
              [--public-network-enabled {false, true}]
              [--regional-endpoints {Disabled, Enabled}]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--tags]
              [--workspace]
              [--zone-redundancy {Disabled, Enabled}]

範例

使用標準 SKU 建立受控容器登錄。

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

建立已啟用 ABAC 型存放庫許可權的登錄。

az acr create -n myregistry -g MyResourceGroup --sku Standard --role-assignment-mode rbac-abac

建立一個受管理的容器登錄檔，啟用 Premium SKU 和區域端點。

az acr create -n myregistry -g MyResourceGroup --sku Premium --regional-endpoints enabled

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--sku

容器登錄的SKU。

屬性	值
接受的值:	Basic, Premium, Standard

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--admin-enabled

指出是否啟用系統管理員使用者。

屬性	值
預設值:	False
接受的值:	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/export-policy。 [預設值] 是允許的。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	false, true

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--default-action

未符合規則時要套用的預設動作。 僅適用於進階 SKU。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	Allow, Deny

--dnl-scope

預覽

Domain name label 範圍會給資源名稱添加一個哈希值。 生成的登錄伺服器名稱將採用 .azurecr-io 格式 registryname-hash。 預設值為 Unsecure。

屬性	值
接受的值:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--identity

如果在相同的資源群組中，請使用指派的受控識別資源標識碼或名稱。

屬性	值
參數群組:	Customer managed key Arguments

--key-encryption-key

金鑰儲存庫金鑰 URI。 若要啟用自動輪替，請提供無版本密鑰 URI。 針對手動輪替，請提供已建立版本的密鑰 URI。

屬性	值
參數群組:	Customer managed key Arguments

--location -l

Location. 值的來源：az account list-locations。 您可以使用 az configure --defaults location=<location>來設定預設位置。

--public-network-enabled

允許容器登錄的公用網路存取。 [預設值] 是允許的。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	false, true

--regional-endpoints

預覽

指示登錄檔是否應啟用區域端點。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	Disabled, Enabled

--role-assignment-mode

登錄的角色指派模式。 如需這項功能的詳細資訊，請參閱 https://aka.ms/acr/auth/abac。 預設值為 rbac。

屬性	值
參數群組:	Permissions and Role Assignment Arguments
接受的值:	rbac, rbac-abac

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr delete

Deletes an Azure Container Registry.

az acr delete --name
              [--acquire-policy-token]
              [--change-reference]
              [--resource-group]
              [--yes]

範例

Delete an Azure Container Registry.

az acr delete -n myregistry

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

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

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr import

從另一個容器登錄檔匯入映像到 Azure Container Registry。 匯入會移除 docker pull、docker tag、docker push 的需求。 對於較大的影像，請考慮使用 --no-wait。

az acr import --name
              --source
              [--acquire-policy-token]
              [--change-reference]
              [--force]
              [--image]
              [--no-wait]
              [--password]
              [--registry]
              [--repository]
              [--resource-group]
              [--username]

範例

將影像從 'sourceregistry' 匯入 'myregistry'。 映射會繼承其來源存放庫和標記名稱。

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

從 Docker Hub 的公開倉庫匯入映像檔。 映像會使用指定的存放庫和標記名稱。

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

用區域端點的 URI 作為來源匯入一張圖片。

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

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

--source

包含登錄登入伺服器的來源映像名稱或完整來源。 如果使用 --registry ， --source 則一律會解譯為來源映像，即使它包含登入伺服器也一樣。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--force

覆寫要匯入之映像的現有標記。

屬性	值
預設值:	False

--image -t

影像的名稱和標記，其格式為：『-t 存放庫/image：tag』。 傳遞 -t 多次支援多個標記。

--no-wait

請勿等候匯入完成，並在匯入佇列后立即返回。

屬性	值
預設值:	False

--password -p

來源容器登錄的密碼。

--registry -r

來源 Azure 容器登錄檔。 這可以是來源登錄的名稱、登入伺服器或資源標識符。

--repository

僅限指令清單映像複本的存放庫名稱。 傳遞 --repository 多次支援多個複本。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--username -u

來源容器登錄的用戶名稱。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr login

透過 Docker CLI 登入 Azure Container Registry。

Docker 必須安裝在您的電腦上。 完成後，請使用 docker logout <registry url> 來註銷。（如果您只需要重新整理令牌，而且不想安裝 Docker，請指定 '--public-token'）。

az acr login --name
             [--acquire-policy-token]
             [--change-reference]
             [--endpoint]
             [--expose-token]
             [--password]
             [--resource-group]
             [--suffix]
             [--username]

範例

登入 an Azure Container Registry

az acr login -n myregistry

Get a Azure Container Registry access token

az acr login -n myregistry --expose-token

登入 Azure Container Registry 的特定區域端點。 需要在登錄檔啟用區域端點。

az acr login -n myregistry --endpoint eastus

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint

預覽

登入容器登錄檔的特定區域端點。 指定區域名稱（例如 eastus、westus2）。 僅在啟用區域端點時適用。

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr query

使用 Kusto 查詢語言查詢 ACR 中的內容。

使用 Kusto 查詢語言在 Azure Container Registry 中查詢工件與映像。 OCI 指令清單屬性，例如摘要、主旨、註釋等，可用來查詢、篩選及排序搜尋結果。

az acr query --kql-query
             --name
             [--acquire-policy-token]
             [--change-reference]
             [--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

執行查詢的容器登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--password -p

登錄密碼。

--repository

執行查詢的存放庫。 如果未提供存放庫，查詢就會在登錄層級執行。

--skip-token

如果適用的話，請略過令牌以取得查詢的下一頁。

--username -u

登錄用戶名稱。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr run

Queues a quick run provide streamed logs for a Azure Container Registry.

az acr run --registry
           [--acquire-policy-token]
           [--agent-pool]
           [--auth-mode {Default, None}]
           [--change-reference]
           [--cmd]
           [--file]
           [--log-template]
           [--no-format]
           [--no-logs]
           [--no-wait]
           [--platform]
           [--resource-group]
           [--set]
           [--set-secret]
           [--source-acr-auth-id {[caller], none}]
           [--timeout]
           [--values]
           []

範例

將執行排入佇列以執行容器命令。

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

使用標準輸入的工作定義，將執行排入佇列。 Windows 的 'Ctrl + Z' 或 Linux' 的 Ctrl + D' 會終止輸入串流。

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

將執行排入佇列，以在已啟用 ABAC 的存放庫許可權登錄中執行容器命令，並使用呼叫端的 Entra 身分識別向來源登錄進行驗證。

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null --source-acr-auth-id [caller]

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--agent-pool

預覽

代理程式集區的名稱。

--auth-mode

來源登錄的驗證模式。

屬性	值
接受的值:	Default, None

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 多次來支援的倍數。

--source-acr-auth-id

指派用於來源登錄登入的身分識別。 使用 '[caller]' 進行呼叫端身分識別。

屬性	值
接受的值:	[caller], none

--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』，則值會設定為 None 並忽略。

屬性	值
參數群組:	Positional

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr show

取得 Azure Container Registry 的詳細資訊。

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

範例

取得 Azure Container Registry 的登入伺服器。

az acr show -n myregistry --query loginServer

獲取 Azure Container Registry 的詳細資訊

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

檢查登錄上ABAC型存放庫許可權的狀態。

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

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr show-endpoints

顯示登錄端點，包括資料端點及區域端點（若已設定）。

az acr show-endpoints --name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--resource-group]

範例

展示登錄檔的端點。

az acr show-endpoints -n myregistry

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr show-usage

取得 Azure Container Registry 的儲存使用情況。

az acr show-usage --name
                  [--acquire-policy-token]
                  [--change-reference]
                  [--resource-group]

範例

取得 Azure Container Registry 的儲存使用情況。

az acr show-usage -n myregistry

根據其 SKU 的包含儲存體 （以位元組為單位） 來取得登錄所使用的目前儲存體數量。

az acr show-usage -n myregistry --query "value[?name=='Size'] | [0]"

取得登錄所使用的目前儲存體數量，以及允許的最大儲存體容量。

az acr show-usage -n myregistry --query "value[?name=='MaximumStorageCapacity'] | [0]"

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az acr update

Update an Azure Container Registry.

az acr update --name
              [--acquire-policy-token]
              [--add]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--anonymous-pull-enabled {false, true}]
              [--change-reference]
              [--data-endpoint-enabled {false, true}]
              [--default-action {Allow, Deny}]
              [--force-string]
              [--public-network-enabled {false, true}]
              [--regional-endpoints {Disabled, Enabled}]
              [--remove]
              [--resource-group]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--set]
              [--sku {Basic, Premium, Standard}]
              [--tags]

範例

Update tags for an Azure Container Registry.

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

啟用管理員用戶帳戶以啟用 Azure Container Registry。

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

開啟現有登錄的 ABAC 型存放庫許可權。

az acr update -n myregistry --role-assignment-mode rbac-abac

啟用現有登錄檔上的區域端點。

az acr update -n myregistry --regional-endpoints enabled

必要參數

--name -n

容器登錄的名稱。 它應該以小寫指定。 您可以使用 az configure --defaults acr=<registry name>來設定預設登錄名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例： --add property.listProperty <key=value, string or JSON string>.

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--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/export-policy。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	false, true

--anonymous-pull-enabled

從未經驗證的用戶端啟用全登錄提取。

屬性	值
接受的值:	false, true

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--data-endpoint-enabled

啟用用戶端防火牆設定的專用數據端點。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	false, true

--default-action

未符合規則時要套用的預設動作。 僅適用於進階 SKU。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	Allow, Deny

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

屬性	值
參數群組:	Generic Update Arguments
預設值:	False

--public-network-enabled

允許容器登錄的公用網路存取。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	false, true

--regional-endpoints

預覽

指示登錄檔是否應啟用區域端點。

屬性	值
參數群組:	Network Rule Arguments
接受的值:	Disabled, Enabled

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

--role-assignment-mode

登錄的角色指派模式。 如需這項功能的詳細資訊，請參閱 https://aka.ms/acr/auth/abac。 預設值為 rbac。

屬性	值
參數群組:	Permissions and Role Assignment Arguments
接受的值:	rbac, rbac-abac

--set

指定要設定的屬性路徑和值，以更新物件。 範例： --set property1.property2=<value>.

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--sku

容器登錄的SKU。

屬性	值
接受的值:	Basic, Premium, Standard

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False