az appconfig kv
Gestire i valori chiave archiviati in un archivio di Configurazione app.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az appconfig kv delete |
Eliminare i valori chiave. |
Core | GA |
| az appconfig kv export |
Esportare le configurazioni in un'altra posizione dall'archivio di Configurazione app. |
Core | GA |
| az appconfig kv import |
Importare configurazioni nell'archivio di Configurazione app da un'altra posizione. |
Core | GA |
| az appconfig kv list |
Elencare i valori chiave. |
Core | GA |
| az appconfig kv lock |
Bloccare un valore chiave per impedire operazioni di scrittura. |
Core | GA |
| az appconfig kv restore |
Ripristinare i valori chiave. |
Core | GA |
| az appconfig kv set |
Impostare un valore chiave. |
Core | GA |
| az appconfig kv set-keyvault |
Impostare un riferimento all'insieme di credenziali delle chiavi. |
Core | GA |
| az appconfig kv show |
Mostra tutti gli attributi di un valore chiave. |
Core | GA |
| az appconfig kv unlock |
Sbloccare un valore chiave per ottenere operazioni di scrittura. |
Core | GA |
az appconfig kv delete
Eliminare i valori chiave.
az appconfig kv delete --key
[--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--label]
[--name]
[--tags]
[--yes]
Esempio
Eliminare una chiave usando il nome dell'archivio di Configurazione app senza confermare.
az appconfig kv delete -n MyAppConfiguration --key color --label MyLabel --yes
Eliminare una chiave usando la 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 l'endpoint dell'archivio di Configurazione app.
az appconfig kv delete --endpoint https://myappconfiguration.azconfig.io --key color --auth-mode login --yes
Eliminare una chiave con nome chiave "color" e con tag "tag1=value1" e "tag2=value2".
az appconfig kv delete -n MyAppConfiguration --key color --tags tag1=value1 tag2=value2 --yes
Parametri necessari
Supportare il segno star come filtri, ad esempio * significa che tutte le chiavi e abc* significano chiavi con abc come prefisso.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
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.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Se non vengono specificati tag, eliminare tutti i valori chiave con tag. Supportare tag separati da spazi: key[=value] [key[=value] ...].
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv export
Esportare le configurazioni in un'altra posizione dall'archivio di 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]
[--dest-tags]
[--dry-run]
[--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]
[--tags]
[--yes]
Esempio
Esportare tutte le chiavi e i flag di funzionalità con il test dell'etichetta in un file JSON. Per usare lo schema di Gestione funzionalità Microsoft quando si esportano flag di funzionalità in un file, impostare la variabile di ambiente AZURE_APPCONFIG_FM_COMPATIBLE su False.
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 del 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 archivio di 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 altro archivio di 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 archivio di 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 archivio di Configurazione app da uno snapshot della configurazione di origine
az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --snapshot MySnapshot
Esportare tutte le chiavi e i flag di funzionalità con tag specifici in un altro archivio di Configurazione app.
az appconfig kv export -n MyAppConfiguration -d appconfig --tags tag1=value1 tag2=value2 --dest-name AnotherAppConfiguration
Esportare tutte le chiavi e i flag di funzionalità in un altro archivio di Configurazione app e applicare nuovi tag.
az appconfig kv export -n MyAppConfiguration -d appconfig --dest-name AnotherAppConfiguration --dest-tags newtag1=newvalue1
Visualizzare in anteprima il risultato dell'esportazione senza apportare modifiche all'archivio di Configurazione app.
az appconfig kv export -n MyAppConfiguration --label test -d file --path D:/abc.json --format json --dry-run
Parametri necessari
Destinazione dell'esportazione. Si noti che l'esportazione di flag di funzionalità nel servizio app non è supportata.
| Proprietà | Valore |
|---|---|
| Valori accettati: | appconfig, appservice, file |
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
ID ARM per AppService O il nome del servizio app, presupponendo che si tratti della stessa sottoscrizione e del gruppo di risorse dell'archivio di Configurazione app. Obbligatorio per gli argomenti di AppService.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppService Arguments |
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Modalità di autenticazione per la connessione all'archivio di Configurazione app di destinazione. Per informazioni dettagliate, vedere l'argomento "--auth-mode".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio di destinazione.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Se --dest-auth-mode è "login", specificare l'URL dell'endpoint dell'archivio di Configurazione app di destinazione.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Nome dell'archivio di Configurazione app di destinazione.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
I KV e i flag di funzionalità esportati verranno assegnati con questi tag. Se non vengono specificati tag, le KV e le funzionalità esportate manterranno i tag esistenti. Supportare tag separati da spazi: key[=value] [key[=value] ...]. Usare per cancellare i tag esistenti.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Visualizzare in anteprima il risultato dell'operazione di esportazione senza apportare modifiche all'archivio di Configurazione app.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Esportare i valori chiave come riferimenti a Configurazione app. Per altre informazioni, vedere https://learn.microsoft.com/en-us/azure/app-service/app-service-configuration-references.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppService Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
Esportazione del formato di file in. Obbligatorio per gli argomenti di file. Attualmente, i flag di funzionalità non sono supportati nel formato delle proprietà.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valori accettati: | json, properties, yaml |
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.
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 * indica tutte le etichette, abc* significa etichette con abc come prefisso e abc,xyz significa etichette con abc o xyz.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Convenzione di denominazione da usare per la sezione "Gestione funzionalità" del file. Esempio: pascal = FeatureManagement, camel = featureManagement, sottolineatura = feature_management, trattino = gestione delle funzionalità.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valore predefinito: | pascal |
| Valori accettati: | camel, hyphen, pascal, underscore |
Percorso del file di configurazione locale. Obbligatorio per gli argomenti di file.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
Prefisso da tagliare dalle chiavi. Il prefisso verrà ignorato per i flag di funzionalità.
Contrassegno per mantenere le etichette dall'origine AppConfig. Questo argomento non deve essere specificato insieme a --dest-label.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
Esportare il profilo da usare per esportare i valori chiave. Le opzioni 'depth', 'separator', 'naming-convention', 'prefix', 'dest-label' , 'dest-tags' e 'resolve-keyvault' non sono supportate quando si usa il profilo 'appconfig/kvset'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valore predefinito: | appconfig/default |
| Valori accettati: | appconfig/default, appconfig/kvset |
Risolvere il contenuto del riferimento all'insieme di credenziali delle chiavi.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
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: '.', ',', ';', '-', '_', '__', '/', ':'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
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.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
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.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
Esportare tutte le chiavi in un determinato snapshot dell'archivio di 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.
I valori chiave che contengono i tag specificati in AppConfig di origine verranno esportati. Se non vengono specificati tag, è possibile esportare tutti i valori chiave con tag. Supportare filtri di tag separati da spazi: key[=value] [key[=value] ...].
Non richiedere l'anteprima.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv import
Importare configurazioni nell'archivio di Configurazione app da un'altra posizione.
az appconfig kv import --source {aks, appconfig, appservice, file}
[--aks-cluster]
[--appservice-account]
[--auth-mode {key, login}]
[--configmap-name]
[--configmap-namespace]
[--connection-string]
[--content-type]
[--depth]
[--dry-run]
[--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]
[--src-tags]
[--strict {false, true}]
[--tags]
[--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 archivio di Configurazione app.
az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --label ImportedKeys
Importare tutte le chiavi da uno snapshot di un archivio di 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 del 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 archivio di 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 archivio di 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 archivio di 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
Importare tutte le chiavi e i flag di funzionalità con tag specifici da un archivio di Configurazione app e applicare nuovi tag.
az appconfig kv import -n MyAppConfiguration -s appconfig --src-name AnotherAppConfiguration --src-tags tag1=value1 tag2=value2 --tags newtag1=newvalue1
Importare tutte le chiavi e i flag di funzionalità da un file e applicare nuovi tag.
az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --tags tag1=value1
Visualizzare in anteprima il risultato dell'importazione senza apportare modifiche all'archivio di Configurazione app.
az appconfig kv import -n MyAppConfiguration -s file --path D:/abc.json --format json --dry-run
Parametri necessari
Origine dell'importazione. Si noti che l'importazione di flag di funzionalità dal servizio app non è supportata.
| Proprietà | Valore |
|---|---|
| Valori accettati: | aks, appconfig, appservice, file |
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
ID ARM per il servizio Azure Kubernetes O il nome del servizio Azure Kubernetes, presupponendo che si tratti dello stesso gruppo di risorse e sottoscrizione dell'archivio di Configurazione app. Obbligatorio per gli argomenti del servizio Azure Kubernetes.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AKS Arguments |
ID ARM per AppService O il nome del servizio app, presupponendo che si tratti della stessa sottoscrizione e del gruppo di risorse dell'archivio di Configurazione app. Obbligatorio per gli argomenti di AppService.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppService Arguments |
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Nome dell'oggetto ConfigMap. Obbligatorio per gli argomenti del servizio Azure Kubernetes.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AKS Arguments |
Spazio dei nomi di ConfigMap. per impostazione predefinita lo spazio dei nomi "default" se non specificato.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AKS Arguments |
| Valore predefinito: | default |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Tipo di contenuto di tutti gli elementi importati.
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à.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
Visualizzare in anteprima il risultato dell'operazione di importazione senza apportare modifiche all'archivio di Configurazione app.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Formato di file importato. Obbligatorio per gli argomenti di file. Attualmente, i flag di funzionalità non sono supportati nel formato delle proprietà.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valori accettati: | json, properties, yaml |
Se la modalità di importazione è "ignore-match", verranno scritti solo i valori chiave di origine che non esistono già o il cui valore, il tipo di contenuto o i tag sono diversi da quello di un valore chiave-valore esistente con la stessa chiave e etichetta. La modalità di importazione "all" scrive tutti i valori chiave nella destinazione indipendentemente dal fatto che esistano o meno.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | ignore-match |
| Valori accettati: | all, ignore-match |
Le KV importate e i flag di funzionalità verranno assegnati con questa etichetta. Se non viene specificata alcuna etichetta, assegnerà un'etichetta Null.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Percorso del file di configurazione locale. Obbligatorio per gli argomenti di file.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
Questo prefisso verrà aggiunto alla parte anteriore delle chiavi importate. Il prefisso verrà ignorato per i flag di funzionalità.
Contrassegno per mantenere le etichette dall'origine AppConfig. Questo argomento non deve essere specificato insieme a --label.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
Importare il profilo da usare per importare i valori chiave. Le opzioni 'depth', 'separator', 'content-type', 'label', 'skip-features', 'tags' e 'prefix' non sono supportate quando si usa il profilo 'appconfig/kvset'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valore predefinito: | appconfig/default |
| Valori accettati: | appconfig/default, appconfig/kvset |
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: '.', ',', ';', '-', '_', '__', '/', ':'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
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.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
Modalità di autenticazione per la connessione all'archivio di Configurazione app di origine. Per informazioni dettagliate, vedere l'argomento "--auth-mode".
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio di origine.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Se --src-auth-mode è "login", specificare l'URL dell'endpoint dell'archivio di Configurazione app di origine.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Nome dell'archivio di Configurazione app di origine.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Importare tutte le chiavi in un determinato snapshot dell'archivio di 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.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
I valori chiave che contengono i tag specificati nell'origine AppConfig verranno importati. Se non vengono specificati tag, è possibile importare tutti i valori chiave con tag. Supportare filtri di tag separati da spazi: key[=value] [key[=value] ...].
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | AppConfig Arguments |
Eliminare tutti gli altri valori chiave nell'archivio con il prefisso e l'etichetta specificati.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | File Arguments |
| Valore predefinito: | False |
| Valori accettati: | false, true |
I KV importati e i flag di funzionalità verranno assegnati con questi tag. Se non vengono specificati tag, le KV importate e i flag di funzionalità manterranno i tag esistenti. Supportare tag separati da spazi: key[=value] [key[=value] ...]. Usare per cancellare i tag esistenti.
Non richiedere l'anteprima.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv list
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]
[--tags]
[--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 la 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
Elencare tutti i valori chiave con tag specifici
az appconfig kv list -n MyAppConfiguration --tags tag1=value1 tag2=value2
Elencare tutti i valori chiave con il nome del tag "tag1" con valore vuoto
az appconfig kv list -n MyAppConfiguration --tags tag1=
Elencare tutti i valori chiave con il nome del tag "tag1" con valore Null
az appconfig kv list -n MyAppConfiguration --tags tag1=\0
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Elencare tutti gli elementi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Formato: "AAAA-MM-GGThh:mm:ss["Z"/±hh:mm]. Se non viene specificato alcun fuso orario o offset, usare UTC per impostazione predefinita.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Campi di output personalizzati separati da spazi.
| Proprietà | Valore |
|---|---|
| Valori accettati: | content_type, etag, key, label, last_modified, locked, tags, value |
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.
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.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
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.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
| Valori accettati: | false, true |
Elencare tutte le chiavi in un determinato snapshot dell'archivio di Configurazione app. Se non viene specificato alcun snapshot, vengono elencate le chiavi attualmente presenti nell'archivio.
Se non vengono specificati tag, restituire tutti i valori chiave con tag. Supportare tag separati da spazi: key[=value] [key[=value] ...].
Numero massimo di elementi da restituire. Deve essere un numero intero positivo. Il valore predefinito è 100.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv lock
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 il nome dell'archivio di Configurazione app.
az appconfig kv lock -n MyAppConfiguration --key color --label test
Forzare il blocco di un valore chiave usando la 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
Chiave da bloccare.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Se non è specificata alcuna etichetta, bloccare la voce con etichetta Null. Il filtro non è supportato.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv restore
Ripristinare i valori chiave.
az appconfig kv restore --datetime
[--auth-mode {key, login}]
[--connection-string]
[--dry-run]
[--endpoint]
[--key]
[--label]
[--name]
[--tags]
[--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 la 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"
Ripristinare tutti i valori chiave con tag specifici in un punto specifico nel tempo.
az appconfig kv restore -n MyAppConfiguration --tags tag1=value1 tag2=value2 --datetime "2019-05-01T11:24:12Z"
Visualizzare in anteprima il risultato del ripristino senza apportare modifiche all'archivio di Configurazione app.
az appconfig kv restore -n MyAppConfiguration --datetime "2019-05-01T11:24:12Z" --dry-run
Parametri necessari
Formato: "AAAA-MM-GGThh:mm:ss["Z"/±hh:mm]. Se non viene specificato alcun fuso orario o offset, usare UTC per impostazione predefinita.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Visualizzare in anteprima il risultato dell'operazione di ripristino senza apportare modifiche all'archivio di Configurazione app.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
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.
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.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Se non vengono specificati tag, ripristinare tutti i valori chiave con i tag. Supportare tag separati da spazi: key[=value] [key[=value] ...].
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv set
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 la 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
Chiave da impostare. La chiave non può essere '.' o '.', o contenere il carattere '%'.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Tipo di contenuto del valore chiave da impostare.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Se non è specificata alcuna etichetta, impostare la chiave con etichetta Null per impostazione predefinita.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Valore del valore della chiave da impostare.
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv set-keyvault
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 la 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
Chiave da impostare. La chiave non può essere '.' o '.', o contenere il carattere '%'.
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
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Se non è specificata alcuna etichetta, impostare la chiave con etichetta Null per impostazione predefinita.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv show
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 il nome dell'archivio di Configurazione app 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 la stringa di connessione con l'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
Chiave da mostrare.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Formato: "AAAA-MM-GGThh:mm:ss["Z"/±hh:mm]. Se non viene specificato alcun fuso orario o offset, usare UTC per impostazione predefinita.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Se non è specificata alcuna etichetta, visualizzare la voce con etichetta Null. Il filtro non è supportato.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az appconfig kv unlock
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 il nome dell'archivio di Configurazione app.
az appconfig kv unlock -n MyAppConfiguration --key color --label test
Forzare lo sblocco di un valore chiave usando la 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
Chiave da sbloccare.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare la stringa di connessione o il nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare il --endpoint o --name 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 altre informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | key |
| Valori accettati: | key, login |
Combinazione della chiave di accesso e dell'endpoint dell'archivio 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.
Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio di 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>.
Se non è specificata alcuna etichetta, sbloccare la voce con etichetta Null. Il filtro non è supportato.
Nome dell'archivio di Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |