Configuratiegegevens importeren of exporteren

Azure-app Configuration ondersteunt bewerkingen voor het importeren en exporteren van gegevens. Gebruik deze bewerkingen om bulksgewijs met configuratiegegevens te werken en gegevens uit te wisselen tussen uw App Configuration-archief en codeproject. U kunt bijvoorbeeld één App Configuration-archief instellen voor testen en een andere voor productie. U kunt toepassingsinstellingen ertussen kopiëren, zodat u geen gegevens tweemaal hoeft in te voeren.

Dit artikel bevat een handleiding voor het importeren en exporteren van gegevens met behulp van Azure Portal of de Azure CLI. Als u Configuratie hebt aangenomen als code en uw configuraties in GitHub of Azure Devops hebt beheerd, kunt u doorlopende configuratiebestanden importeren met behulp van GitHub Actions of de Push-taak van Azure Pipeline gebruiken.

Gegevens importeren

Importeren brengt configuratiegegevens naar een App Configuration-archief van een bestaande bron. Gebruik de importfunctie om gegevens te migreren naar een App Configuration-archief of om gegevens uit meerdere bronnen samen te voegen.

Deze handleiding laat zien hoe u App Configuration-gegevens importeert:

• van een configuratiebestand in Json, Yaml of Eigenschappen
• vanuit een App Configuration-archief
• van Azure-app Service

Gegevens importeren uit een configuratiebestand

Volg de onderstaande stappen om sleutelwaarden uit een bestand te importeren.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

1. Navigeer naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Het keuzerondje Importeren is standaard geselecteerd. Selecteer onder Brontype het configuratiebestand.

3. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Bestandstype	Selecteer het bestandstype voor importeren: YAML, Eigenschappen of JSON.	Json

4. Klik op de knop Bladeren en selecteer het bestand dat u wilt importeren.

5. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Profiel voor bestandsinhoud	Selecteer een inhoudsprofiel: Standaard of KVSet. Het standaardbestandsinhoudsprofiel verwijst naar het conventionele configuratiebestandsschema dat veel wordt gebruikt door bestaande programmeerframeworks of systemen, ondersteunt JSON-, Yaml- of Eigenschappen-bestandsindelingen. Het KVSet-bestandsinhoudsprofiel verwijst naar een bestandsschema dat alle eigenschappen van een App Configuration-sleutelwaarde bevat, waaronder sleutel, waarde, label, inhoudstype en tags.	Standaard
   Modus Importeren	De importmodus wordt gebruikt om te bepalen of identieke sleutelwaarden moeten worden genegeerd. Met de optie Overeenkomst negeren worden alle sleutelwaarden in het archief genegeerd die hetzelfde zijn als die in het configuratiebestand. Met de optie Alles worden alle sleutelwaarden in het configuratiebestand bijgewerkt.	Overeenkomst negeren
   Functievlag uitsluiten	Indien ingeschakeld, worden functievlagmen niet geïmporteerd.	Niet ingeschakeld
   Strikt	Als het selectievakje is ingeschakeld, worden alle sleutelwaarden in het archief met het opgegeven voorvoegsel en label dat niet in het configuratiebestand is opgenomen, verwijderd wanneer het profiel voor bestandsinhoud is ingesteld op Standaard. Wanneer het profiel voor bestandsinhoud is ingesteld op KVSet, worden alle sleutelwaarden in het archief verwijderd die niet zijn opgenomen in het configuratiebestand. Als het selectievakje is uitgeschakeld, worden er geen sleutelwaarden in het archief verwijderd.	Niet ingeschakeld
   Scheidingsteken	Het scheidingsteken is het scheidingsteken dat wordt gebruikt voor het platmaken van JSON- of YAML-bestanden in sleutelwaarde. Deze wordt genegeerd voor eigenschapsbestanden en functievlagmen. Ondersteunde waarden zijn onder andere scheidingstekens, punt (.), komma (,), puntkomma (;), afbreekstreepje (-), onderstrepingsteken (_), dubbele onderstrepingsteken (__), slash (/) en dubbele punt (:)).	:
   Diepte	Optioneel. De diepte voor het platmaken van JSON- of YAML-bestanden in sleutel-waardeparen. Bestanden worden standaard afgevlakt tot het hoogste niveau als er een scheidingsteken is geselecteerd. Deze instelling is niet van toepassing op eigenschapsbestanden of functievlagmen.
   Voorvoegsel toevoegen	Optioneel. Indien opgegeven, wordt er een voorvoegsel toegevoegd aan de sleutelnamen van alle geïmporteerde sleutelwaarden.	TestApp:
   Label toevoegen	Optioneel. Indien opgegeven, wordt het opgegeven label toegewezen aan alle geïmporteerde sleutelwaarden.	prikkelen
   Inhoudstype toevoegen	Optioneel. Indien opgegeven, wordt het opgegeven inhoudstype toegevoegd aan alle geïmporteerde sleutelwaarden.	JSON (application/json)
   Tags toevoegen	Optioneel. Indien opgegeven, worden de opgegeven tags toegevoegd aan alle geïmporteerde sleutelwaarden.	{tag: tag1}

6. Selecteer Toepassen om door te gaan met het importeren.

U hebt sleutelwaarden geïmporteerd uit een JSON-bestand. De sleutelnamen zijn afgevlakt met behulp van het : scheidingsteken en voorafgegaan door TestApp:. Alle geïmporteerde sleutelwaarden worden gelabeld als prod, met een inhoudstype van application/jsonen getagd met tag: tag1.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de importopdracht az appconfig kv import in en voeg de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief waarnaar u gegevens wilt importeren.	my-app-config-store
   --source	Voer dit file in om aan te geven dat u app-configuratiegegevens uit een bestand importeert.	file
   --path	Voer het lokale pad in naar het bestand met de gegevens die u wilt importeren.	C:/Users/john/Downloads/data.json
   --format	Voer yaml, eigenschappen of json in om de indeling aan te geven van het bestand dat u importeert.	json

2. Voeg eventueel ook de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --separator	Optioneel. Het scheidingsteken is het scheidingsteken voor het platmaken van de sleutelwaarden in Json/Yaml. Het is vereist voor het exporteren van hiërarchische structuur en wordt genegeerd voor eigenschapsbestanden en functievlagmen. Selecteer een van de volgende opties: ., , :,, ;, /, , -, _. —	;
   --prefix	Optioneel. Een sleutelvoorvoegsel is het begingedeelte van een sleutel. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Dit voorvoegsel wordt toegevoegd aan de voorzijde van de eigenschap 'sleutel' van elke geïmporteerde sleutelwaarde.	TestApp:
   --label	Optioneel. Voer een label in dat wordt toegewezen aan uw geïmporteerde sleutelwaarden.	prod
   --content-type	Optioneel. Voer in appconfig/kvset of application/json om aan te geven dat de geïmporteerde inhoud bestaat uit een Key Vault-verwijzing of een JSON-bestand.	application/json

   Voorbeeld: importeer alle sleutelwaarden en functievlagmen uit een JSON-bestand, pas het label prod toe en voeg het voorvoegsel TestApp toe. Voeg het inhoudstype 'application/json' toe.

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. Op de opdrachtregel wordt een lijst met de komende wijzigingen weergegeven. Bevestig het importeren door te yselecteren.

   

U hebt sleutelwaarden geïmporteerd uit een JSON-bestand en het label prod en het voorvoegsel TestApp:toegewezen. Het scheidingsteken ';' wordt gebruikt en alle sleutelwaarden die u hebt geïmporteerd, hebben inhoudstypen ingesteld als JSON.

Ga naar az appconfig kv import voor meer optionele parameters en voorbeelden.

Gegevens importeren uit een App Configuration-archief

U kunt waarden uit het ene App Configuration-archief importeren naar een ander App Configuration-archief of u kunt waarden uit het ene App Configuration-archief importeren in hetzelfde App Configuration-archief om de waarden te dupliceren en verschillende parameters toe te passen, zoals een nieuw label of inhoudstype.

Volg de onderstaande stappen om sleutelwaarden en functievlagmen te importeren uit een Azure-app Configuratiearchief.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

1. Navigeer naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Het keuzerondje Importeren is standaard geselecteerd. Selecteer App Configuration onder Brontype.

3. Selecteer een App Configuration-archief waaruit u gegevens wilt importeren en vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Abonnement	Uw huidige abonnement is standaard geselecteerd.	mijn abonnement
   Resourcegroep	Selecteer een resourcegroep die het App Configuration-archief bevat met de configuratie die u wilt importeren. Uw huidige resourcegroep is standaard geselecteerd.	my-resource-group
   Bron	Selecteer het App Configuration-archief dat de configuratie bevat die u wilt importeren.	my-other-app-config-store

4. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Selectiemodus	Selecteer of u wilt importeren uit normale sleutelwaarden, wat de standaardoptie is of vanuit een momentopname.	Standaard
   Sleutelfilter	Wordt gebruikt om sleutelwaarden te filteren op basis van de sleutelnaam voor importeren. Als er geen sleutels zijn opgegeven, komen alle sleutels in aanmerking.	Begint met testen
   Op een bepaald tijdstip	Optioneel. Vul dit veld in om sleutelwaarden te importeren vanaf een bepaald tijdstip in het geselecteerde configuratiearchief. Als deze waarde leeg blijft, wordt het standaard ingesteld op het huidige tijdstip van de sleutelwaarden.	28-07-2022 12:00:00 uur
   Van label	Selecteer een of meer labels om sleutelwaarden te importeren die aan deze labels zijn gekoppeld. Als er geen label is geselecteerd, komen alle labels in aanmerking.	prikkelen
   Functievlag uitsluiten	Indien ingeschakeld, worden functievlagmen niet geïmporteerd.	Niet ingeschakeld
   Voorvoegsel toevoegen	Optioneel. Indien opgegeven, wordt er een voorvoegsel toegevoegd aan de sleutelnamen van alle geïmporteerde sleutelwaarden.	TestApp:
   Labels overschrijven	Optioneel. Standaard blijven de oorspronkelijke labels van de bronsleutelwaarden behouden. Als u deze wilt overschrijven, schakelt u het selectievakje in en voert u een nieuw label in voor geïmporteerde sleutelwaarden.	Nieuw
   Inhoudstypen overschrijven	Optioneel. Standaard blijven de oorspronkelijke inhoudstypen van de bronsleutelwaarden behouden. Als u deze wilt overschrijven, schakelt u het selectievakje in en voert u een nieuw inhoudstype in voor geïmporteerde sleutelwaarden. Houd er rekening mee dat het inhoudstype van functievlagmen niet kan worden overschreven.	JSON (application/json)

5. Selecteer Toepassen om door te gaan met het importeren.

U hebt sleutelwaarden geïmporteerd uit een App Configuration-archief vanaf 28 januari 2021 om 12:00 uur, met sleutelnamen die beginnen met test en het label prod. De sleutelnamen zijn voorafgegaan door TestApp:. Aan alle geïmporteerde sleutelwaarden is het label new en het inhoudstype application/jsontoegewezen.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de importopdracht az appconfig kv import in en voer de volgende parameters in:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief waarnaar u gegevens wilt importeren	my-app-config-store
   --source	Voer in appconfig om aan te geven dat u gegevens importeert uit een App Configuration-archief.	appconfig
   --src-name	Voer de naam in van het App Configuration-archief waaruit u gegevens wilt importeren.	my-source-app-config
   --src-label	Beperk uw import naar sleutelwaarden met een specifiek label. Als u deze parameter niet gebruikt, worden alleen sleutelwaarden met een null-label geïmporteerd. Ondersteunt sterteken als filter: voer dit * in voor alle labels; abc* voor alle labels met abc als voorvoegsel.	prod

2. Voeg eventueel de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --label	Optioneel. Voer een label in dat wordt toegewezen aan uw geïmporteerde sleutelwaarden.	new
   --content-type	Optioneel. Voer in appconfig/kvset of application/json om aan te geven dat de geïmporteerde inhoud bestaat uit een Key Vault-verwijzing of een JSON-bestand. Inhoudstype kan alleen worden overschreven voor geïmporteerde sleutelwaarden. Standaardinhoudstype voor functievlagmen is 'application/vnd.microsoft.appconfig.ff+json; charset=utf-8' standaard en wordt niet bijgewerkt door deze parameter.	application/json

   Voorbeeld: sleutelwaarden en functievlagmen importeren met het label 'prod' uit een andere app-configuratie en deze toewijzen aan het label 'nieuw'. Voeg het inhoudstype 'application/json' toe.

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. Op de opdrachtregel wordt een lijst met de komende wijzigingen weergegeven. Bevestig het importeren door te yselecteren.

   

U hebt sleutelwaarden geïmporteerd met het label 'prod' uit een App Configuration-archief en het label 'nieuw' toegewezen. Alle sleutelwaarden die u hebt geïmporteerd, zijn ingesteld als 'JSON'.

Ga naar az appconfig kv import voor meer optionele parameters en voorbeelden.

Gegevens importeren uit Azure-app Service

Volg de onderstaande stappen om sleutelwaarden te importeren uit Azure-app Service.

Notitie

App Service biedt momenteel geen ondersteuning voor functievlagmen. Alle functievlagmen die in App Service worden geïmporteerd, worden automatisch geconverteerd naar sleutelwaarden. Uw App Service-resources kunnen alleen sleutelwaarden bevatten.

Portal

Vanuit de Azure-portal:

1. Navigeer naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Het keuzerondje Importeren is standaard geselecteerd. Selecteer App Services onder Brontype.

3. Selecteer een App Configuration-archief waaruit u gegevens wilt importeren en vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Abonnement	Uw huidige abonnement is standaard geselecteerd.	mijn abonnement
   Resourcegroep	Selecteer een resourcegroep die de App Service bevat met de configuratie die u wilt importeren.	my-resource-group
   Bron	Selecteer de App Service die de configuratie bevat die u wilt importeren.	my-app-service

4. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Instellingen bijwerken om naar te verwijzen	Indien ingeschakeld, worden de app-instellingen in App Service bijgewerkt naar App Configuration-verwijzingen voor de geïmporteerde sleutelwaarden. Hiermee kunt u uw app-instellingen in App Configuration in de toekomst beheren. Uw App Service haalt automatisch de huidige waarde op uit App Configuration. Zie App Configuration-verwijzingen gebruiken voor App Service en Azure Functions voor meer informatie.	Gecontroleerd
   Voorvoegsel toevoegen	Optioneel. Indien opgegeven, wordt er een voorvoegsel toegevoegd aan de sleutelnamen van alle geïmporteerde sleutelwaarden.	TestApp:
   Label toevoegen	Optioneel. Indien opgegeven, wordt het opgegeven label toegewezen aan alle geïmporteerde sleutelwaarden.	prikkelen
   Inhoudstype toevoegen	Optioneel. Indien opgegeven, wordt het opgegeven inhoudstype toegevoegd aan alle geïmporteerde sleutelwaarden.	JSON (application/json)

5. Selecteer Toepassen om door te gaan met het importeren.

U hebt alle toepassingsinstellingen uit een App Service geïmporteerd als sleutelwaarden en het label prod en het voorvoegsel TestApp:toegewezen. Alle sleutelwaarden die u hebt geïmporteerd, zijn ingesteld als application/jsoninhoudstype.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de importopdracht az appconfig kv import in en voeg de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief waarnaar u gegevens wilt importeren.	my-app-config-store
   --source	Voer in appservice om aan te geven dat u app-configuratiegegevens importeert uit Azure-app Service.	appservice
   --appservice-account	Voer de ARM-id van de App Service in of gebruik de naam van de App Service als deze zich in hetzelfde abonnement en dezelfde resourcegroep bevindt als de App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service of my-app-service

2. Voeg eventueel ook de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --prefix	Optioneel. Een sleutelvoorvoegsel is het begingedeelte van de eigenschap sleutelwaarde. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Dit voorvoegsel wordt toegevoegd aan de voorzijde van de eigenschap 'sleutel' van elke geïmporteerde sleutelwaarde.	TestApp:
   --label	Optioneel. Voer een label in dat wordt toegewezen aan uw geïmporteerde sleutelwaarden. Als u geen label opgeeft, wordt het null-label toegewezen aan uw sleutelwaarden.	prod
   --content-type	Optioneel. Voer appconfig/kvset of application/json in om aan te geven dat de geïmporteerde inhoud bestaat uit een Key Vault-verwijzing of een JSON-bestand.	application/json

   Gebruik de opdracht az webapp show --resource-group <resource-group> --name <resource-name>om de waarde voor --appservice-accountop te halen.

   Voorbeeld: importeer alle toepassingsinstellingen uit uw App Service als sleutelwaarden met het label 'prod', naar uw App Configuration-archief en voeg een voorvoegsel 'TestApp:' toe.

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. Op de opdrachtregel wordt een lijst met de komende wijzigingen weergegeven. Bevestig het importeren door te yselecteren.

   

U hebt alle toepassingsinstellingen uit uw App Service geïmporteerd als sleutelwaarden, het label prod toegewezen en een voorvoegsel 'TestApp:' toegevoegd. Alle sleutelwaarden die u hebt geïmporteerd, hebben het inhoudstype ingesteld op JSON.

Ga naar az appconfig kv import voor meer optionele parameters en voorbeelden.

Gegevens exporteren

Exporteer schrijfconfiguratiegegevens die zijn opgeslagen in App Configuration naar een andere bestemming. Gebruik de exportfunctie bijvoorbeeld om gegevens uit een App Configuration-archief op te slaan in een bestand dat tijdens de implementatie kan worden ingesloten in uw toepassingscode.

In deze handleiding ziet u hoe u App Configuration-gegevens exporteert:

• naar een configuratiebestand in Json, Yaml of Eigenschappen
• naar een App Configuration-archief
• naar een Azure-app Service-resource

Gegevens exporteren naar een configuratiebestand

Volg deze stappen om configuratiegegevens uit een App Configuration-archief te exporteren naar een JSON-, YAML- of Eigenschappenbestand.

Portal

Voer vanuit Azure Portal de volgende stappen uit:

1. Navigeer naar uw App Configuration-archief en selecteer Importeren/exporteren.

   

2. Selecteer het keuzerondje Exporteren en selecteer onder Doeltype het configuratiebestand.

3. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Bestandstype	Selecteer het bestandstype voor export: YAML, Eigenschappen of JSON.	JSON
   Profiel voor bestandsinhoud	Selecteer een inhoudsprofiel: Standaard of KVSet. Het standaardbestandsinhoudsprofiel verwijst naar het conventionele configuratiebestandsschema dat veel wordt gebruikt door bestaande programmeerframeworks of systemen, ondersteunt JSON-, Yaml- of Eigenschappen-bestandsindelingen. Het KVSet-bestandsinhoudsprofiel verwijst naar een bestandsschema dat alle eigenschappen van een App Configuration-sleutelwaarde bevat, waaronder sleutel, waarde, label, inhoudstype en tags.	Standaard
   Selectiemodus	Selecteer of u wilt exporteren uit normale sleutelwaarden, wat de standaardoptie is of vanuit een momentopname.	Standaard
   Sleutelfilter	Wordt gebruikt om sleutelwaarden te filteren op basis van de sleutelnaam voor export. Als er geen sleutels zijn opgegeven, komen alle sleutels in aanmerking.	Begint met TestApp:
   Op een bepaald tijdstip	Optioneel. Vul dit veld in om sleutelwaarden te exporteren vanaf een bepaald tijdstip in het geselecteerde configuratiearchief. Als deze waarde leeg blijft, wordt het standaard ingesteld op het huidige tijdstip van de sleutelwaarden.	28-07-2022 12:00:00 uur
   Van label	Selecteer het label om sleutelwaarden te exporteren die aan deze labels zijn gekoppeld. Als er geen label is geselecteerd, komen alle labels in aanmerking. Houd er rekening mee dat u slechts één label kunt selecteren bij het exporteren met het Default bestandsinhoudsprofiel. Als u sleutelwaarden met meer dan één label wilt exporteren, gebruikt u het KVSet profiel voor bestandsinhoud.	prikkelen
   Voorvoegsel verwijderen	Optioneel. Indien opgegeven, wordt het voorvoegsel verwijderd uit de sleutelnamen van alle geëxporteerde sleutelwaarden die het bevatten.	TestApp:
   Scheidingsteken	Het scheidingsteken is het scheidingsteken dat wordt gebruikt voor het segmenteren van sleutelnamen en het reconstrueren van hiërarchische configuraties voor JSON- of YAML-bestanden uit sleutelwaarden. Deze wordt genegeerd voor eigenschapsbestanden en functievlagmen. Ondersteunde waarden omvatten geen scheidingsteken, punt (.), komma (,), puntkomma (;), afbreekstreepje (-), onderstrepingsteken (_), dubbele onderstrepingsteken (__), slash (/) en dubbele punt (:)).	:

4. Selecteer Exporteren om de export te voltooien.

U hebt sleutelwaarden geëxporteerd uit een App Configuration-archief vanaf 28 juli 2021 om 12:00 uur, met sleutelnamen die beginnen met TestApp: en het label prod, naar een JSON-bestand. Het voorvoegsel TestApp: is afgekapt van sleutelnamen en het scheidingsteken is gebruikt om de sleutelnamen te segmenteren : en de hiërarchische JSON-indeling te reconstrueren.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de exportopdracht az appconfig kv export in en voeg de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief met de sleutelwaarden die u wilt exporteren.	my-app-config-store
   --destination	Voer in file om aan te geven dat u gegevens naar een bestand exporteert.	file
   --path	Voer het pad in waar u het bestand wilt opslaan.	C:/Users/john/Downloads/data.json
   --format	Voer yamlde properties indeling in van het bestand dat u wilt exporteren.json	json
   --label	Voer een label in om sleutelwaarden en functievlagmen met dit label te exporteren. Als u geen label opgeeft, exporteert u standaard alleen sleutelwaarden en functievlagmen zonder label. U kunt één label invoeren, meerdere labels invoeren door ze te scheiden met ,of te gebruiken * om rekening te houden met alle labels.	prod

   Belangrijk

   Als u geen label selecteert, worden alleen sleutelwaarden zonder labels geëxporteerd. Als u een sleutelwaarde met een label wilt exporteren, moet u het label selecteren.

2. Voeg eventueel ook de volgende parameters toe:

   Parameter	Description	Voorbeeld
   --separator	Optioneel. Het scheidingsteken is het scheidingsteken voor het platmaken van de sleutelwaarden in Json/Yaml. Het is vereist voor het exporteren van hiërarchische structuur en wordt genegeerd voor eigenschapsbestanden en functievlagmen. Selecteer een van de volgende opties: ., , :,, ;, /, , -, _. —	;
   --prefix	Optioneel. Voorvoegsel dat moet worden bijgesneden van de eigenschap 'sleutel' van elke sleutelwaarde. Een sleutelvoorvoegsel is het begingedeelte van een sleutel. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Het voorvoegsel wordt genegeerd voor functievlagmen.	TestApp:

   Voorbeeld: alle sleutelwaarden en functievlagmen met label prod exporteren naar een JSON-bestand.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. Op de opdrachtregel wordt een lijst met sleutelwaarden weergegeven die naar het bestand worden geëxporteerd. Bevestig de export door te yselecteren.

   

U hebt sleutelwaarden en functievlagmen met het label prod geëxporteerd naar een configuratiebestand en het voorvoegsel TestApp bijgesneden. Waarden worden gescheiden door ';' in het bestand.

Ga naar az appconfig kv export voor meer optionele parameters en voorbeelden.

Gegevens exporteren naar een App Configuration-archief

Volg de onderstaande stappen om sleutelwaarden en functievlagmen te exporteren naar een Azure-app Configuratiearchief.

U kunt waarden exporteren uit het ene App Configuration-archief naar een ander App Configuration-archief of u kunt waarden exporteren uit het ene App Configuration-archief naar hetzelfde App Configuration-archief om de waarden te dupliceren en verschillende parameters toe te passen, zoals een nieuw label of inhoudstype.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

1. Navigeer naar uw App Configuration-archief met de gegevens die u wilt exporteren en selecteer Importeren/exporteren in het menu Bewerkingen .

   

2. Selecteer het keuzerondje Exporteren en selecteer onder Doeltype de optie App Configuration.

3. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Selectiemodus	Selecteer of u wilt exporteren uit normale sleutelwaarden, wat de standaardoptie is of vanuit een momentopname.	Standaard
   Sleutelfilter	Wordt gebruikt om sleutelwaarden te filteren op basis van de sleutelnaam voor export. Als er geen sleutels zijn opgegeven, komen alle sleutels in aanmerking.	Begint met TestApp:
   Op een bepaald tijdstip	Optioneel. Vul dit veld in om sleutelwaarden te exporteren vanaf een bepaald tijdstip in het geselecteerde configuratiearchief. Als deze waarde leeg blijft, wordt het standaard ingesteld op het huidige tijdstip van de sleutelwaarden.	28-07-2022 12:00:00 uur
   Van label	Selecteer een of meer labels om sleutelwaarden te exporteren die aan deze labels zijn gekoppeld. Als er geen label is geselecteerd, komen alle labels in aanmerking.	prikkelen
   Functievlag uitsluiten	Indien ingeschakeld, worden functievlagmen niet geëxporteerd.	Niet ingeschakeld

4. Selecteer het doelarchief en vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Abonnement	Uw huidige abonnement is standaard geselecteerd.	mijn abonnement
   Resourcegroep	Selecteer een resourcegroep die het App Configuration-archief bevat waar u de configuratie wilt exporteren. Uw huidige resourcegroep is standaard geselecteerd.	my-resource-group
   Bron	Selecteer het App Configuration-archief waar u de configuratie wilt exporteren.	my-other-app-config-store

5. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Voorvoegsel verwijderen	Optioneel. Indien opgegeven, wordt het voorvoegsel verwijderd uit de sleutelnamen van alle geëxporteerde sleutelwaarden die het bevatten.	TestApp:
   Labels overschrijven	Optioneel. Standaard blijven de oorspronkelijke labels van de bronsleutelwaarden behouden. Als u deze wilt overschrijven, schakelt u het selectievakje in en voert u een nieuw label in voor geëxporteerde sleutelwaarden.	Nieuw
   Inhoudstypen overschrijven	Optioneel. Standaard blijven de oorspronkelijke inhoudstypen van de bronsleutelwaarden behouden. Als u deze wilt overschrijven, schakelt u het selectievakje in en voert u een nieuw inhoudstype in voor geëxporteerde sleutelwaarden. Houd er rekening mee dat het inhoudstype van functievlagmen niet kan worden overschreven.	JSON (application/json)

6. Selecteer Toepassen om door te gaan met de export.

U hebt vanaf 28 juli 2022 sleutelwaarden geëxporteerd uit een App Configuration-archief, om 12:00 uur, met sleutelnamen die beginnen met TestApp: en het label prod, naar een ander App Configuration-archief. Alle geëxporteerde sleutelwaarden zijn ingekort het sleutelvoorvoegsel TestApp:en het label new en het inhoudstype application/jsontoegewezen.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de exportopdracht az appconfig kv export in en voer de volgende parameters in:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief met de sleutelwaarden die u wilt exporteren.	my-app-config-store
   --destination	Voer dit appconfig in om aan te geven dat u gegevens exporteert naar een App Configuration-archief.	appconfig
   --dest-name	Voer de naam in van het App Configuration-archief waarnaar u gegevens wilt exporteren.	my-other-app-config-store
   --label	Voer een label in om sleutelwaarden en functievlagmen met dit label te exporteren. Als u geen label opgeeft, exporteert u standaard alleen sleutelwaarden en functievlagmen zonder label. U kunt één label invoeren, meerdere labels invoeren door ze te scheiden met ,, of te gebruiken * om alle labels in rekening te nemen.	prod

   Belangrijk

   Als de sleutelwaarden die u wilt exporteren labels hebben, moet u de opdracht --label gebruiken en de bijbehorende labels invoeren. Als u geen label selecteert, worden alleen sleutelwaarden zonder labels geëxporteerd. Gebruik een kommateken (,) om meerdere labels te selecteren of om * alle labels op te nemen, inclusief het null-label (geen label).

2. Voeg eventueel ook de volgende parameter toe:

   Parameter	Description	Voorbeeld
   --dest-label	Optioneel. Voer een doellabel in om dit label toe te wijzen aan geëxporteerde sleutelwaarden.	new

   Voorbeeld: exporteer sleutelwaarden en functievlagmen met het label 'prod' naar een ander App Configuration-archief en voeg het doellabel 'nieuw' toe.

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. De opdrachtregel geeft een lijst weer met sleutelwaarden die naar de bestanden worden geëxporteerd. Bevestig de export door te yselecteren.

   

U hebt sleutelwaarden en functievlagmen geëxporteerd met het label 'prod' uit een App Configuration-archief en het label 'nieuw' toegewezen.

Ga naar az appconfig kv import voor meer optionele parameters en voorbeelden.

Gegevens exporteren naar Azure-app Service

Volg de onderstaande stappen om sleutelwaarden te exporteren naar Azure-app Service.

Notitie

Het exporteren van functievlagmen naar App Service wordt niet ondersteund.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

1. Navigeer naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Selecteer het keuzerondje Exporteren en selecteer onder Doeltype App Services.

3. De optie Exporteren als referentie is standaard ingeschakeld. Wanneer het selectievakje is ingeschakeld, worden de toepassingsinstellingen in App Service toegevoegd als App Configuration-verwijzingen voor de geëxporteerde sleutelwaarden. Hiermee kunt u uw instellingen in App Configuration beheren, waarbij uw App Service automatisch de huidige waarden uit App Configuration ophaalt. Zie App Configuration-verwijzingen gebruiken voor App Service en Azure Functions voor meer informatie. Als het selectievakje is uitgeschakeld, worden de sleutel en waarde rechtstreeks geëxporteerd naar App Service. Vergeet niet om uw gegevens opnieuw te exporteren wanneer u wijzigingen aanbrengt in App Configuration om ervoor te zorgen dat uw toepassing de updates ophaalt.

4. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Selectiemodus	Selecteer of u wilt exporteren uit normale sleutelwaarden, wat de standaardoptie is of vanuit een momentopname.	Standaard
   Sleutelfilter	Wordt gebruikt om sleutelwaarden te filteren op basis van de sleutelnaam voor export. Als er geen sleutels zijn opgegeven, komen alle sleutels in aanmerking.	Begint met TestApp:
   Op een bepaald tijdstip	Optioneel. Vul dit veld in om sleutelwaarden te exporteren vanaf een bepaald tijdstip in het geselecteerde configuratiearchief. Als deze waarde leeg blijft, wordt het standaard ingesteld op het huidige tijdstip van de sleutelwaarden.	28-07-2022 12:00:00 uur
   Van label	Selecteer één label om sleutelwaarden te exporteren die aan dit label zijn gekoppeld.	prikkelen

5. Selecteer een doelarchief en vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Abonnement	Uw huidige abonnement is standaard geselecteerd.	mijn abonnement
   Resourcegroep	Selecteer een resourcegroep die de App Service bevat waarin u de configuratie wilt exporteren.	my-resource-group
   Bron	Selecteer de App Service waar u de configuratie wilt exporteren.	my-app-service

6. Vul desgewenst het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Voorvoegsel verwijderen	Optioneel. Indien opgegeven, wordt het voorvoegsel verwijderd uit de sleutelnamen van alle geëxporteerde sleutelwaarden die het bevatten.	TestApp:

7. Selecteer Toepassen om door te gaan met de export.

U hebt sleutelwaarden vanaf 28 juli 2022 om 12:00 uur geëxporteerd uit een App Configuration-archief, met sleutelnamen die beginnen met TestApp: en het label prod, naar de toepassingsinstellingen van een App Service-resource. Het voorvoegsel TestApp: is afgekapt uit geëxporteerde sleutelnamen.

Als u het selectievakje voor het exporteren van sleutelwaarden als verwijzingen hebt ingeschakeld, worden de geëxporteerde sleutelwaarden aangegeven als App Configuration-verwijzingen in de kolom Bron van de configuratie-instellingen van uw App Service-resource.

Azure-CLI

Voer in de Azure CLI de onderstaande stappen uit. Als u de Azure CLI niet lokaal hebt geïnstalleerd, kunt u eventueel Azure Cloud Shell gebruiken.

1. Voer de exportopdracht az appconfig kv export in en voer de volgende parameters in:

   Parameter	Description	Voorbeeld
   --name	Voer de naam in van het App Configuration-archief met de sleutelwaarden die u wilt exporteren.	my-app-config-store
   --destination	Voer dit appservice in om aan te geven dat u gegevens naar App Service exporteert.	appservice
   --appservice-account	Voer de ARM-id van de App Service in of gebruik de naam van de App Service als deze zich in hetzelfde abonnement en dezelfde resourcegroep bevindt als de App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service of my-app-service
   --label	Optioneel. Voer een label in om sleutelwaarden en functievlagmen met dit label te exporteren. Als u geen label opgeeft, exporteert u standaard alleen sleutelwaarden en functievlagmen zonder label.	prod

   Gebruik de opdracht az webapp show --resource-group <resource-group> --name <resource-name>om de waarde voor --appservice-accountop te halen.

2. Voeg eventueel ook een voorvoegsel toe:

   Parameter	Description	Voorbeeld
   --prefix	Optioneel. Voorvoegsel dat moet worden bijgesneden uit de eigenschap sleutelwaarde van een geëxporteerde sleutelwaarde. Een sleutelvoorvoegsel is het begingedeelte van een sleutel. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief.	TestApp:

   Voorbeeld: exporteer alle sleutelwaarden met het label prod naar een App Service-toepassing en trim het voorvoegsel 'TestApp'.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   Op de opdrachtregel wordt een lijst met sleutelwaarden weergegeven die naar een App Service-resource worden geëxporteerd. Bevestig de export door te yselecteren.

   

   U hebt alle sleutelwaarden met het label prod geëxporteerd naar een Azure-app Service-resource en het voorvoegsel 'TestApp:'.

3. Geef desgewenst een vlag op die moet worden geëxporteerd als referentie voor app-configuratie.

   Parameter	Description
   --export-as-reference -r	Optioneel. Geef op of sleutelwaarden worden geëxporteerd naar App Service als Verwijzingen naar App Configuration. Meer informatie.

   Voorbeeld: exporteer alle sleutelwaarden met het label prod als app-configuratieverwijzingen naar een App Service-toepassing.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   De opdrachtregel geeft een lijst weer met sleutelwaarden die worden geëxporteerd als app-configuratieverwijzingen naar een App Service-resource. Bevestig de export door te yselecteren.

   

   U hebt alle sleutelwaarden met het label prod geëxporteerd als app-configuratieverwijzingen naar een Azure-app Service-resource. In uw App Service-resource worden de geïmporteerde sleutelwaarden aangegeven als App Configuration-verwijzingen in de kolom Bron.

   

Ga naar az appconfig kv export voor meer optionele parameters en voorbeelden.

Foutberichten

Er kunnen de volgende foutberichten optreden bij het importeren of exporteren van sleutelwaarden voor App Configuration:

• Openbare toegang is uitgeschakeld voor uw winkel of u hebt toegang vanaf een privé-eindpunt dat zich niet in de configuraties van het privé-eindpunt van het archief bevindt. Als uw App Configuration-archief privé-eindpunten heeft ingeschakeld, kunt u deze alleen openen vanuit het geconfigureerde virtuele netwerk. Zorg ervoor dat de machine waarop Azure Portal of CLI wordt uitgevoerd, is gekoppeld aan hetzelfde virtuele netwerk als het privé-eindpunt. Als u zojuist openbare netwerktoegang tot uw App Configuration-archief hebt ingeschakeld, wacht u ten minste vijf minuten voordat u opnieuw probeert de cache te vernieuwen.

Volgende stappen

Integreren met een CI/CD-pijplijn