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」，請提供 --endpoint 或 --name ，且您的「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」，請提供 --endpoint 或 --name ，且您的「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

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

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

接受的值: key, login

預設值: key

--connection-string

--content-type

所有匯入項目的內容類型。

--depth

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

--endpoint

--format

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

接受的值: json, properties, yaml

--import-mode

如果匯入模式是「忽略比對」，則只會寫入尚未存在或其值、內容類型或標籤與具有相同索引鍵和標籤的現有索引鍵/值的來源索引鍵/值。匯入模式「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

接受的值: key, login

預設值: key

--connection-string

--datetime

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

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

接受的值: key, login

預設值: key

--connection-string

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

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

接受的值: key, login

預設值: key

--connection-string

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

接受的值: key, login

預設值: key

--connection-string

--content-type

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

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

接受的值: key, login

預設值: key

--connection-string

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

接受的值: key, login

預設值: key

--connection-string

--datetime

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

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

接受的值: key, login

預設值: key

--connection-string

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

命令

az appconfig kv delete

範例

必要參數

選擇性參數

az appconfig kv export

範例

必要參數

選擇性參數

az appconfig kv import

範例

必要參數

選擇性參數

az appconfig kv list

範例

選擇性參數

az appconfig kv lock

範例

必要參數

選擇性參數

az appconfig kv restore

範例

必要參數

選擇性參數

az appconfig kv set

範例

必要參數

選擇性參數

az appconfig kv set-keyvault

範例

必要參數

選擇性參數

az appconfig kv show

範例

必要參數

選擇性參數

az appconfig kv unlock

範例

必要參數

選擇性參數

其他資源