az appconfig kv

  • 參考

管理儲存在應用程式組態中的索引鍵/值。

命令

名稱 Description 類型 狀態
az appconfig kv delete

刪除索引鍵/值。

 核心 GA
az appconfig kv export

將組態從您的應用程式組態匯出至另一個位置。

 核心 GA
az appconfig kv import

從另一個地方將組態匯入應用程式組態。

 核心 GA
az appconfig kv list

列出索引鍵/值。

 核心 GA
az appconfig kv lock

鎖定索引鍵/值以禁止寫入作業。

 核心 GA
az appconfig kv restore

還原索引鍵/值。

 核心 GA
az appconfig kv set

設定索引鍵/值。

 核心 GA
az appconfig kv set-keyvault

設定 keyvault 參考。

 核心 GA
az appconfig kv show

顯示索引鍵/值的所有屬性。

 核心 GA
az appconfig kv unlock

解除鎖定索引鍵/值以取得寫入作業。

 核心 GA

az appconfig kv delete

編輯

刪除索引鍵/值。

az appconfig kv delete --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--yes]

範例

使用應用程式組態名稱刪除金鑰，而不需確認。

az appconfig kv delete -n MyAppConfiguration --key color --label MyLabel --yes

使用 連接字串 刪除金鑰。

az appconfig kv delete --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

使用您的 'az login' 認證和應用程式組態端點刪除金鑰。

az appconfig kv delete --endpoint https://myappconfiguration.azconfig.io --key color --auth-mode login --yes

必要參數

--key

支援星號作為篩選，例如 * 表示所有索引鍵和 abc* 表示具有 abc 作為前置詞的索引鍵。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，請刪除具有 Null 標籤的專案。 支援星號作為篩選，例如 * 表示所有標籤和 abc* 表示具有 abc 作為前置詞的標籤。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv export

編輯

將組態從您的應用程式組態匯出至另一個位置。

az appconfig kv export --destination {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--dest-auth-mode {key, login}]
                       [--dest-connection-string]
                       [--dest-endpoint]
                       [--dest-label]
                       [--dest-name]
                       [--endpoint]
                       [--export-as-reference {false, true}]
                       [--format {json, properties, yaml}]
                       [--key]
                       [--label]
                       [--name]
                       [--naming-convention {camel, hyphen, pascal, underscore}]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--profile {appconfig/default, appconfig/kvset}]
                       [--resolve-keyvault {false, true}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--skip-keyvault {false, true}]
                       [--snapshot]
                       [--yes]

範例

將所有索引鍵和功能旗標與標籤測試匯出至 json 檔案。

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json

將所有具有 Null 標籤的金鑰匯出至 App Service 應用程式。

az appconfig kv export -n MyAppConfiguration -d appservice --appservice-account MyAppService

將標籤測試排除功能旗標的所有金鑰匯出至 json 檔案。

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --skip-features

將所有標籤的索引鍵和功能旗標匯出至另一個應用程式組態。

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --preserve-labels

將所有標籤的索引鍵和功能旗標匯出至另一個應用程式組態並覆寫目的地標籤。

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --key * --label * --dest-label ExportedKeys

使用您的 'az login' 認證，將所有金鑰匯出至另一個應用程式組態。

az appconfig kv export -d appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --dest-endpoint https://anotherappconfiguration.azconfig.io --dest-auth-mode login --key * --label * --preserve-labels

使用 appconfig/kvset 設定檔匯出具有標籤測試的所有金鑰和功能旗標。

az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --profile appconfig/kvset

從來源設定的快照集將所有金鑰匯出至另一個應用程式組態

az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --snapshot MySnapshot

必要參數

--destination -d

匯出的目的地。 請注意，不支援將功能旗標匯出至 appservice。

接受的值: appconfig, appservice, file

選擇性參數

--appservice-account

AppService 的 ARM 識別碼或 AppService 的名稱，假設它位於與應用程式組態相同的訂用帳戶和資源群組中。 AppService 引數的必要專案。

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--dest-auth-mode

連線到目的地應用程式組態的驗證模式。 如需詳細資訊，請參閱 「--auth-mode」 引數。

接受的值: key, login
預設值: key
--dest-connection-string

目的地存放區的存取金鑰和端點組合。

--dest-endpoint

如果 --dest-auth-mode 為 「login」，請提供目的地的端點 URL 應用程式組態。

--dest-label

匯出的 KV 將會加上此目的地標籤。 如果未指定 --dest-label 和 --preserve-label，則會指派 Null 標籤。

--dest-name

目的地應用程式組態的名稱。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--export-as-reference -r
預覽

將索引鍵/值匯出為應用程式組態參考。 如需詳細資訊，請參閱https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references。

接受的值: false, true
預設值: False
--format

匯出至 的檔案格式。 檔案引數的必要專案。 目前，屬性格式不支援功能旗標。

接受的值: json, properties, yaml
--key

如果未指定任何索引鍵，則預設會傳回所有索引鍵。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的索引鍵。 金鑰篩選不適用於功能旗標。 根據預設，會匯出具有指定標籤的所有功能旗標。

--label

只會匯出具有此標籤的索引鍵和功能旗標。 如果未指定任何標籤，則預設會匯出具有 Null 標籤的索引鍵和功能旗標。 當匯出目的地是 appconfig，或匯出目的地是具有 appconfig/kvset 設定檔的檔案時，此引數支援標籤篩選的星號和逗號，例如* 表示所有標籤、abc* 表示具有 abc 做為前置詞的標籤，而 abc，xyz 表示具有 abc 或 xyz 的標籤。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--naming-convention

要用於檔案「功能管理」區段的命名慣例。 範例：pascal = FeatureManagement、camel = featureManagement、底線 = feature_management、連字號 = 功能管理。

接受的值: camel, hyphen, pascal, underscore
預設值: pascal
--path

本機組態檔路徑。 檔案引數的必要專案。

--prefix

要從索引鍵修剪的前置詞。 功能旗標會忽略前置詞。

--preserve-labels

從來源 AppConfig 保留標籤的旗標。 這個引數不應與 --dest-label 一起指定。

接受的值: false, true
預設值: False
--profile

匯出要用於匯出索引鍵/值的設定檔。 使用 'appconfig/kvset' 設定檔時，不支援 'depth'、'separator'、'prefix'、'dest-label' 和 'resolve-keyvault' 選項。

接受的值: appconfig/default, appconfig/kvset
預設值: appconfig/default
--resolve-keyvault

解析金鑰保存庫參考的內容。

接受的值: false, true
預設值: False
--separator

將索引鍵/值組扁平化為 json 或 yaml 檔案的分隔符號。 匯出階層式結構所需的 。 屬性檔和功能旗標將會忽略分隔符號。 支援的值：'.'、'、';'、'-'、'_'、'__'、'/'、'：'。

--skip-features

匯出排除所有功能旗標的專案。 根據預設，具有指定標籤的所有功能都會匯出至檔案或 appconfig。 不適用於 appservice。

接受的值: false, true
預設值: False
--skip-keyvault

匯出排除所有金鑰保存庫參考的專案。 根據預設，會匯出具有指定標籤的所有金鑰保存庫參考。

接受的值: false, true
預設值: False
--snapshot

匯出指定應用程式組態存放區快照集中的所有金鑰。 如果未指定快照集，則目前存放區中的索引鍵會根據指定的索引鍵和標籤篩選來匯出。

--yes -y

請勿提示預覽。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv import

編輯

從另一個地方將組態匯入應用程式組態。

az appconfig kv import --source {appconfig, appservice, file}
                       [--appservice-account]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--content-type]
                       [--depth]
                       [--endpoint]
                       [--format {json, properties, yaml}]
                       [--import-mode {all, ignore-match}]
                       [--label]
                       [--name]
                       [--path]
                       [--prefix]
                       [--preserve-labels {false, true}]
                       [--profile {appconfig/default, appconfig/kvset}]
                       [--separator]
                       [--skip-features {false, true}]
                       [--src-auth-mode {key, login}]
                       [--src-connection-string]
                       [--src-endpoint]
                       [--src-key]
                       [--src-label]
                       [--src-name]
                       [--src-snapshot]
                       [--strict {false, true}]
                       [--yes]

範例

從檔案匯入所有索引鍵和功能旗標，並套用測試卷標。

az appconfig kv import -n MyAppConfiguration --label test -s file --path D:/abc.json --format json

使用 null 標籤匯入所有索引鍵和功能旗標，並從應用程式組態套用新的標籤。

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --label ImportedKeys

從應用程式組態的快照集匯入所有索引鍵。

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-snapshot MySnapshot

匯入所有金鑰，並從 App Service 應用程式套用 Null 標籤。

az appconfig kv import -n MyAppConfiguration -s appservice --appservice-account MyAppService

匯入具有標籤測試的所有索引鍵，並套用 test2 標籤，但不包括應用程式組態的功能旗標。

az appconfig kv import -n MyAppConfiguration -s appconfig --src-label test --label test2 --src-name AnotherAppConfiguration --skip-features

將所有標籤的索引鍵和功能旗標匯入至另一個應用程式組態。

az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-key * --src-label * --preserve-labels

從 JSON 檔案匯入所有金鑰和功能旗標，並套用 JSON 內容類型。

az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --separator . --content-type application/json

使用您的 'az login' 認證，將所有金鑰匯入至另一個應用程式組態。

az appconfig kv import -s appconfig --endpoint https://myappconfiguration.azconfig.io --auth-mode login --src-endpoint https://anotherappconfiguration.azconfig.io --src-auth-mode login --src-key * --src-label * --preserve-labels

使用 appconfig/kvset 格式，從檔案匯入所有金鑰和功能旗標。

az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --profile appconfig/kvset

必要參數

--source -s

匯入的來源。 請注意，不支援從 appservice 匯入功能旗標。

接受的值: appconfig, appservice, file

選擇性參數

--appservice-account

AppService 的 ARM 識別碼或 AppService 的名稱，假設它位於與應用程式組態相同的訂用帳戶和資源群組中。 AppService 引數的必要專案。

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--content-type

所有匯入專案的內容類型。

--depth

將 json 或 yaml 檔案扁平化為索引鍵/值組的深度。 如果提供 --separator，則預設會扁平化為最深的層級。 不適用於屬性檔案或功能旗標。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--format

匯入的檔案格式。 檔案引數的必要專案。 目前，屬性格式不支援功能旗標。

接受的值: json, properties, yaml
--import-mode

如果匯入模式為 「ignore-match」，則不會覆寫目的地上已經存在的來源索引鍵/值。 匯入模式 「all」 會將所有索引鍵/值寫入目的地，無論它們是否存在。

接受的值: all, ignore-match
預設值: ignore-match
--label

匯入的 KV 和功能旗標將會使用此標籤指派。 如果未指定任何標籤，則會指派 Null 標籤。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--path

本機組態檔路徑。 檔案引數的必要專案。

--prefix

此前置詞會附加至匯入索引鍵的前方。 功能旗標會忽略前置詞。

--preserve-labels

從來源 AppConfig 保留標籤的旗標。 這個引數不應與 --label 一起指定。

接受的值: false, true
預設值: False
--profile

匯入要用於匯入索引鍵/值的設定檔。 使用 'appconfig/kvset' 設定檔時，不支援選項 'depth'、'separator'、'content-type'、'label'、'skip-features' 和 'prefix'。

接受的值: appconfig/default, appconfig/kvset
預設值: appconfig/default
--separator

將 json 或 yaml 檔案扁平化為索引鍵/值組的分隔符號。 屬性檔和功能旗標將會忽略分隔符號。 支援的值：'.'、'、';'、'-'、'_'、'__'、'/'、'：'。

--skip-features

只匯入索引鍵值，並排除所有功能旗標。 根據預設，所有功能旗標都會從檔案或應用程式組態匯入。 不適用於 appservice。

接受的值: false, true
預設值: False
--src-auth-mode

連線到來源應用程式組態的驗證模式。 如需詳細資訊，請參閱 「--auth-mode」 引數。

接受的值: key, login
預設值: key
--src-connection-string

來源存放區的存取金鑰和端點組合。

--src-endpoint

如果 --src-auth-mode 為 「login」，請提供來源的端點 URL 應用程式組態。

--src-key

如果未指定任何索引鍵，則預設會匯入所有索引鍵。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的索引鍵。 金鑰篩選不適用於功能旗標。 根據預設，會匯入具有指定標籤的所有功能旗標。

--src-label

只會匯入來源 AppConfig 中具有此標籤的索引鍵。 如果未指定任何值，則預設會匯入具有 Null 標籤的索引鍵。 支援星號作為篩選準則，例如 * 表示所有標籤，abc* 表示具有 abc 作為前置詞的標籤。

--src-name

來源應用程式組態的名稱。

--src-snapshot

匯入來源應用程式組態存放區指定快照集中的所有索引鍵。 如果未指定快照集，則目前存放區中的索引鍵會根據指定的索引鍵和標籤篩選來匯入。

--strict

刪除存放區中具有指定前置詞和標籤的所有其他索引鍵/值。

接受的值: false, true
預設值: False
--yes -y

請勿提示預覽。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv list

編輯

列出索引鍵/值。

az appconfig kv list [--all]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--fields {content_type, etag, key, label, last_modified, locked, tags, value}]
                     [--key]
                     [--label]
                     [--name]
                     [--resolve-keyvault {false, true}]
                     [--snapshot]
                     [--top]

範例

列出具有 Null 標籤的所有索引鍵/值。

az appconfig kv list -n MyAppConfiguration --label \0

列出任何標籤從 v1 開始的特定索引鍵。 使用 連接字串。

az appconfig kv list --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.*

列出具有任何標籤的所有索引鍵，並只查詢索引鍵、值和標籤。

az appconfig kv list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --fields key value tags --datetime "2019-05-01T11:24:12Z"

列出金鑰保存庫參考的內容，其中含有金鑰前置詞 'KVRef_'，而且只選取金鑰和值。

az appconfig kv list -n MyAppConfiguration --key "KVRef_*" --resolve-keyvault --query "[*].{key:key, value:value}"

列出具有多個標籤的索引鍵/值。

az appconfig kv list --label test,prod,\0 -n MyAppConfiguration

使用 'az login' 認證列出所有標籤的所有索引鍵/值。

az appconfig kv list --endpoint https://myappconfiguration.azconfig.io --auth-mode login

列出應用程式組態存放區指定快照集中的所有索引鍵/值。

az appconfig kv list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --snapshot MySnapshot

選擇性參數

--all

列出所有專案。

預設值: False
--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--datetime

格式：「YYYY-MM-DDThh：mm：ssZ」。 如果未指定時區，則預設使用 UTC。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--fields

以空格分隔的自訂輸出欄位。

接受的值: content_type, etag, key, label, last_modified, locked, tags, value
--key

如果未指定任何索引鍵，則預設會傳回所有索引鍵。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的索引鍵。

--label

如果未指定任何標籤，請列出所有標籤。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的標籤。 針對 Null 標籤使用 '\0'。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--resolve-keyvault

解析金鑰保存庫參考的內容。 這個引數不應與 --fields 一起指定。 請改用 --query 進行自訂查詢。

接受的值: false, true
預設值: False
--snapshot

列出指定應用程式組態存放區快照集中的所有索引鍵。 如果未指定快照集，則會列出存放區中目前所在的索引鍵。

--top -t

要傳回的專案數目上限。 必須是正整數。 預設為 100。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv lock

編輯

鎖定索引鍵/值以禁止寫入作業。

az appconfig kv lock --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--endpoint]
                     [--label]
                     [--name]
                     [--yes]

範例

使用應用程式組態名稱鎖定索引鍵/值。

az appconfig kv lock -n MyAppConfiguration --key color --label test

使用連接字串強制鎖定索引鍵/值。

az appconfig kv lock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

必要參數

--key

要鎖定的金鑰。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，請使用 Null 標籤鎖定專案。 不支援篩選。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv restore

編輯

還原索引鍵/值。

az appconfig kv restore --datetime
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--endpoint]
                        [--key]
                        [--label]
                        [--name]
                        [--yes]

範例

將所有索引鍵/值還原至特定時間點。

az appconfig kv restore -n MyAppConfiguration --datetime "2019-05-01T11:24:12Z"

從 v1 開始，還原任何標籤的特定金鑰。 使用 連接字串到特定時間點。

az appconfig kv restore --key color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.* --datetime "2019-05-01T11:24:12Z"

必要參數

--datetime

格式：「YYYY-MM-DDThh：mm：ssZ」。 如果未指定時區，則預設使用 UTC。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--key

如果未指定任何金鑰，則預設會還原所有金鑰。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的索引鍵。

--label

如果未指定任何標籤，請還原具有所有標籤的所有機碼/值組。 支援星號作為篩選準則，例如 abc* 表示具有 abc 作為前置詞的標籤。 針對 Null 標籤使用 '\0'。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv set

編輯

設定索引鍵/值。

az appconfig kv set --key
                    [--auth-mode {key, login}]
                    [--connection-string]
                    [--content-type]
                    [--endpoint]
                    [--label]
                    [--name]
                    [--tags]
                    [--value]
                    [--yes]

範例

使用標籤 MyLabel 設定索引鍵/值。

az appconfig kv set -n MyAppConfiguration --key color --label MyLabel --value red

使用 連接字串 設定具有 null 標籤的索引鍵。

az appconfig kv set --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --value red --tags key1=value1 key2=value2

使用字串值和 JSON 內容類型設定索引鍵。

az appconfig kv set -n MyAppConfiguration --key color --value \"red\" --content-type application/json

使用清單值和 JSON 內容類型設定索引鍵。

az appconfig kv set -n MyAppConfiguration --key options --value [1,2,3] --content-type application/activity+json;charset=utf-8

使用 Null 值和 JSON 內容類型設定索引鍵。

az appconfig kv set -n MyAppConfiguration --key foo --value null --content-type application/json

使用您的 'az login' 認證來設定機碼值。

az appconfig kv set --endpoint https://myappconfiguration.azconfig.io --key color --value red --auth-mode login

必要參數

--key

要設定的索引鍵。 索引鍵不能是 '.' 或 '..'，或包含 '%' 字元。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--content-type

要設定之索引鍵值的內容型別。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，則預設會以 Null 標籤設定索引鍵。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--tags

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

--value

要設定之索引鍵值的值。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv set-keyvault

編輯

設定 keyvault 參考。

az appconfig kv set-keyvault --key
                             --secret-identifier
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--endpoint]
                             [--label]
                             [--name]
                             [--tags]
                             [--yes]

範例

使用標籤 MyLabel 設定 keyvault 參考。

az appconfig kv set-keyvault -n MyAppConfiguration --key HostSecret --label MyLabel --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret/Dummyversion

使用 null 標籤和多個標記來設定 keyvault 參考，並使用 連接字串。

az appconfig kv set-keyvault --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key HostSecret --secret-identifier https://contoso.vault.azure.net/Secrets/DummySecret --tags tag1=value1 tag2=value2

必要參數

--key

要設定的索引鍵。 索引鍵不能是 '.' 或 '..'，或包含 '%' 字元。

--secret-identifier

金鑰保存庫 物件的識別碼。 您可以使用 'az keyvault {collection} show' 命令找到，其中 collection 是金鑰、秘密或憑證。 若要設定密碼最新版本的參考，請從秘密識別碼中移除版本資訊。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，則預設會以 Null 標籤設定索引鍵。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--tags

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

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv show

編輯

顯示索引鍵/值的所有屬性。

az appconfig kv show --key
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--datetime]
                     [--endpoint]
                     [--label]
                     [--name]

範例

使用具有特定標籤和日期時間應用程式組態名稱來顯示索引鍵/值

az appconfig kv show -n MyAppConfiguration --key color --label MyLabel --datetime "2019-05-01T11:24:12Z"

使用具有標籤的連接字串顯示索引鍵/值

az appconfig kv show --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label MyLabel

使用您的 'az login' 認證顯示機碼值。

az appconfig kv show --key color --auth-mode login --endpoint https://myappconfiguration.azconfig.io

必要參數

--key

要顯示的索引鍵。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--datetime

格式：「YYYY-MM-DDThh：mm：ssZ」。 如果未指定時區，則預設使用 UTC。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，則顯示具有 Null 標籤的專案。 不支援篩選。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az appconfig kv unlock

編輯

解除鎖定索引鍵/值以取得寫入作業。

az appconfig kv unlock --key
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--endpoint]
                       [--label]
                       [--name]
                       [--yes]

範例

使用應用程式組態名稱解除鎖定索引鍵/值。

az appconfig kv unlock -n MyAppConfiguration --key color --label test

使用連接字串強制解除鎖定索引鍵/值。

az appconfig kv unlock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --label test --yes

必要參數

--key

要解除鎖定的金鑰。

選擇性參數

--auth-mode

這個參數可用來指出資料作業的授權方式。 如果驗證模式為「金鑰」，請提供連接字串或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供存放區端點或存放區名稱，而您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode> 。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 使用者可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或 環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供應用程式組態的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint> 。

--label

如果未指定任何標籤，請使用 Null 標籤解除鎖定專案。 不支援篩選。

--name -n

應用程式組態的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name> 。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。