az containerapp env

Note

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

管理容器應用程式環境的命令。

命令

名稱	Description	類型	狀態
az containerapp env certificate	用來管理容器應用程式環境的憑證的命令。	核心和擴充功能	GA
az containerapp env certificate create	建立受控憑證。	Core	Preview
az containerapp env certificate delete	從 Container Apps 環境刪除憑證。	Core	GA
az containerapp env certificate delete (containerapp 擴充功能)	從 Container Apps 環境刪除憑證。	Extension	GA
az containerapp env certificate list	列出環境的憑證。	Core	GA
az containerapp env certificate list (containerapp 擴充功能)	列出環境的憑證。	Extension	GA
az containerapp env certificate upload	新增或更新憑證。	Core	GA
az containerapp env certificate upload (containerapp 擴充功能)	新增或更新憑證。	Extension	GA
az containerapp env create	建立容器應用程式環境。	Core	GA
az containerapp env create (containerapp 擴充功能)	建立容器應用程式環境。	Extension	GA
az containerapp env dapr-component	管理 Container Apps 環境的 Dapr 元件命令。	核心和擴充功能	GA
az containerapp env dapr-component init	初始化環境的 Dapr 元件和開發服務。	Extension	Preview
az containerapp env dapr-component list	列出環境的 Dapr 元件。	Core	GA
az containerapp env dapr-component remove	從環境中移除 Dapr 元件。	Core	GA
az containerapp env dapr-component resiliency	管理 dapr 元件的復原原則的命令。	Extension	Preview
az containerapp env dapr-component resiliency create	建立 dapr 元件的復原原則。	Extension	Preview
az containerapp env dapr-component resiliency delete	刪除 dapr 元件的復原原則。	Extension	Preview
az containerapp env dapr-component resiliency list	列出 dapr 元件的復原原則。	Extension	Preview
az containerapp env dapr-component resiliency show	顯示 dapr 元件的復原原則。	Extension	Preview
az containerapp env dapr-component resiliency update	更新 dapr 元件的復原原則。	Extension	Preview
az containerapp env dapr-component set	建立或更新 Dapr 元件。	Core	GA
az containerapp env dapr-component show	顯示 Dapr 元件的詳細數據。	Core	GA
az containerapp env delete	刪除容器應用程式環境。	Core	GA
az containerapp env delete (containerapp 擴充功能)	刪除容器應用程式環境。	Extension	GA
az containerapp env dotnet-component	管理環境中 DotNet 元件的命令。	Extension	Preview
az containerapp env dotnet-component create	建立 DotNet 元件的命令，以啟用 Aspire 儀錶板。 支援的 DotNet 元件類型為 Aspire 儀錶板。	Extension	Preview
az containerapp env dotnet-component delete	刪除 DotNet 元件以停用 Aspire 儀錶板的命令。	Extension	Preview
az containerapp env dotnet-component list	列出環境中的 DotNet 元件命令。	Extension	Preview
az containerapp env dotnet-component show	在環境中顯示 DotNet 元件的命令。	Extension	Preview
az containerapp env http-route-config	管理環境層級 HTTP 路由的命令。	Core	GA
az containerapp env http-route-config create	建立新的 HTTP 路由設定。	Core	GA
az containerapp env http-route-config delete	刪除 HTTP 路由設定。	Core	GA
az containerapp env http-route-config list	列出環境中的 HTTP 路由設定。	Core	GA
az containerapp env http-route-config show	顯示 HTTP 路由設定。	Core	GA
az containerapp env http-route-config update	更新 HTTP 路由設定。	Core	GA
az containerapp env identity	管理環境受控識別的命令。	Extension	Preview
az containerapp env identity assign	將受控識別指派給受控環境。	Extension	Preview
az containerapp env identity remove	從受控環境移除受控識別。	Extension	Preview
az containerapp env identity show	顯示受控環境的受控識別。	Extension	Preview
az containerapp env java-component	管理環境中 Java 元件的命令。	Extension	GA
az containerapp env java-component admin-for-spring	用來管理 Container Apps 環境的 Spring 管理員的命令。	Extension	GA
az containerapp env java-component admin-for-spring create	建立 Spring 管理員的命令。	Extension	GA
az containerapp env java-component admin-for-spring delete	刪除 Spring 管理員的命令。	Extension	GA
az containerapp env java-component admin-for-spring show	顯示 Spring 管理員的命令。	Extension	GA
az containerapp env java-component admin-for-spring update	更新 Spring 管理員的命令。	Extension	GA
az containerapp env java-component config-server-for-spring	用於管理 Container Apps 環境的 Spring 設定伺服器命令。	Extension	GA
az containerapp env java-component config-server-for-spring create	建立 Spring 組態伺服器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring delete	刪除 Spring 組態伺服器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring show	顯示 Spring 組態伺服器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring update	更新 Spring 組態伺服器的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring	針對 Container Apps 環境管理 Spring 的 Eureka 伺服器命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring create	建立 Spring 的 Eureka 伺服器命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring delete	刪除 Spring 的 Eureka 伺服器命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring show	顯示 Spring 的 Eureka 伺服器命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring update	更新 Spring 的 Eureka 伺服器命令。	Extension	GA
az containerapp env java-component gateway-for-spring	用於管理 Container Apps 環境的 Spring 閘道的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring create	建立 Spring 閘道的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring delete	刪除 Spring 閘道的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring show	顯示 Spring 閘道的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring update	更新 Spring 閘道的命令。	Extension	Preview
az containerapp env java-component list	列出環境中的所有 Java 元件。	Extension	GA
az containerapp env java-component nacos	管理 Container Apps 環境的 Nacos 命令。	Extension	Preview
az containerapp env java-component nacos create	建立 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos delete	刪除 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos show	顯示 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos update	更新 Nacos 的命令。	Extension	Preview
az containerapp env list	依訂用帳戶或資源群組列出容器應用程式環境。	Core	GA
az containerapp env list (containerapp 擴充功能)	依訂用帳戶或資源群組列出容器應用程式環境。	Extension	GA
az containerapp env list-usages	列出特定受控環境的配額使用量。	Core	GA
az containerapp env logs	顯示容器應用程式環境記錄。	Core	GA
az containerapp env logs show	實時顯示過去的環境記錄和/或列印記錄（使用 --follow 參數）。	Core	GA
az containerapp env maintenance-config	管理容器應用程式的計劃性維護命令。	Extension	Preview
az containerapp env maintenance-config add	將計劃性維護新增至容器應用程式環境。	Extension	Preview
az containerapp env maintenance-config list	列出容器應用程式環境中的計劃性維護。	Extension	Preview
az containerapp env maintenance-config remove	拿掉容器應用程式環境中的計劃性維護。	Extension	Preview
az containerapp env maintenance-config update	更新容器應用程式環境中的計劃性維護。	Extension	Preview
az containerapp env premium-ingress	設定環境的進階輸入設定。	Core	GA
az containerapp env premium-ingress add	啟用環境的進階輸入設定。	Core	GA
az containerapp env premium-ingress remove	拿掉輸入設定，並將系統還原為預設值。	Core	GA
az containerapp env premium-ingress show	顯示環境的進階輸入設定。	Core	GA
az containerapp env premium-ingress update	更新環境的進階輸入設定。	Core	GA
az containerapp env show	顯示容器應用程式環境的詳細數據。	Core	GA
az containerapp env show (containerapp 擴充功能)	顯示容器應用程式環境的詳細數據。	Extension	GA
az containerapp env storage	用來管理容器應用程式環境的記憶體的命令。	核心和擴充功能	GA
az containerapp env storage list	列出環境的記憶體。	Core	GA
az containerapp env storage list (containerapp 擴充功能)	列出環境的記憶體。	Extension	GA
az containerapp env storage remove	從環境移除記憶體。	Core	GA
az containerapp env storage remove (containerapp 擴充功能)	從環境移除記憶體。	Extension	GA
az containerapp env storage set	建立或更新記憶體。	Core	GA
az containerapp env storage set (containerapp 擴充功能)	建立或更新記憶體。	Extension	GA
az containerapp env storage show	顯示記憶體的詳細數據。	Core	GA
az containerapp env storage show (containerapp 擴充功能)	顯示記憶體的詳細數據。	Extension	GA
az containerapp env telemetry	用來管理容器應用程式環境的遙測設定的命令。	Extension	Preview
az containerapp env telemetry app-insights	用來管理容器應用程式環境的App深入解析設定的命令。	Extension	Preview
az containerapp env telemetry app-insights delete	刪除容器應用程式環境遙測應用程式深入解析設定。	Extension	Preview
az containerapp env telemetry app-insights set	建立或更新容器應用程式環境遙測應用程式深入解析設定。	Extension	Preview
az containerapp env telemetry app-insights show	顯示容器應用程式環境遙測應用程式深入解析設定。	Extension	Preview
az containerapp env telemetry data-dog	管理容器應用程式環境數據狗設定的命令。	Extension	Preview
az containerapp env telemetry data-dog delete	刪除容器應用程式環境遙測數據狗設定。	Extension	Preview
az containerapp env telemetry data-dog set	建立或更新容器應用程式環境遙測數據狗設定。	Extension	Preview
az containerapp env telemetry data-dog show	顯示容器應用程式環境遙測數據狗設定。	Extension	Preview
az containerapp env telemetry otlp	用來管理容器應用程式環境的otlp設定的命令。	Extension	Preview
az containerapp env telemetry otlp add	新增容器應用程式環境遙測 otlp 設定。	Extension	Preview
az containerapp env telemetry otlp list	列出容器應用程式環境遙測otlp設定。	Extension	Preview
az containerapp env telemetry otlp remove	拿掉容器應用程式環境遙測 otlp 設定。	Extension	Preview
az containerapp env telemetry otlp show	顯示容器應用程式環境遙測 otlp 設定。	Extension	Preview
az containerapp env telemetry otlp update	更新容器應用程式環境遙測 otlp 設定。	Extension	Preview
az containerapp env update	更新容器應用程式環境。	Core	GA
az containerapp env update (containerapp 擴充功能)	更新容器應用程式環境。	Extension	GA
az containerapp env workload-profile	管理 Container Apps 環境的工作負載配置檔。	Core	GA
az containerapp env workload-profile add	在 Container Apps 環境中建立工作負載配置檔。	Core	GA
az containerapp env workload-profile delete	從 Container Apps 環境刪除工作負載配置檔。	Core	GA
az containerapp env workload-profile list	從 Container Apps 環境列出工作負載配置檔。	Core	GA
az containerapp env workload-profile list-supported	列出區域中支援的工作負載配置檔。	Core	GA
az containerapp env workload-profile show	顯示來自 Container Apps 環境的工作負載配置檔。	Core	GA
az containerapp env workload-profile update	更新 Container Apps 環境中的現有工作負載配置檔。	Core	GA

az containerapp env create

建立容器應用程式環境。

az containerapp env create --name
                           --resource-group
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--enable-workload-profiles {false, true}]
                           [--infrastructure-subnet-resource-id]
                           [--internal-only {false, true}]
                           [--location]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--no-wait]
                           [--platform-reserved-cidr]
                           [--platform-reserved-dns-ip]
                           [--storage-account]
                           [--tags]
                           [--zone-redundant]

範例

使用自動產生的Log Analytics工作區建立環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2

建立區域備援環境

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --zone-redundant

使用現有的Log Analytics工作區建立環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --logs-workspace-id myLogsWorkspaceID \
    --logs-workspace-key myLogsWorkspaceKey \
    --location eastus2

建立已啟用工作負載配置文件的環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles

建立未啟用工作負載配置文件的環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles false

必要參數

--name -n

容器應用程式環境的名稱。

--resource-group -g

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

選擇性參數

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

--certificate-file --custom-domain-certificate-file

環境自定義網域之憑證檔案的 filepath （.pfx 或 .pem）。 若要管理容器應用程式的憑證，請使用 az containerapp env certificate。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

環境自定義網域的憑證檔案密碼。

屬性	值
參數群組:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

環境自定義網域的 DNS 後綴。

屬性	值
參數群組:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用來將服務導出至服務通訊遙測的 Application Insights 連接字串。

屬性	值
參數群組:	Dapr Arguments

--enable-mtls

布爾值，指出是否為環境啟用 mTLS 對等驗證。

屬性	值
參數群組:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

布爾值，指出是否為環境啟用點對點流量加密。

屬性	值
參數群組:	Peer Traffic Configuration Arguments
接受的值:	false, true

--enable-workload-profiles -w

布爾值，指出環境是否已啟用工作負載配置檔。

屬性	值
預設值:	True
接受的值:	false, true

--infrastructure-subnet-resource-id -s

基礎結構元件和使用者應用程式容器之子網的資源標識碼。

屬性	值
參數群組:	Virtual Network Arguments

--internal-only

布爾值，表示環境只有內部負載平衡器。 這些環境沒有公用靜態 IP 資源，因此如果啟用此屬性，則必須提供 infrastructureSubnetResourceId。

屬性	值
參數群組:	Virtual Network Arguments
預設值:	False
接受的值:	false, true

--location -l

資源的位置。 範例：eastus2、northeurope。

--logs-destination

記錄目的地。

屬性	值
參數群組:	Monitoring Arguments
預設值:	log-analytics
接受的值:	azure-monitor, log-analytics, none

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

屬性	值
參數群組:	Monitoring Arguments

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

屬性	值
參數群組:	Monitoring Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--platform-reserved-cidr

CIDR 表示法中的IP範圍，可以保留給環境基礎結構IP位址。 它不得與任何其他子網IP範圍重疊。

屬性	值
參數群組:	Virtual Network Arguments

--platform-reserved-dns-ip

平臺保留 CIDR 所定義的 IP 位址，將保留給內部 DNS 伺服器。

屬性	值
參數群組:	Virtual Network Arguments

--storage-account

用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值，則會自動建立 Azure 監視器診斷設定。

屬性	值
參數群組:	Monitoring Arguments

--tags

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

--zone-redundant -z

在環境中啟用區域備援。 如果沒有 --infrastructure-subnet-resource-id，就無法使用。如果搭配 --location 使用，子網的位置必須相符。

屬性	值
預設值:	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 containerapp env create (containerapp 擴充功能)

建立容器應用程式環境。

az containerapp env create --name
                           --resource-group
                           [--certificate-akv-url --custom-domain-certificate-akv-url]
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-identity --custom-domain-certificate-identity]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-dedicated-gpu {false, true}]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--enable-workload-profiles {false, true}]
                           [--infrastructure-resource-group]
                           [--infrastructure-subnet-resource-id]
                           [--internal-only {false, true}]
                           [--location]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-dynamic-json-columns {false, true}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--no-wait]
                           [--platform-reserved-cidr]
                           [--platform-reserved-dns-ip]
                           [--public-network-access {Disabled, Enabled}]
                           [--storage-account]
                           [--tags]
                           [--zone-redundant]

範例

使用自動產生的Log Analytics工作區建立環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2

建立區域備援環境

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --zone-redundant

使用現有的Log Analytics工作區建立環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --logs-workspace-id myLogsWorkspaceID \
    --logs-workspace-key myLogsWorkspaceKey \
    --location eastus2

建立已啟用工作負載配置文件的環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles

建立未啟用工作負載配置文件的環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles false

建立具有系統指派和使用者指派身分識別的環境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId

必要參數

--name -n

容器應用程式環境的名稱。

--resource-group -g

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

選擇性參數

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

--certificate-akv-url --custom-domain-certificate-akv-url

預覽

指向保存憑證之 Azure Key Vault 秘密的 URL。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-file --custom-domain-certificate-file

環境自定義網域之憑證檔案的 filepath （.pfx 或 .pem）。 若要管理容器應用程式的憑證，請使用 az containerapp env certificate。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-identity --custom-domain-certificate-identity

預覽

要向 Azure Key Vault 進行驗證的受控識別資源識別碼，或使用系統指派的身分識別。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

環境自定義網域的憑證檔案密碼。

屬性	值
參數群組:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

環境自定義網域的 DNS 後綴。

屬性	值
參數群組:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用來將服務導出至服務通訊遙測的 Application Insights 連接字串。

屬性	值
參數群組:	Dapr Arguments

--enable-dedicated-gpu

預覽

布爾值，指出環境是否已啟用專用 gpu。

屬性	值
預設值:	False
接受的值:	false, true

--enable-mtls

布爾值，指出是否為環境啟用 mTLS 對等驗證。

屬性	值
參數群組:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

布爾值，指出是否為環境啟用點對點流量加密。

屬性	值
參數群組:	Peer Traffic Configuration Arguments
接受的值:	false, true

--enable-workload-profiles -w

布爾值，指出環境是否已啟用工作負載配置檔。

屬性	值
預設值:	True
接受的值:	false, true

--infrastructure-resource-group -i

預覽

將包含基礎結構資源的資源組名。 如果未提供，將會產生資源組名。

屬性	值
參數群組:	Virtual Network Arguments

--infrastructure-subnet-resource-id -s

基礎結構元件和使用者應用程式容器之子網的資源標識碼。

屬性	值
參數群組:	Virtual Network Arguments

--internal-only

布爾值，表示環境只有內部負載平衡器。 這些環境沒有公用靜態 IP 資源，因此如果啟用此屬性，則必須提供 infrastructureSubnetResourceId。

屬性	值
參數群組:	Virtual Network Arguments
預設值:	False
接受的值:	false, true

--location -l

資源的位置。 範例：eastus2、northeurope。

--logs-destination

記錄目的地。

屬性	值
參數群組:	Monitoring Arguments
預設值:	log-analytics
接受的值:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

預覽

布爾值，指出是否要將 json 字串記錄剖析為動態 json 數據行。 僅適用於目的地記錄分析。

屬性	值
參數群組:	Monitoring Arguments
預設值:	False
接受的值:	false, true

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

屬性	值
參數群組:	Monitoring Arguments

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

屬性	值
參數群組:	Monitoring Arguments

--mi-system-assigned

預覽

布爾值，指出是否指派系統指派的身分識別。

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

--mi-user-assigned

預覽

要指派的空間分隔使用者身分識別。

屬性	值
參數群組:	Identity Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--platform-reserved-cidr

CIDR 表示法中的IP範圍，可以保留給環境基礎結構IP位址。 它不得與任何其他子網IP範圍重疊。

屬性	值
參數群組:	Virtual Network Arguments

--platform-reserved-dns-ip

平臺保留 CIDR 所定義的 IP 位址，將保留給內部 DNS 伺服器。

屬性	值
參數群組:	Virtual Network Arguments

--public-network-access

預覽

允許或封鎖所有公用流量。

屬性	值
接受的值:	Disabled, Enabled

--storage-account

用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值，則會自動建立 Azure 監視器診斷設定。

屬性	值
參數群組:	Monitoring Arguments

--tags

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

--zone-redundant -z

在環境中啟用區域備援。 如果沒有 --infrastructure-subnet-resource-id，就無法使用。如果搭配 --location 使用，子網的位置必須相符。

屬性	值
預設值:	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 containerapp env delete

刪除容器應用程式環境。

az containerapp env delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

範例

刪除環境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

選擇性參數

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

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

Container Apps 環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id 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/。

--verbose

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

屬性	值
預設值:	False

az containerapp env delete (containerapp 擴充功能)

刪除容器應用程式環境。

az containerapp env delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

範例

刪除環境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

選擇性參數

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

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

Container Apps 環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id 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/。

--verbose

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

屬性	值
預設值:	False

az containerapp env list

依訂用帳戶或資源群組列出容器應用程式環境。

az containerapp env list [--resource-group]

範例

列出目前訂用帳戶中的環境。

az containerapp env list

依資源群組列出環境。

az containerapp env list -g MyResourceGroup

選擇性參數

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

--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 containerapp env list (containerapp 擴充功能)

依訂用帳戶或資源群組列出容器應用程式環境。

az containerapp env list [--resource-group]

範例

列出目前訂用帳戶中的環境。

az containerapp env list

依資源群組列出環境。

az containerapp env list -g MyResourceGroup

選擇性參數

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

--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 containerapp env list-usages

列出特定受控環境的配額使用量。

az containerapp env list-usages [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

範例

列出特定受控環境的配額使用量。

az containerapp env list-usages -n MyEnv -g MyResourceGroup

選擇性參數

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

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

容器應用程式環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az containerapp env show

顯示容器應用程式環境的詳細數據。

az containerapp env show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

範例

顯示環境的詳細數據。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

選擇性參數

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

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

Container Apps 環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az containerapp env show (containerapp 擴充功能)

顯示容器應用程式環境的詳細數據。

az containerapp env show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

範例

顯示環境的詳細數據。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

選擇性參數

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

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

Container Apps 環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az containerapp env update

更新容器應用程式環境。

az containerapp env update [--certificate-file --custom-domain-certificate-file]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--ids]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--max-nodes]
                           [--min-nodes]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--workload-profile-type]

範例

更新環境的自定義網域組態。

az containerapp env update -n MyContainerappEnvironment -g MyResourceGroup \
    --dns-suffix my-suffix.net --certificate-file MyFilePath \
    --certificate-password MyCertPass

選擇性參數

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

--certificate-file --custom-domain-certificate-file

環境自定義網域之憑證檔案的 filepath （.pfx 或 .pem）。 若要管理容器應用程式的憑證，請使用 az containerapp env certificate。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

環境自定義網域的憑證檔案密碼。

屬性	值
參數群組:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

環境自定義網域的 DNS 後綴。

屬性	值
參數群組:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用來將服務導出至服務通訊遙測的 Application Insights 連接字串。 使用 「none」 將其移除。

屬性	值
參數群組:	Dapr Arguments

--enable-mtls

布爾值，指出是否為環境啟用 mTLS 對等驗證。

屬性	值
參數群組:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

布爾值，指出是否為環境啟用點對點流量加密。

屬性	值
參數群組:	Peer Traffic Configuration Arguments
接受的值:	false, true

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--logs-destination

記錄目的地。

屬性	值
參數群組:	Monitoring Arguments
接受的值:	azure-monitor, log-analytics, none

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

屬性	值
參數群組:	Monitoring Arguments

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

屬性	值
參數群組:	Monitoring Arguments

--max-nodes

此工作負載配置檔所需的節點上限 --workload-profile-name。

--min-nodes

此工作負載配置檔所需的最小節點 --workload-profile-name。

--name -n

容器應用程式環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--storage-account

用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值，則會自動建立 Azure 監視器診斷設定。

屬性	值
參數群組:	Monitoring Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

--workload-profile-name -w

工作負載配置檔的易記名稱。

--workload-profile-type

要在此環境中新增或更新的工作負載配置檔類型，需要 --workload-profile-name。

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False

az containerapp env update (containerapp 擴充功能)

更新容器應用程式環境。

az containerapp env update [--certificate-akv-url --custom-domain-certificate-akv-url]
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-identity --custom-domain-certificate-identity]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--ids]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-dynamic-json-columns {false, true}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--max-nodes]
                           [--min-nodes]
                           [--name]
                           [--no-wait]
                           [--public-network-access {Disabled, Enabled}]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--workload-profile-type]

範例

更新環境的自定義網域組態。

az containerapp env update -n MyContainerappEnvironment -g MyResourceGroup \
    --dns-suffix my-suffix.net --certificate-file MyFilePath \
    --certificate-password MyCertPass

選擇性參數

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

--certificate-akv-url --custom-domain-certificate-akv-url

預覽

指向保存憑證之 Azure Key Vault 秘密的 URL。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-file --custom-domain-certificate-file

環境自定義網域之憑證檔案的 filepath （.pfx 或 .pem）。 若要管理容器應用程式的憑證，請使用 az containerapp env certificate。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-identity --custom-domain-certificate-identity

預覽

要向 Azure Key Vault 進行驗證的受控識別資源識別碼，或使用系統指派的身分識別。

屬性	值
參數群組:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

環境自定義網域的憑證檔案密碼。

屬性	值
參數群組:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

環境自定義網域的 DNS 後綴。

屬性	值
參數群組:	Custom Domain Arguments

--enable-mtls

布爾值，指出是否為環境啟用 mTLS 對等驗證。

屬性	值
參數群組:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

布爾值，指出是否為環境啟用點對點流量加密。

屬性	值
參數群組:	Peer Traffic Configuration Arguments
接受的值:	false, true

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--logs-destination

記錄目的地。

屬性	值
參數群組:	Monitoring Arguments
接受的值:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

預覽

布爾值，指出是否要將 json 字串記錄剖析為動態 json 數據行。 僅適用於目的地記錄分析。

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

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

屬性	值
參數群組:	Monitoring Arguments

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

屬性	值
參數群組:	Monitoring Arguments

--max-nodes

此工作負載配置檔所需的節點上限 --workload-profile-name。

--min-nodes

此工作負載配置檔所需的最小節點 --workload-profile-name。

--name -n

容器應用程式環境的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--public-network-access

預覽

允許或封鎖所有公用流量。

屬性	值
接受的值:	Disabled, Enabled

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--storage-account

用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值，則會自動建立 Azure 監視器診斷設定。

屬性	值
參數群組:	Monitoring Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

--workload-profile-name -w

工作負載配置檔的易記名稱。

--workload-profile-type

要在此環境中新增或更新的工作負載配置檔類型，需要 --workload-profile-name。

全域參數

--debug

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

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

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

--query

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

--verbose

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

屬性	值
預設值:	False