共用方式為

az containerapp env certificate

Note

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

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

命令

名稱 Description 類型 狀態
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 certificate create

編輯
預覽

此命令處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立受控憑證。

az containerapp env certificate create --hostname
                                       --name
                                       --resource-group
                                       --validation-method {CNAME, HTTP, TXT}
                                       [--certificate-name]

範例

建立受控憑證。

az containerapp env certificate create -g MyResourceGroup --name MyEnvironment --certificate-name MyCertificate --hostname MyHostname --validation-method CNAME

必要參數

--hostname

自訂功能變數名稱。

屬性 值
參數群組: Custom Domain Arguments
--name -n

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

--resource-group -g

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

--validation-method -v

自定義網域擁有權的驗證方法。

屬性 值
接受的值: CNAME, HTTP, TXT

選擇性參數

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

--certificate-name -c

容器應用程式環境中應該是唯一的受控憑證名稱。

全域參數
--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 certificate delete

編輯

從 Container Apps 環境刪除憑證。

az containerapp env certificate delete [--certificate]
                                       [--ids]
                                       [--location]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]
                                       [--thumbprint]
                                       [--yes]

範例

依憑證名稱從 Container Apps 環境刪除憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --certificate MyCertificateName

依憑證標識碼從 Container Apps 環境刪除憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --certificate MyCertificateId

從 Container Apps 環境刪除具有相符指紋的所有憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --thumbprint MyCertificateThumbprint

選擇性參數

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

--certificate -c

憑證的名稱或資源標識碼。

--ids

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

屬性 值
參數群組: Resource Id Arguments
--location -l

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

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

憑證的指紋。

--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 certificate delete (containerapp 擴充功能)

從 Container Apps 環境刪除憑證。

az containerapp env certificate delete [--certificate]
                                       [--ids]
                                       [--location]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]
                                       [--thumbprint]
                                       [--yes]

範例

依憑證名稱從 Container Apps 環境刪除憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --certificate MyCertificateName

依憑證標識碼從 Container Apps 環境刪除憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --certificate MyCertificateId

從 Container Apps 環境刪除具有相符指紋的所有憑證

az containerapp env certificate delete -g MyResourceGroup --name MyEnvironment --thumbprint MyCertificateThumbprint

選擇性參數

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

--certificate -c

憑證的名稱或資源標識碼。

--ids

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

屬性 值
參數群組: Resource Id Arguments
--location -l

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

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

憑證的指紋。

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

編輯

列出環境的憑證。

az containerapp env certificate list --name
                                     --resource-group
                                     [--certificate]
                                     [--location]
                                     [--managed-certificates-only]
                                     [--private-key-certificates-only]
                                     [--thumbprint]

範例

列出環境的憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment

依憑證標識碼顯示憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --certificate MyCertificateId

依憑證名稱列出憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --certificate MyCertificateName

依憑證指紋列出憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --thumbprint MyCertificateThumbprint

列出環境的受控憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --managed-certificates-only

列出環境的私鑰憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --private-key-certificates-only

必要參數

--name -n

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

--resource-group -g

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

選擇性參數

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

--certificate -c

憑證的名稱或資源標識碼。

--location -l

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

--managed-certificates-only -m
預覽

僅列出受控憑證。

屬性 值
預設值: False
--private-key-certificates-only -p
預覽

僅列出私鑰憑證。

屬性 值
預設值: False
--thumbprint -t

憑證的指紋。

全域參數
--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 certificate list (containerapp 擴充功能)

列出環境的憑證。

az containerapp env certificate list --name
                                     --resource-group
                                     [--certificate]
                                     [--location]
                                     [--managed-certificates-only]
                                     [--private-key-certificates-only]
                                     [--thumbprint]

範例

列出環境的憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment

依憑證標識碼顯示憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --certificate MyCertificateId

依憑證名稱列出憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --certificate MyCertificateName

依憑證指紋列出憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --thumbprint MyCertificateThumbprint

列出環境的受控憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --managed-certificates-only

列出環境的私鑰憑證。

az containerapp env certificate list -g MyResourceGroup --name MyEnvironment --private-key-certificates-only

必要參數

--name -n

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

--resource-group -g

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

選擇性參數

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

--certificate -c

憑證的名稱或資源標識碼。

--location -l

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

--managed-certificates-only -m

僅列出受控憑證。

屬性 值
預設值: False
--private-key-certificates-only -p

僅列出私鑰憑證。

屬性 值
預設值: False
--thumbprint -t

憑證的指紋。

全域參數
--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 certificate upload

編輯

新增或更新憑證。

az containerapp env certificate upload --certificate-file
                                       [--certificate-name]
                                       [--ids]
                                       [--location]
                                       [--name]
                                       [--password]
                                       [--resource-group]
                                       [--show-prompt]
                                       [--subscription]

範例

新增或更新憑證。

az containerapp env certificate upload -g MyResourceGroup --name MyEnvironment --certificate-file MyFilepath

使用使用者提供的憑證名稱新增或更新憑證。

az containerapp env certificate upload -g MyResourceGroup --name MyEnvironment --certificate-file MyFilepath --certificate-name MyCertificateName

必要參數

--certificate-file -f

.pfx 或 .pem 檔案的 filepath。

屬性 值
參數群組: Custom Domain Arguments

選擇性參數

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

--certificate-name -c

容器應用程式環境內應該是唯一的憑證名稱。

--ids

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

屬性 值
參數群組: Resource Id Arguments
--location -l

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

--name -n

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

屬性 值
參數群組: Resource Id Arguments
--password -p

憑證檔案密碼。

屬性 值
參數群組: Custom Domain Arguments
--resource-group -g

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

屬性 值
參數群組: Resource Id Arguments
--show-prompt

顯示上傳現有憑證的提示。

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

新增或更新憑證。

az containerapp env certificate upload [--akv-url --certificate-akv-url]
                                       [--certificate-file]
                                       [--certificate-identity --identity]
                                       [--certificate-name]
                                       [--ids]
                                       [--location]
                                       [--name]
                                       [--password]
                                       [--resource-group]
                                       [--show-prompt]
                                       [--subscription]

範例

新增或更新憑證。

az containerapp env certificate upload -g MyResourceGroup --name MyEnvironment --certificate-file MyFilepath

使用使用者提供的憑證名稱新增或更新憑證。

az containerapp env certificate upload -g MyResourceGroup --name MyEnvironment --certificate-file MyFilepath --certificate-name MyCertificateName

使用受控識別從 Azure 金鑰保存庫新增或更新憑證。

az containerapp env certificate upload -g MyResourceGroup --name MyEnvironment --akv-url akvSecretUrl --identity system

選擇性參數

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

--akv-url --certificate-akv-url
預覽

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

屬性 值
參數群組: Custom Domain Arguments
--certificate-file -f

.pfx 或 .pem 檔案的 filepath。

屬性 值
參數群組: Custom Domain Arguments
--certificate-identity --identity
預覽

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

屬性 值
參數群組: Custom Domain Arguments
--certificate-name -c

容器應用程式環境內應該是唯一的憑證名稱。

--ids

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

屬性 值
參數群組: Resource Id Arguments
--location -l

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

--name -n

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

屬性 值
參數群組: Resource Id Arguments
--password -p

憑證檔案密碼。

屬性 值
參數群組: Custom Domain Arguments
--resource-group -g

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

屬性 值
參數群組: Resource Id Arguments
--show-prompt

顯示上傳現有憑證的提示。

屬性 值
預設值: False
--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