你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az appconfig kv

管理存储在应用程序配置存储中的键值。

命令

名称 说明 类型 Status
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

订阅的名称或 ID。 可以使用 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]

示例

将带有标签 test 的所有键和功能标志导出到 json 文件。

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

将所有带有 null 标签的密钥导出到App 服务应用程序。

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

应用程序配置存储的访问密钥和终结点的组合。 可以使用“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”、“naming-convention”、“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

订阅的名称或 ID。 可以使用 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]

示例

从文件导入所有键和功能标志并应用 test 标签。

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

导入所有键并通过应用服务应用程序应用 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 ID 或 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

应用程序配置存储的访问密钥和终结点的组合。 可以使用“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

仅导入键值并排除所有功能标志。 默认情况下,将从文件或 appconfig 导入所有功能标志。 不适用于 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

订阅的名称或 ID。 可以使用 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”,请提供 --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。

--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 作为前缀的标签。 将“\0”用于 null 标签。

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

订阅的名称或 ID。 可以使用 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”,请提供 --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 标签的条目。 不支持筛选。

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

订阅的名称或 ID。 可以使用 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”,请提供 --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>

--key

如果未指定任何密钥,则默认还原所有密钥。 支持星号作为筛选器,例如 abc* 表示带有 abc 作为前缀的密钥。

--label

如果未指定任何标签,请还原所有标签的键值对。 支持星号作为筛选器,例如 abc* 表示带有 abc 作为前缀的标签。 将“\0”用于 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

订阅的名称或 ID。 可以使用 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”,请提供 --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。

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

订阅的名称或 ID。 可以使用 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

密钥库对象的 ID。 可以使用“az keyvault {collection} show”命令找到集合是密钥、机密或证书。 若要设置对最新版本的机密的引用,请从机密标识符中删除版本信息。

可选参数

--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 标签设置键。

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

订阅的名称或 ID。 可以使用 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”,请提供 --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。

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

订阅的名称或 ID。 可以使用 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”,请提供 --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 标签的条目。 不支持筛选。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。