az appconfig
管理应用程序配置。
命令
az appconfig create
创建应用配置。
az appconfig create --___location
--name
--resource-group
[--arm-auth-mode {local, pass-through}]
[--assign-identity]
[--disable-local-auth {false, true}]
[--enable-arm-private-network-access {false, true}]
[--enable-public-network {false, true}]
[--enable-purge-protection {false, true}]
[--no-replica {false, true}]
[--replica-___location]
[--replica-name]
[--retention-days]
[--sku {Developer, Free, Premium, Standard}]
[--tags]
示例
创建名称、位置、SKU、标记和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --tags key1=value1 key2=value2
使用开发人员 SKU 创建应用程序配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Developer
使用副本创建高级 SKU 应用配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --replica-name MyReplica --replica-___location eastus
创建没有副本的高级 SKU 应用配置存储
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Premium --no-replica
创建具有系统分配标识的名称、位置、SKU 和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity
创建具有用户分配标识的名称、位置、SKU 和资源组的应用配置存储区。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity /subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCEGROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUserAssignedIdentity
创建名称、位置和资源组的应用配置存储区,其中启用了公用网络访问,并禁用了本地身份验证。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --enable-public-network --disable-local-auth
创建名称、位置和资源组的应用配置存储,并将 ARM 身份验证模式设置为直通。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through
创建名称、位置和资源组的应用配置存储,其 ARM 身份验证模式设置为启用 ARM 专用链接的直通和专用网络访问。
az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --arm-auth-mode pass-through --enable-arm-private-network-access true
必需参数
Location。
az account list-locations
中的值。 可以使用 az configure --defaults ___location=<___location>
配置默认位置。
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
通过 ARM 访问应用配置存储的身份验证模式。 “直通”(建议)使用 Microsoft Entra ID 通过 ARM 使用适当的授权访问存储。“local”使用访问密钥进行身份验证。 这需要启用访问密钥。
要分配的托管标识的空间分隔列表。 使用“[system]”来引用系统分配的托管标识或资源 ID 来引用用户分配的托管标识。 如果未提供此参数任何值,则默认情况下将分配系统分配的托管标识。 如果未提供此参数,则不会向此应用程序配置存储区分配托管标识。
禁用除 AAD 身份验证以外的所有身份验证方法。
如果资源仅限于专用网络访问,则通过 ARM 专用链接启用对应用配置存储的访问。 需要直通 ARM 身份验证模式。
如果为 true,来自公用网络的请求有权在启用专用终结点时访问此存储。 如果为 false,则只有通过专用链接发出的请求才能访问此存储。
指定是否为此应用程序配置存储启用针对清除的保护的属性。 将此属性设置为 true 可激活针对此应用程序配置存储及其内容的清除保护。 启用此功能不可逆。
继续为高级层存储创建副本。
应用程序配置存储的副本的位置。
应用程序配置存储的副本的名称。
删除后保留启用软删除的应用配置存储的天数。 必须是介于 0 和 7 之间的正整数。
应用配置存储的 SKU。
空格分隔标记:key[=value] [key[=value] ...]。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig delete
删除应用配置存储区。
az appconfig delete --name
[--resource-group]
[--yes]
示例
删除资源组下的应用配置存储区
az appconfig delete -g MyResourceGroup -n MyAppConfiguration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
不要提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig list
列出当前订阅下的所有应用配置存储区。
az appconfig list [--resource-group]
示例
列出资源组下的所有应用配置存储区
az appconfig list -g MyResourceGroup
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig list-deleted
列出所有已删除但尚未清除的应用配置存储区。
az appconfig list-deleted
示例
列出所有已删除但尚未清除的应用配置存储区。
az appconfig list-deleted
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig purge
永久删除应用配置存储区。 Aka“清除”已删除的应用配置存储区。
az appconfig purge --name
[--___location]
[--yes]
示例
清除名为“sample-app-configuration”的已删除应用配置存储区。
az appconfig purge --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
已删除的应用配置存储区的位置。 可以使用命令 az appconfig show-deleted
查看 。
不要提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig recover
恢复以前删除但尚未清除的应用配置存储。
az appconfig recover --name
[--___location]
[--resource-group]
[--yes]
示例
恢复名为“sample-app-configuration”的已删除应用配置存储区。
az appconfig recover --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
已删除的应用配置存储区的位置。 可以使用命令 az appconfig show-deleted
查看 。
已删除的应用配置存储的资源组。
不要提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig show
显示应用配置存储区的属性。
az appconfig show --name
[--resource-group]
示例
显示应用配置存储区的属性
az appconfig show -g MyResourceGroup -n MyAppConfiguration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig show-deleted
显示已删除但尚未清除的应用配置存储的属性。
az appconfig show-deleted --name
[--___location]
示例
显示名为“sample-app-configuration”的已删除应用配置存储的属性。
az appconfig show-deleted --name sample-app-configuration
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
已删除的应用配置存储区的位置。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
az appconfig update
更新应用配置存储区。
az appconfig update --name
[--arm-auth-mode {local, pass-through}]
[--disable-local-auth {false, true}]
[--enable-arm-private-network-access {false, true}]
[--enable-public-network {false, true}]
[--enable-purge-protection {false, true}]
[--encryption-key-name]
[--encryption-key-vault]
[--encryption-key-version]
[--identity-client-id]
[--resource-group]
[--sku {Developer, Free, Premium, Standard}]
[--tags]
示例
更新应用配置存储的标记
az appconfig update -g MyResourceGroup -n MyAppConfiguration --tags key1=value1 key2=value2
将应用配置存储的 SKU 升级到标准层
az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Standard
将应用配置存储的 SKU 升级到高级层
az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Premium
使用系统分配的标识启用客户加密密钥
az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name myKey --encryption-key-version keyVersion --encryption-key-vault https://keyVaultName.vault.azure.net
删除客户加密密钥
az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name ""
更新应用配置存储区以启用公共网络访问并禁用本地身份验证。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --enable-public-network true --disable-local-auth true
更新应用配置存储区,将 ARM 身份验证模式设置为直通。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through
更新应用配置存储区,将 ARM 身份验证模式设置为直通,并通过 ARM 专用链接启用专用网络访问。
az appconfig update -g MyResourceGroup -n MyAppConfiguration --arm-auth-mode pass-through --enable-arm-private-network-access true
必需参数
应用配置存储区的名称。 可以使用 az configure --defaults app_configuration_store=<name>
配置默认名称。
可选参数
通过 ARM 访问应用配置存储的身份验证模式。 “直通”(建议)使用 Microsoft Entra ID 通过 ARM 使用适当的授权访问存储。“local”使用访问密钥进行身份验证。 这需要启用访问密钥。
禁用除 AAD 身份验证以外的所有身份验证方法。
如果资源仅限于专用网络访问,则通过 ARM 专用链接启用对应用配置存储的访问。 需要直通 ARM 身份验证模式。
如果为 true,来自公用网络的请求有权在启用专用终结点时访问此存储。 如果为 false,则只有通过专用链接发出的请求才能访问此存储。
指定是否为此应用程序配置存储启用针对清除的保护的属性。 将此属性设置为 true 可激活针对此应用程序配置存储及其内容的清除保护。 启用此功能不可逆。
KeyVault 密钥的名称。
KeyVault 的 URI。
KeyVault 密钥的版本。 默认情况下使用最新版本。
对加密密钥进行包装和解包访问的托管标识的客户端 ID。 默认情况下使用系统分配的托管标识。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
应用配置存储的 SKU。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。