az appconfig kv

Référence

Gérer les valeurs de clé stockées dans une configuration d’application.

Commandes

Nom	Description	Type	Statut
az appconfig kv delete	Supprimez les valeurs de clé.	Core	GA
az appconfig kv export	Exportez des configurations vers un autre emplacement à partir de votre App Configuration.	Core	GA
az appconfig kv import	Importez des configurations dans votre App Configuration à partir d’un autre emplacement.	Core	GA
az appconfig kv list	Répertorier les valeurs clés.	Core	GA
az appconfig kv lock	Verrouillez une valeur clé pour interdire les opérations d’écriture.	Core	GA
az appconfig kv restore	Restaurez les valeurs de clé.	Core	GA
az appconfig kv set	Définissez une clé-valeur.	Core	GA
az appconfig kv set-keyvault	Définissez une référence de coffre de clés.	Core	GA
az appconfig kv show	Afficher tous les attributs d’une clé-valeur.	Core	GA
az appconfig kv unlock	Déverrouillez une valeur clé pour obtenir des opérations d’écriture.	Core	GA

az appconfig kv delete

Modifier

Supprimez les valeurs de clé.

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

Exemples

Supprimez une clé à l’aide du nom App Configuration sans confirmation.

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

Supprimez une clé à l’aide de chaîne de connexion.

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

Supprimez une clé à l’aide des informations d’identification « az login » et du point de terminaison App Configuration.

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

Paramètres obligatoires

--key

Prise en charge du signe étoile en tant que filtres, par exemple * signifie toutes les clés et abc* signifie les clés avec abc comme préfixe.

Paramètres facultatifs

--auth-mode

Ce paramètre peut être utilisé pour indiquer comment une opération de données doit être autorisée. Si le mode d’authentification est « clé », fournissez chaîne de connexion ou stockez le nom et vos clés d’accès de compte seront récupérées pour l’autorisation. Si le mode d’authentification est « login », indiquez le point de terminaison de magasin ou le nom du magasin et vos informations d’identification « az login » seront utilisées pour l’autorisation. Vous pouvez configurer le mode d’authentification par défaut à l’aide az configure --defaults appconfig_auth_mode=<auth_mode>de . Pour plus d’informations, consultez https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

Combinaison de la clé d’accès et du point de terminaison d’App Configuration. Vous trouverez la liste d’informations d’identification « az appconfig » (az appconfig credential list). Les utilisateurs peuvent le prédéfinir à l’aide az configure --defaults appconfig_connection_string=<connection_string> ou à la variable d’environnement avec le nom AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Si le mode d’authentification est « login », indiquez l’URL du point de terminaison de l’App Configuration. Le point de terminaison peut être récupéré à l’aide de la commande « az appconfig show ». Vous pouvez configurer le point de terminaison par défaut à l’aide az configure --defaults appconfig_endpoint=<endpoint>de .

--label

Si aucune étiquette n’est spécifiée, supprimez l’entrée avec une étiquette Null. Prise en charge du signe étoile en tant que filtres, par exemple * signifie que toutes les étiquettes et abc* signifient des étiquettes avec abc comme préfixe.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv export

Modifier

Exportez des configurations vers un autre emplacement à partir de votre App Configuration.

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]

Exemples

Exportez toutes les clés et tous les indicateurs de fonctionnalité avec l’étiquette test dans un fichier json.

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

Exportez toutes les clés avec une étiquette Null vers une application App Service.

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

Exportez toutes les clés avec test d’étiquette à l’exclusion des indicateurs de fonctionnalité dans un fichier json.

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

Exportez toutes les clés et tous les indicateurs de fonctionnalité avec toutes les étiquettes dans une autre configuration d’application.

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

Exportez toutes les clés et tous les indicateurs de fonctionnalité avec toutes les étiquettes dans une autre configuration d’application, et remplacez les étiquettes de destination.

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

Exportez toutes les clés vers une autre App Configuration à l’aide de vos informations d’identification « 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

Exportez toutes les clés et indicateurs de fonctionnalité avec test d’étiquette à l’aide du profil appconfig/kvset.

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

Exporter toutes les clés vers une autre app Configuration à partir d’un instantané de la configuration source

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

Paramètres obligatoires

--destination -d

Destination de l’exportation. Notez que l’exportation d’indicateurs de fonctionnalité vers appservice n’est pas prise en charge.

valeurs acceptées: appconfig, appservice, file

Paramètres facultatifs

--appservice-account

ID ARM pour AppService OU nom de l’AppService, en supposant qu’il se trouve dans le même abonnement et le même groupe de ressources que App Configuration. Obligatoire pour les arguments AppService.

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--dest-auth-mode

Mode d’authentification pour la connexion à destination App Configuration. Pour plus d’informations, reportez-vous à l’argument « --auth-mode ».

valeurs acceptées: key, login

valeur par défaut: key

--dest-connection-string

Combinaison de la clé d’accès et du point de terminaison du magasin de destination.

--dest-endpoint

Si --dest-auth-mode est « login », indiquez l’URL du point de terminaison de la configuration d’application de destination.

--dest-label

Les KVS exportés sont étiquetés avec cette étiquette de destination. Si ni --dest-label ni --preserve-labels n’est spécifié, affectez une étiquette Null.

--dest-name

Nom de la configuration de l’application de destination.

--endpoint

--export-as-reference -r

Exportez les valeurs clés en tant que références App Configuration. Pour plus d’informations, consultez https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

valeurs acceptées: false, true

valeur par défaut: False

--format

Format de fichier vers lequel exporter. Obligatoire pour les arguments de fichier. Actuellement, les indicateurs de fonctionnalité ne sont pas pris en charge au format des propriétés.

valeurs acceptées: json, properties, yaml

--key

Si aucune clé n’est spécifiée, retournez toutes les clés par défaut. Prendre en charge le signe étoile en tant que filtres, par exemple abc* signifie les clés avec abc comme préfixe. Filtrage de clé non applicable pour les indicateurs de fonctionnalité. Par défaut, tous les indicateurs de fonctionnalité dont l’étiquette est spécifiée sont exportés.

--label

Seules les clés et les indicateurs de fonctionnalité avec cette étiquette seront exportés. Si aucune étiquette n’est spécifiée, exportez les clés et les indicateurs de fonctionnalité avec une étiquette Null par défaut. Lorsque la destination d’exportation est appconfig ou lorsque la destination d’exportation est un fichier avec appconfig/kvset profil, cet argument prend en charge les signes astérisque et virgule pour le filtrage des étiquettes, par exemple * signifie toutes les étiquettes, abc* signifie les étiquettes avec abc comme préfixe, et abc, xyz signifie les étiquettes avec abc ou xyz.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--naming-convention

Convention d’affectation de noms à utiliser pour la section « Gestion des fonctionnalités » du fichier. Exemple : pascal = FeatureManagement, camel = featureManagement, trait de soulignement = feature_management, trait d’union = feature-management.

valeurs acceptées: camel, hyphen, pascal, underscore

valeur par défaut: pascal

--path

Chemin d’accès au fichier de configuration local. Obligatoire pour les arguments de fichier.

--prefix

Préfixe à supprimer des clés. Le préfixe est ignoré pour les indicateurs de fonctionnalités.

--preserve-labels

Indicateur pour conserver les étiquettes à partir d’AppConfig source. Cet argument ne doit PAS être spécifié avec --dest-label.

valeurs acceptées: false, true

valeur par défaut: False

--profile

Exportez le profil à utiliser pour exporter les valeurs de clé. Les options « depth », « separator », « naming-convention », « prefix », « dest-label » et « resolve-keyvault » ne sont pas prises en charge lors de l’utilisation du profil « appconfig/kvset ».

valeurs acceptées: appconfig/default, appconfig/kvset

valeur par défaut: appconfig/default

--resolve-keyvault

Résolvez le contenu de la référence du coffre de clés.

valeurs acceptées: false, true

valeur par défaut: False

--separator

Délimiteur pour aplatir les paires clé-valeur en fichier json ou yaml. Obligatoire pour l’exportation d’une structure hiérarchique. Le séparateur est ignoré pour les fichiers de propriétés et les indicateurs de fonctionnalité. Valeurs prises en charge : '.', ',', ' ;', '-', '_', '__', '/', ' :'.

--skip-features

Exportez des éléments à l’exclusion de tous les indicateurs de fonctionnalité. Par défaut, toutes les fonctionnalités avec l’étiquette spécifiée sont exportées vers le fichier ou appconfig. Non applicable pour appservice.

valeurs acceptées: false, true

valeur par défaut: False

--skip-keyvault

Exportez des éléments à l’exclusion de toutes les références de coffre de clés. Par défaut, toutes les références de coffre de clés avec l’étiquette spécifiée sont exportées.

valeurs acceptées: false, true

valeur par défaut: False

--snapshot

Exportez toutes les clés dans un instantané donné du magasin App Configuration. Si aucune instantané n’est spécifiée, les clés actuellement dans le magasin sont exportées en fonction des filtres de clé et d’étiquette spécifiés.

--yes -y

N’invitez pas la préversion.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv import

Modifier

Importez des configurations dans votre App Configuration à partir d’un autre emplacement.

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]

Exemples

Importez toutes les clés et tous les indicateurs de fonctionnalité à partir d’un fichier, et appliquez l’étiquette test.

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

Importez toutes les clés et indicateurs de fonctionnalité avec une étiquette Null et appliquez une nouvelle étiquette à partir d’une App Configuration.

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

Importez toutes les clés à partir d’un instantané d’une configuration d’application.

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

Importez toutes les clés et appliquez l’étiquette null à partir d’une application App Service.

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

Importez toutes les clés avec test d’étiquette et appliquez l’étiquette test2 à l’exclusion des indicateurs de fonctionnalité d’une app Configuration.

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

Importez toutes les clés et indicateurs de fonctionnalité avec toutes les étiquettes dans une autre App Configuration.

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

Importez toutes les clés et indicateurs de fonctionnalité à partir d’un fichier JSON et appliquez le type de contenu JSON.

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

Importez toutes les clés dans une autre App Configuration à l’aide de vos informations d’identification « 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

Importez toutes les clés et indicateurs de fonctionnalité à partir d’un fichier à l’aide du format appconfig/kvset.

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

Paramètres obligatoires

--source -s

Source de l’importation. Notez que l’importation d’indicateurs de fonctionnalité à partir d’appservice n’est pas prise en charge.

valeurs acceptées: appconfig, appservice, file

Paramètres facultatifs

--appservice-account

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--content-type

Type de contenu de tous les éléments importés.

--depth

Profondeur pour aplatir le fichier json ou yaml en paires clé-valeur. Aplatir au niveau le plus profond par défaut si --separator est fourni. Non applicable aux fichiers de propriétés ou aux indicateurs de fonctionnalité.

--endpoint

--format

Format de fichier importé. Obligatoire pour les arguments de fichier. Actuellement, les indicateurs de fonctionnalité ne sont pas pris en charge au format des propriétés.

valeurs acceptées: json, properties, yaml

--import-mode

Si le mode d’importation est « ignore-match », les valeurs de clé source qui existent déjà à la destination ne seront pas remplacées. Le mode d’importation « all » écrit toutes les valeurs de clé dans la destination, qu’elles existent ou non.

valeurs acceptées: all, ignore-match

valeur par défaut: ignore-match

--label

Les indicateurs de performance clés et les indicateurs de fonctionnalité importés seront attribués avec cette étiquette. Si aucune étiquette n’est spécifiée, attribue une étiquette Null.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--path

Chemin d’accès au fichier de configuration local. Obligatoire pour les arguments de fichier.

--prefix

Ce préfixe sera ajouté à l’avant des clés importées. Le préfixe est ignoré pour les indicateurs de fonctionnalités.

--preserve-labels

Indicateur pour conserver les étiquettes à partir d’AppConfig source. Cet argument ne doit PAS être spécifié avec --label.

valeurs acceptées: false, true

valeur par défaut: False

--profile

Importer le profil à utiliser pour importer les valeurs clés. Les options « depth », « separator », « content-type », « label », « skip-features » et « prefix » ne sont pas prises en charge lors de l’utilisation du profil « appconfig/kvset ».

valeurs acceptées: appconfig/default, appconfig/kvset

valeur par défaut: appconfig/default

--separator

Délimiteur pour aplatir le fichier json ou yaml en paires clé-valeur. Le séparateur est ignoré pour les fichiers de propriétés et les indicateurs de fonctionnalité. Valeurs prises en charge : '.', ',', ' ;', '-', '_', '__', '/', ' :'.

--skip-features

Importez uniquement les valeurs de clé et excluez tous les indicateurs de fonctionnalité. Par défaut, tous les indicateurs de fonctionnalité sont importés à partir d’un fichier ou d’un appconfig. Non applicable pour appservice.

valeurs acceptées: false, true

valeur par défaut: False

--src-auth-mode

Mode d’authentification pour la connexion à la configuration d’application source. Pour plus d’informations, reportez-vous à l’argument « --auth-mode ».

valeurs acceptées: key, login

valeur par défaut: key

--src-connection-string

Combinaison de la clé d’accès et du point de terminaison du magasin source.

--src-endpoint

Si --src-auth-mode est « login », indiquez l’URL du point de terminaison de la configuration d’application source.

--src-key

Si aucune clé n’est spécifiée, importez toutes les clés par défaut. Prendre en charge le signe étoile en tant que filtres, par exemple abc* signifie les clés avec abc comme préfixe. Filtrage de clé non applicable pour les indicateurs de fonctionnalité. Par défaut, tous les indicateurs de fonctionnalité avec l’étiquette spécifiée sont importés.

--src-label

Seules les clés avec cette étiquette dans AppConfig source seront importées. Si aucune valeur n’est spécifiée, importez des clés avec une étiquette Null par défaut. Prendre en charge le signe étoile en tant que filtres, par exemple * signifie toutes les étiquettes, abc* signifie les étiquettes avec abc comme préfixe.

--src-name

Nom de la configuration d’application source.

--src-snapshot

Importez toutes les clés dans une instantané donnée du magasin App Configuration source. Si aucune instantané n’est spécifiée, les clés actuellement dans le magasin sont importées en fonction des filtres de clé et d’étiquette spécifiés.

--strict

Supprimez toutes les autres valeurs de clé dans le magasin avec le préfixe et l’étiquette spécifiés.

valeurs acceptées: false, true

valeur par défaut: False

--yes -y

N’invitez pas la préversion.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv list

Modifier

Répertorier les valeurs clés.

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]

Exemples

Répertorier toutes les valeurs de clé avec une étiquette Null.

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

Répertoriez une clé spécifique pour n’importe quelle étiquette commençant par v1. utilisation de chaîne de connexion.

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

Répertoriez toutes les clés avec toutes les étiquettes et interrogez uniquement la clé, la valeur et les balises.

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"

Répertoriez le contenu de la référence du coffre de clés avec le préfixe de clé « KVRef_ » et sélectionnez uniquement la clé et la valeur.

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

Répertoriez les valeurs clés avec plusieurs étiquettes.

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

Répertoriez toutes les valeurs de clé avec toutes les étiquettes à l’aide de vos informations d’identification « az login ».

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

Répertoriez toutes les valeurs de clé dans un instantané donné du magasin de configuration d’application.

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

Paramètres facultatifs

--all

Répertorier tous les éléments.

valeur par défaut: False

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--datetime

Format : « YYYY-MM-DDThh:mm:ssZ ». Si aucun fuseau horaire n’est spécifié, utilisez UTC par défaut.

--endpoint

--fields

Champs de sortie personnalisés séparés par l’espace.

valeurs acceptées: content_type, etag, key, label, last_modified, locked, tags, value

--key

Si aucune clé n’est spécifiée, retournez toutes les clés par défaut. Prendre en charge le signe étoile en tant que filtres, par exemple abc* signifie les clés avec abc comme préfixe.

--label

Si aucune étiquette n’est spécifiée, répertoriez toutes les étiquettes. Prendre en charge le signe en étoile en tant que filtres, par exemple abc* signifie que les étiquettes avec abc comme préfixe. Utilisez « \0 » pour l’étiquette Null.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--resolve-keyvault

Résolvez le contenu de la référence du coffre de clés. Cet argument ne doit PAS être spécifié avec --fields. Utilisez plutôt --query pour une requête personnalisée.

valeurs acceptées: false, true

valeur par défaut: False

--snapshot

Répertoriez toutes les clés dans une instantané donnée du magasin App Configuration. Si aucune instantané n’est spécifiée, les clés actuellement dans le magasin sont répertoriées.

--top -t

Nombre maximal d’éléments à retourner. Cette valeur doit être un entier positif. La valeur par défaut est 100.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv lock

Modifier

Verrouillez une valeur clé pour interdire les opérations d’écriture.

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

Exemples

Verrouillez une clé-valeur à l’aide du nom App Configuration.

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

Forcer le verrouillage d’une clé-valeur à l’aide de chaîne de connexion.

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

Paramètres obligatoires

--key

Clé à verrouiller.

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--endpoint

--label

Si aucune étiquette n’est spécifiée, verrouillez l’entrée avec une étiquette Null. Le filtrage n’est pas pris en charge.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv restore

Modifier

Restaurez les valeurs de clé.

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

Exemples

Restaurez toutes les paires clé-valeur à un point dans le temps spécifique.

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

Restaurez une clé spécifique pour n’importe quelle étiquette commençant par v1. utilisation de chaîne de connexion à un point spécifique dans le temps.

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"

Paramètres obligatoires

--datetime

Format : « YYYY-MM-DDThh:mm:ssZ ». Si aucun fuseau horaire n’est spécifié, utilisez UTC par défaut.

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--endpoint

--key

Si aucune clé n’est spécifiée, restaurez toutes les clés par défaut. Prendre en charge le signe étoile en tant que filtres, par exemple abc* signifie les clés avec abc comme préfixe.

--label

Si aucune étiquette n’est spécifiée, restaurez toutes les paires clé-valeur avec toutes les étiquettes. Prendre en charge le signe en étoile en tant que filtres, par exemple abc* signifie que les étiquettes avec abc comme préfixe. Utilisez « \0 » pour l’étiquette Null.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv set

Modifier

Définissez une clé-valeur.

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

Exemples

Définissez une clé-valeur avec l’étiquette MyLabel.

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

Définissez une clé avec une étiquette Null à l’aide de chaîne de connexion.

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

Définissez une clé avec une valeur de chaîne et un type de contenu JSON.

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

Définissez une clé avec la valeur de liste et le type de contenu JSON.

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

Définissez une clé avec une valeur Null et un type de contenu JSON.

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

Définissez une valeur clé à l’aide de vos informations d’identification « az login ».

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

Paramètres obligatoires

--key

Clé à définir. La clé ne peut pas être « . » ou « .. » ou contenir le caractère « % ».

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--content-type

Type de contenu de la valeur de clé à définir.

--endpoint

--label

Si aucune étiquette n’est spécifiée, définissez la clé avec une étiquette Null par défaut.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--value

Valeur de la valeur de clé à définir.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv set-keyvault

Modifier

Définissez une référence de coffre de clés.

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

Exemples

Définissez une référence de coffre de clés avec l’étiquette MyLabel.

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

Définissez une référence de coffre de clés avec une étiquette Null et plusieurs balises à l’aide de chaîne de connexion.

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

Paramètres obligatoires

--key

Clé à définir. La clé ne peut pas être « . » ou « .. » ou contenir le caractère « % ».

--secret-identifier

ID de l’objet Key Vault. Vous trouverez la commande « az keyvault {collection} show », où la collection est clé, secret ou certificat. Pour définir la référence à la dernière version de votre secret, supprimez les informations de version de l’identificateur de secret.

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--endpoint

--label

Si aucune étiquette n’est spécifiée, définissez la clé avec une étiquette Null par défaut.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv show

Modifier

Afficher tous les attributs d’une clé-valeur.

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

Exemples

Afficher une valeur clé à l’aide du nom App Configuration avec une étiquette et une datetime spécifiques

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

Afficher une valeur clé à l’aide de chaîne de connexion avec étiquette

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

Affichez une valeur clé à l’aide de vos informations d’identification « az login ».

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

Paramètres obligatoires

--key

Clé à montrer.

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--datetime

Format : « YYYY-MM-DDThh:mm:ssZ ». Si aucun fuseau horaire n’est spécifié, utilisez UTC par défaut.

--endpoint

--label

Si aucune étiquette n’est spécifiée, affichez l’entrée avec une étiquette Null. Le filtrage n’est pas pris en charge.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az appconfig kv unlock

Modifier

Déverrouillez une valeur clé pour obtenir des opérations d’écriture.

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

Exemples

Déverrouillez une valeur clé à l’aide du nom App Configuration.

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

Forcer le déverrouillage d’une clé-valeur à l’aide de chaîne de connexion.

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

Paramètres obligatoires

--key

Clé à déverrouiller.

Paramètres facultatifs

--auth-mode

valeurs acceptées: key, login

valeur par défaut: key

--connection-string

--endpoint

--label

Si aucune étiquette n’est spécifiée, déverrouillez l’entrée avec une étiquette Null. Le filtrage n’est pas pris en charge.

--name -n

Nom de App Configuration. Vous pouvez configurer le nom par défaut à l’aide az configure --defaults app_configuration_store=<name>de .

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

Partager via

az appconfig kv

Commandes

az appconfig kv delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv export

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv import

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv list

Exemples

Paramètres facultatifs

az appconfig kv lock

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv restore

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv set

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv set-keyvault

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv show

Exemples

Paramètres obligatoires

Paramètres facultatifs

az appconfig kv unlock

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires

Ressources supplémentaires