az appconfig kv

Riferimento

Gestire i valori chiave archiviati in un Configurazione app.

Comandi

Nome	Descrizione	Tipo	Stato
az appconfig kv delete	Eliminare i valori chiave.	Memoria centrale	Disponibilità generale
az appconfig kv export	Esportare le configurazioni in un'altra posizione dal Configurazione app.	Memoria centrale	Disponibilità generale
az appconfig kv import	Importare le configurazioni nel Configurazione app da un'altra posizione.	Memoria centrale	Disponibilità generale
az appconfig kv list	Elencare i valori chiave.	Memoria centrale	Disponibilità generale
az appconfig kv lock	Bloccare un valore chiave per impedire operazioni di scrittura.	Memoria centrale	Disponibilità generale
az appconfig kv restore	Ripristinare i valori chiave.	Memoria centrale	Disponibilità generale
az appconfig kv set	Impostare un valore chiave.	Memoria centrale	Disponibilità generale
az appconfig kv set-keyvault	Impostare un riferimento all'insieme di credenziali delle chiavi.	Memoria centrale	Disponibilità generale
az appconfig kv show	Mostra tutti gli attributi di un valore chiave.	Memoria centrale	Disponibilità generale
az appconfig kv unlock	Sbloccare un valore chiave per ottenere operazioni di scrittura.	Memoria centrale	Disponibilità generale

az appconfig kv delete

Modifica

Eliminare i valori chiave.

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

Esempio

Eliminare una chiave usando Configurazione app nome senza conferma.

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

Eliminare una chiave usando stringa di connessione.

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

Eliminare una chiave usando le credenziali 'az login' e Configurazione app endpoint.

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

Parametri necessari

--key

Supportare il segno star come filtri, ad esempio * significa che tutte le chiavi e abc* significano chiavi con abc come prefisso.

Parametri facoltativi

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare l'endpoint dell'archivio o il nome dell'archivio e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

valori accettati: key, login

valore predefinito: key

--connection-string

Combinazione di chiave di accesso ed endpoint di Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint del Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--label

Se non è specificata alcuna etichetta, eliminare la voce con etichetta Null. Supportare il segno star come filtri, ad esempio * significa tutte le etichette e abc* significa etichette con abc come prefisso.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv export

Modifica

Esportare le configurazioni in un'altra posizione dal Configurazione app.

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]

Esempio

Esportare tutte le chiavi e i flag di funzionalità con il test dell'etichetta in un file JSON.

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

Esportare tutte le chiavi con etichetta Null in un'applicazione servizio app.

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

Esportare tutte le chiavi con test di etichetta escludendo i flag di funzionalità in un file JSON.

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

Esportare tutte le chiavi e i flag di funzionalità con tutte le etichette in un altro Configurazione app.

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

Esportare tutte le chiavi e i flag di funzionalità con tutte le etichette in un'altra Configurazione app e sovrascrivere le etichette di destinazione.

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

Esportare tutte le chiavi in un altro Configurazione app usando le credenziali '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

Esportare tutte le chiavi e i flag di funzionalità con il test dell'etichetta usando il profilo appconfig/kvset.

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

Esportare tutte le chiavi in un altro Configurazione app da uno snapshot della configurazione di origine

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

Parametri necessari

--destination -d

Destinazione dell'esportazione. Si noti che l'esportazione di flag di funzionalità nel servizio app non è supportata.

valori accettati: appconfig, appservice, file

Parametri facoltativi

--appservice-account

ID ARM per AppService O il nome del servizio app, presupponendo che si tratti della stessa sottoscrizione e del gruppo di risorse del Configurazione app. Obbligatorio per gli argomenti di AppService.

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--dest-auth-mode

Modalità di autenticazione per la connessione al Configurazione app di destinazione. Per informazioni dettagliate, vedere l'argomento "--auth-mode".

valori accettati: key, login

valore predefinito: key

--dest-connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio di destinazione.

--dest-endpoint

Se --dest-auth-mode è "login", specificare l'URL dell'endpoint del Configurazione app di destinazione.

--dest-label

Le KV esportate verranno etichettate con questa etichetta di destinazione. Se non viene specificata alcuna etichetta --dest-label né --preserve-labels, assegnerà un'etichetta Null.

--dest-name

Nome del Configurazione app di destinazione.

--endpoint

--export-as-reference -r

Anteprima

Esportare i valori chiave come riferimenti Configurazione app. Per ulteriori informazioni, vedere https://docs.microsoft.com/en-us/azure/app-service/app-service-configuration-references.

valori accettati: false, true

valore predefinito: False

--format

Esportazione del formato di file in. Obbligatorio per gli argomenti di file. Attualmente, i flag di funzionalità non sono supportati nel formato delle proprietà.

valori accettati: json, properties, yaml

--key

Se non è specificata alcuna chiave, restituire tutte le chiavi per impostazione predefinita. Supporto del segno star come filtri, ad esempio abc* significa chiavi con abc come prefisso. Filtro delle chiavi non applicabile per i flag di funzionalità. Per impostazione predefinita, verranno esportati tutti i flag di funzionalità con etichetta specificata.

--label

Verranno esportati solo chiavi e flag di funzionalità con questa etichetta. Se non è specificata alcuna etichetta, esportare chiavi e flag di funzionalità con etichetta Null per impostazione predefinita. Quando la destinazione di esportazione è appconfig o quando la destinazione di esportazione è file con appconfig/kvset profilo, questo argomento supporta asterisco e segni di virgola per il filtro delle etichette, ad esempio * significa tutte le etichette, abc* significa etichette con abc come prefisso e abc,xyz significa etichette con abc o xyz.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--naming-convention

Convenzione di denominazione da usare per la sezione "Gestione funzionalità" del file. Esempio: pascal = FeatureManagement, camel = featureManagement, sottolineatura = feature_management, trattino = gestione delle funzionalità.

valori accettati: camel, hyphen, pascal, underscore

valore predefinito: pascal

--path

Percorso del file di configurazione locale. Obbligatorio per gli argomenti di file.

--prefix

Prefisso da tagliare dalle chiavi. Il prefisso verrà ignorato per i flag di funzionalità.

--preserve-labels

Contrassegno per mantenere le etichette dall'origine AppConfig. Questo argomento non deve essere specificato insieme a --dest-label.

valori accettati: false, true

valore predefinito: False

--profile

Esportare il profilo da usare per esportare i valori chiave. Le opzioni 'depth', 'separator', 'naming-convention', 'prefix', 'dest-label' e 'resolve-keyvault' non sono supportate quando si usa il profilo 'appconfig/kvset'.

valori accettati: appconfig/default, appconfig/kvset

valore predefinito: appconfig/default

--resolve-keyvault

Risolvere il contenuto del riferimento all'insieme di credenziali delle chiavi.

valori accettati: false, true

valore predefinito: False

--separator

Delimitatore per rendere flat le coppie chiave-valore nel file json o yaml. Obbligatorio per l'esportazione della struttura gerarchica. Il separatore verrà ignorato per i file di proprietà e i flag di funzionalità. Valori supportati: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Esportare elementi esclusi tutti i flag di funzionalità. Per impostazione predefinita, tutte le funzionalità con l'etichetta specificata verranno esportate in file o appconfig. Non applicabile per il servizio app.

valori accettati: false, true

valore predefinito: False

--skip-keyvault

Esportare elementi esclusi tutti i riferimenti all'insieme di credenziali delle chiavi. Per impostazione predefinita, tutti i riferimenti all'insieme di credenziali delle chiavi con l'etichetta specificata verranno esportati.

valori accettati: false, true

valore predefinito: False

--snapshot

Esportare tutte le chiavi in un determinato snapshot dell'archivio Configurazione app. Se non viene specificato alcuno snapshot, le chiavi attualmente presenti nell'archivio vengono esportate in base ai filtri di chiave e etichetta specificati.

--yes -y

Non richiedere l'anteprima.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv import

Modifica

Importare le configurazioni nel Configurazione app da un'altra posizione.

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]

Esempio

Importare tutte le chiavi e i flag di funzionalità da un file e applicare un'etichetta di test.

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

Importare tutte le chiavi e i flag di funzionalità con etichetta Null e applicare una nuova etichetta da un Configurazione app.

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

Importare tutte le chiavi da uno snapshot di un Configurazione app.

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

Importare tutte le chiavi e applicare un'etichetta Null da un'applicazione servizio app.

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

Importare tutte le chiavi con test di etichetta e applicare l'etichetta test2 escludendo i flag di funzionalità da un Configurazione app.

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

Importare tutte le chiavi e i flag di funzionalità con tutte le etichette in un altro Configurazione app.

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

Importare tutte le chiavi e i flag di funzionalità da un file JSON e applicare il tipo di contenuto JSON.

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

Importare tutte le chiavi in un altro Configurazione app usando le credenziali '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

Importare tutte le chiavi e i flag di funzionalità da un file usando il formato appconfig/kvset.

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

Parametri necessari

--source -s

Origine dell'importazione. Si noti che l'importazione di flag di funzionalità dal servizio app non è supportata.

valori accettati: appconfig, appservice, file

Parametri facoltativi

--appservice-account

ID ARM per AppService O il nome del servizio app, presupponendo che si tratti della stessa sottoscrizione e del gruppo di risorse del Configurazione app. Obbligatorio per gli argomenti di AppService.

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--content-type

Tipo di contenuto di tutti gli elementi importati.

--depth

Profondità per rendere flat il file json o yaml in coppie chiave-valore. Appiattire il livello più profondo per impostazione predefinita se è specificato --separator. Non applicabile per i file di proprietà o i flag di funzionalità.

--endpoint

--format

Formato di file importato. Obbligatorio per gli argomenti di file. Attualmente, i flag di funzionalità non sono supportati nel formato delle proprietà.

valori accettati: json, properties, yaml

--import-mode

Se la modalità di importazione è "ignore-match", i valori di chiave di origine già esistenti nella destinazione non verranno sovrascritti. La modalità di importazione "all" scrive tutti i valori chiave nella destinazione indipendentemente dal fatto che esistano o meno.

valori accettati: all, ignore-match

valore predefinito: ignore-match

--label

Le KV importate e i flag di funzionalità verranno assegnati con questa etichetta. Se non viene specificata alcuna etichetta, assegnerà un'etichetta Null.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--path

Percorso del file di configurazione locale. Obbligatorio per gli argomenti di file.

--prefix

Questo prefisso verrà aggiunto alla parte anteriore delle chiavi importate. Il prefisso verrà ignorato per i flag di funzionalità.

--preserve-labels

Contrassegno per mantenere le etichette dall'origine AppConfig. Questo argomento non deve essere specificato insieme a --label.

valori accettati: false, true

valore predefinito: False

--profile

Importare il profilo da usare per importare i valori chiave. Le opzioni 'depth', 'separator', 'content-type', 'label', 'skip-features' e 'prefix' non sono supportate quando si usa il profilo 'appconfig/kvset'.

valori accettati: appconfig/default, appconfig/kvset

valore predefinito: appconfig/default

--separator

Delimitatore per rendere flat il file json o yaml in coppie chiave-valore. Il separatore verrà ignorato per i file di proprietà e i flag di funzionalità. Valori supportati: '.', ',', ';', '-', '_', '__', '/', ':'.

--skip-features

Importare solo i valori di chiave ed escludere tutti i flag di funzionalità. Per impostazione predefinita, tutti i flag di funzionalità verranno importati da file o appconfig. Non applicabile per il servizio app.

valori accettati: false, true

valore predefinito: False

--src-auth-mode

Modalità di autenticazione per la connessione al Configurazione app di origine. Per informazioni dettagliate, vedere l'argomento "--auth-mode".

valori accettati: key, login

valore predefinito: key

--src-connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio di origine.

--src-endpoint

Se --src-auth-mode è "login", specificare l'URL dell'endpoint del Configurazione app di origine.

--src-key

Se non è specificata alcuna chiave, importare tutte le chiavi per impostazione predefinita. Supporto del segno star come filtri, ad esempio abc* significa chiavi con abc come prefisso. Filtro delle chiavi non applicabile per i flag di funzionalità. Per impostazione predefinita, verranno importati tutti i flag di funzionalità con etichetta specificata.

--src-label

Verranno importate solo le chiavi con questa etichetta in AppConfig di origine. Se non è specificato alcun valore, importare le chiavi con etichetta Null per impostazione predefinita. Supportare il segno star come filtri, ad esempio * significa tutte le etichette, abc* significa etichette con abc come prefisso.

--src-name

Nome del Configurazione app di origine.

--src-snapshot

Importare tutte le chiavi in un determinato snapshot dell'archivio Configurazione app di origine. Se non viene specificato alcuno snapshot, le chiavi attualmente presenti nell'archivio vengono importate in base ai filtri di chiave e etichetta specificati.

--strict

Eliminare tutti gli altri valori chiave nell'archivio con il prefisso e l'etichetta specificati.

valori accettati: false, true

valore predefinito: False

--yes -y

Non richiedere l'anteprima.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv list

Modifica

Elencare i valori chiave.

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]

Esempio

Elencare tutti i valori chiave con etichetta Null.

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

Elencare una chiave specifica per qualsiasi etichetta che inizia con v1. utilizzando stringa di connessione.

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

Elencare tutte le chiavi con etichette ed eseguire query solo su chiave, valore e tag.

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"

Elencare il contenuto del riferimento dell'insieme di credenziali delle chiavi con il prefisso della chiave 'KVRef_' e selezionare solo chiave e valore.

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

Elencare i valori chiave con più etichette.

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

Elencare tutti i valori chiave con tutte le etichette usando le credenziali 'az login'.

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

Elencare tutti i valori chiave in un determinato snapshot dell'archivio di configurazione dell'app.

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

Parametri facoltativi

--all

Elencare tutti gli elementi.

valore predefinito: False

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--datetime

Formato: "AAAA-MM-GGThh:mm:ssZ". Se non è specificato alcun fuso orario, usare l'ora UTC per impostazione predefinita.

--endpoint

--fields

Campi di output personalizzati separati da spazi.

valori accettati: content_type, etag, key, label, last_modified, locked, tags, value

--key

Se non è specificata alcuna chiave, restituire tutte le chiavi per impostazione predefinita. Supporto del segno star come filtri, ad esempio abc* significa chiavi con abc come prefisso.

--label

Se non è specificata alcuna etichetta, elencare tutte le etichette. Supporto del segno star come filtri, ad esempio abc* significa etichette con abc come prefisso. Usare '\0' per l'etichetta Null.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--resolve-keyvault

Risolvere il contenuto del riferimento all'insieme di credenziali delle chiavi. Questo argomento non deve essere specificato insieme a --fields. Usare invece --query per una query personalizzata.

valori accettati: false, true

valore predefinito: False

--snapshot

Elencare tutte le chiavi in un determinato snapshot dell'archivio Configurazione app. Se non viene specificato alcun snapshot, vengono elencate le chiavi attualmente presenti nell'archivio.

--top -t

Numero massimo di elementi da restituire. Deve essere un intero positivo. Il valore predefinito è 100.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv lock

Modifica

Bloccare un valore chiave per impedire operazioni di scrittura.

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

Esempio

Bloccare un valore chiave usando Configurazione app nome.

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

Forzare il blocco di un valore chiave usando stringa di connessione.

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

Parametri necessari

--key

Chiave da bloccare.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--endpoint

--label

Se non è specificata alcuna etichetta, bloccare la voce con etichetta Null. Il filtro non è supportato.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv restore

Modifica

Ripristinare i valori chiave.

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

Esempio

Ripristinare tutti i valori chiave in un punto specifico nel tempo.

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

Ripristinare una chiave specifica per qualsiasi etichetta iniziare con v1. utilizzando stringa di connessione a un punto specifico nel tempo.

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"

Parametri necessari

--datetime

Formato: "AAAA-MM-GGThh:mm:ssZ". Se non è specificato alcun fuso orario, usare l'ora UTC per impostazione predefinita.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--endpoint

--key

Se non è specificata alcuna chiave, ripristinare tutte le chiavi per impostazione predefinita. Supporto del segno star come filtri, ad esempio abc* significa chiavi con abc come prefisso.

--label

Se non è specificata alcuna etichetta, ripristinare tutte le coppie chiave-valore con tutte le etichette. Supporto del segno star come filtri, ad esempio abc* significa etichette con abc come prefisso. Usare '\0' per l'etichetta Null.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv set

Modifica

Impostare un valore chiave.

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

Esempio

Impostare un valore chiave con l'etichetta MyLabel.

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

Impostare una chiave con etichetta Null usando stringa di connessione.

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

Impostare una chiave con valore stringa e tipo di contenuto JSON.

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

Impostare una chiave con il valore dell'elenco e il tipo di contenuto JSON.

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

Impostare una chiave con valore Null e tipo di contenuto JSON.

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

Impostare un valore chiave usando le credenziali 'az login'.

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

Parametri necessari

--key

Chiave da impostare. La chiave non può essere '.' o '.'o contenere il carattere '%'.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--content-type

Tipo di contenuto del keyvalue da impostare.

--endpoint

--label

Se non è specificata alcuna etichetta, impostare la chiave con etichetta Null per impostazione predefinita.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--value

Valore del keyvalue da impostare.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv set-keyvault

Modifica

Impostare un riferimento all'insieme di credenziali delle chiavi.

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

Esempio

Impostare un riferimento all'insieme di credenziali delle chiavi con l'etichetta MyLabel.

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

Impostare un riferimento keyvault con etichetta Null e più tag usando stringa di connessione.

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

Parametri necessari

--key

Chiave da impostare. La chiave non può essere '.' o '.'o contenere il carattere '%'.

--secret-identifier

ID dell'oggetto Key Vault. È possibile trovare il file usando il comando 'az keyvault {collection} show', dove la raccolta è chiave, segreto o certificato. Per impostare il riferimento alla versione più recente del segreto, rimuovere le informazioni sulla versione dall'identificatore del segreto.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--endpoint

--label

Se non è specificata alcuna etichetta, impostare la chiave con etichetta Null per impostazione predefinita.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv show

Modifica

Mostra tutti gli attributi di un valore chiave.

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

Esempio

Visualizzare un valore chiave usando Configurazione app nome con un'etichetta e un valore datetime specifici

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

Visualizzare un valore chiave usando stringa di connessione con etichetta

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

Visualizzare un valore chiave usando le credenziali 'az login'.

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

Parametri necessari

--key

Chiave da mostrare.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--datetime

Formato: "AAAA-MM-GGThh:mm:ssZ". Se non è specificato alcun fuso orario, usare l'ora UTC per impostazione predefinita.

--endpoint

--label

Se non è specificata alcuna etichetta, visualizzare la voce con etichetta Null. Il filtro non è supportato.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az appconfig kv unlock

Modifica

Sbloccare un valore chiave per ottenere operazioni di scrittura.

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

Esempio

Sbloccare un valore chiave usando Configurazione app nome.

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

Forzare lo sblocco di un valore chiave usando stringa di connessione.

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

Parametri necessari

--key

Chiave da sbloccare.

Parametri facoltativi

--auth-mode

valori accettati: key, login

valore predefinito: key

--connection-string

--endpoint

--label

Se non è specificata alcuna etichetta, sbloccare la voce con etichetta Null. Il filtro non è supportato.

--name -n

Nome del Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Share via

az appconfig kv

Comandi

az appconfig kv delete

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv export

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv import

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv list

Esempio

Parametri facoltativi

az appconfig kv lock

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv restore

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv set

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv set-keyvault

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv show

Esempio

Parametri necessari

Parametri facoltativi

az appconfig kv unlock

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti

Risorse aggiuntive