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 App Configuration. Als u een doorlopende synchronisatie met uw GitHub-opslagplaats wilt instellen, bekijkt u GitHub Actions en Azure Pipelines-taken.

U kunt gegevens importeren of exporteren met behulp van Azure Portal of de Azure CLI.

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.

Notitie

Het importeren van functievlagmen uit een bestand wordt niet ondersteund. Als een configuratiebestand functievlagmen bevat, worden ze automatisch als normale sleutelwaarden geïmporteerd.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

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

   

2. Selecteer op het tabblad Importeren het configuratiebestand onder Bronservice.

3. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Voor taal	Kies de taal van het bestand dat u importeert tussen .NET, Java (Spring) en Overige.	.NET
   Bestandstype	Selecteer het type bestand dat u importeert tussen Yaml, Eigenschappen en Json.	Json

4. Selecteer het mappictogram en blader naar het bestand dat u wilt importeren.

   Notitie

   Er wordt een bericht weergegeven op het scherm, waarmee wordt aangegeven dat het bestand is opgehaald.

5. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Scheidingsteken	Het scheidingsteken is het teken dat in het geïmporteerde configuratiebestand wordt geparseerd om sleutelwaarden te scheiden die worden toegevoegd aan het configuratiearchief. Selecteer een van de volgende opties: ., ,, :, ;, /, -_, —.	;
   Voorvoegsel	Optioneel. Een sleutelvoorvoegsel is het begingedeelte van de eigenschap sleutelwaarde. Voorvoegsels kunnen worden gebruikt voor het beheren van groepen sleutelwaarden in een configuratiearchief. Het ingevoerde voorvoegsel wordt toegevoegd aan de voorzijde van de eigenschap 'sleutel' van elke sleutelwaarde die u uit dit bestand importeert.	TestApp:
   Label	Optioneel. Selecteer een bestaand label of voer een nieuw label in dat wordt toegewezen aan de geïmporteerde sleutelwaarden.	Prod
   Inhoudstype	Optioneel. Geef aan of u een JSON-bestand of Key Vault-verwijzingen importeert. Ga naar Key Vault-verwijzingen gebruiken in een ASP.NET Core-app voor meer informatie over Key Vault-verwijzingen.	JSON (application/json)

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

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

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 uit een JSON-bestand geïmporteerd. Aand heeft het label prod en het voorvoegsel TestApp:. 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. Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Selecteer op het tabblad Importeren de optie App Configuration onder Bronservice.

3. Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:

   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

   Notitie

   Het bericht 'Toegangssleutels opgehaald' geeft aan dat de verbinding met het App Configuration-archief is geslaagd.

4. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Van label	Selecteer ten minste één label om waarden met de bijbehorende labels te importeren. Selecteer alle importsleutelwaarden met een label en (Geen label) beperkt het importeren tot sleutelwaarden zonder label.	Prod
   Op een bepaald tijdstip	Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft.	28-07-2022 12:00:00 uur
   Standaardlabels voor sleutelwaarden overschrijven	Optioneel. Geïmporteerde items gebruiken standaard hun huidige label. Schakel het selectievakje in en voer een label in om deze standaardwaarden te overschrijven met een aangepast label.	Nieuw
   Standaardinhoudstype sleutelwaarde overschrijven	Optioneel. Geïmporteerde items gebruiken standaard hun huidige inhoudstype. Schakel het selectievakje in en selecteer Key Vault-verwijzing of JSON (toepassing/json) onder Inhoudstype 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' en wordt niet bijgewerkt door deze parameter.	JSON (application/json)

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

U hebt sleutelwaarden en functievlagmen geïmporteerd met het label prod uit een App Configuration-archief op 28 januari 2021 om 12:00 uur en het label 'nieuw' toegewezen. Alle sleutelwaarden die u hebt geïmporteerd, zijn ingesteld als 'JSON'.

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. Blader naar uw App Configuration-archief en selecteer Importeren/exporteren in het menu Operations .

   

2. Selecteer App Services onder Bronservice op het tabblad Importeren.

3. Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:

   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

   Notitie

   Er wordt een bericht weergegeven dat het aantal sleutelwaarden aangeeft dat is opgehaald uit de Bron-App Service-resource.

4. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Voorvoegsel	Optioneel. Een sleutelvoorvoegsel is het begingedeelte van de eigenschap 'sleutel' van een 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. Selecteer een bestaand label of voer een nieuw label in dat wordt toegewezen aan de geïmporteerde sleutelwaarden.	Prod
   Inhoudstype	Optioneel. Geef aan of het bestand dat u importeert een Key Vault-verwijzing of een JSON-bestand is. Ga naar Key Vault-verwijzingen gebruiken in een ASP.NET Core-app voor meer informatie over Key Vault-verwijzingen.	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 'JSON'.

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 de onderstaande stappen om configuratiegegevens uit een app-configuratiearchief te exporteren naar een Json-, Yaml- of Eigenschappenbestand.

Notitie

Het exporteren van functievlagmen vanuit een App Configuration-archief naar een configuratiebestand wordt momenteel alleen ondersteund in de CLI.

Portal

Voer vanuit Azure Portal de volgende stappen uit:

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

   

2. Selecteer op het tabblad Exporteren het configuratiebestand onder Doelservice.

3. Vul het formulier in met de volgende parameters:

   Parameter	Description	Voorbeeld
   Voorvoegsel	Optioneel. Dit voorvoegsel wordt afgekapt 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.	TestApp:
   Van label	Selecteer een bestaand label om uw export naar sleutelwaarden met een specifiek label te beperken. Als u geen label selecteert, worden standaard alleen sleutelwaarden met het label 'Geen label' geëxporteerd. Zie de opmerking hieronder.	Prod
   Op een bepaald tijdstip	Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft.	28-07-2022 12:00:00 uur
   Bestandstype	Selecteer het type bestand dat u exporteert tussen Yaml, Eigenschappen of Json.	JSON
   Scheidingsteken	Het scheidingsteken is het scheidingsteken voor het platmaken van de sleutelwaarden in Json/Yaml. Het ondersteunt de hiërarchische structuur van de configuratie en is niet van toepassing op eigenschapsbestanden en functievlagmen. Selecteer een van de volgende opties: ., ,, :, ;, /, -_, — of (Geen scheidingsteken).	;

   Belangrijk

   Als u geen From-label selecteert, worden alleen sleutelwaarden zonder labels geëxporteerd. Als u een sleutelwaarde met een label wilt exporteren, moet u het label selecteren. Houd er rekening mee dat u slechts één label per export in de portal kunt selecteren voor het geval u de sleutelwaarden wilt exporteren met alle opgegeven labels, gebruikt u CLI.

4. Selecteer Exporteren om de export te voltooien.

U hebt sleutelwaarden geëxporteerd met het label 'prod' uit een configuratiebestand, op hun status van 28-07-2021 12:00:00 uur en het voorvoegsel 'TestApp' bijgesneden. Waarden worden gescheiden door ';' in het bestand.

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. Blader naar het App Configuration-archief met de gegevens die u wilt exporteren en selecteer Importeren/exporteren in het menu Operations .

   

2. Selecteer op het tabblad Exporteren de optie App Configuration onder Doelservice.

3. Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:

   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.	my-resource-group
   Bron	Selecteer het App Configuration-archief dat de configuratie bevat die u wilt importeren.	my-app-config-store

4. Op de pagina worden nu de geselecteerde doelservice en resource-id weergegeven. Met de actie Resource selecteren kunt u overschakelen naar een ander bron-App Configuration-archief.

   Notitie

   Er wordt een bericht weergegeven op het scherm, waarmee wordt aangegeven dat de sleutelwaarden zijn opgehaald.

5. Vul het volgende deel van het formulier in:

   Parameter	Description	Voorbeeld
   Van label	Selecteer ten minste één label om waarden met de bijbehorende labels te exporteren. Selecteer alle sleutelwaarden met een label en (Geen label) beperkt de export naar sleutelwaarden zonder label.	Prod
   Op een bepaald tijdstip	Optioneel. Vul in om sleutelwaarden te importeren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft.	28-07-2022 12:00:00 uur
   Standaardlabels voor sleutelwaarden overschrijven	Optioneel. Geïmporteerde items gebruiken standaard hun huidige label. Schakel het selectievakje in en voer een label in om deze standaardwaarden te overschrijven met een aangepast label.	Nieuw

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

U hebt sleutelwaarden en functievlagmen geëxporteerd met het label 'prod' uit een App Configuration-archief, op hun status vanaf 28-07-2022 12:00:00 uur en het label 'nieuw' toegewezen.

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 momenteel niet ondersteund.

Portal

Volg deze stappen vanuit de Microsoft Azure-portal:

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

   

2. Selecteer App Services onder Doelservice op het tabblad Exporteren.

3. Selecteer Resource selecteren, vul het formulier in met de volgende parameters en selecteer Toepassen:

   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 exporteren.	my-resource-group
   Bron	Selecteer de App Service die de configuratie bevat die u wilt exporteren.	my-app-service

4. Op de pagina worden nu de geselecteerde doelservice en resource-id weergegeven. Met de actie Resource selecteren kunt u overschakelen naar een andere App Service-doelresource.

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

   Parameter	Description	Voorbeeld
   Voorvoegsel	Optioneel. Dit voorvoegsel wordt bijgesneden uit de eigenschap sleutelwaarde van elke geëxporteerde 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:
   Exporteren als referentie	Optioneel. Controleer of u sleutelwaarden naar App Service wilt exporteren als App Configuration-verwijzingen. Meer informatie
   Op een bepaald tijdstip	Optioneel. Vul in om sleutelwaarden te exporteren vanaf een bepaald tijdstip. Dit is het tijdstip van de sleutelwaarden in het geselecteerde configuratiearchief. Notatie: "JJJJ-MM-DDThh:mm:ssZ". Dit veld wordt standaard ingesteld op het huidige tijdstip van de sleutelwaarden wanneer deze leeg blijft.	28-07-2022 12:00:00 uur
   Van label	Optioneel. Selecteer een bestaand label om uw export naar sleutelwaarden met een specifiek label te beperken. Als u geen label selecteert, worden alleen sleutelwaarden met het label 'Geen label' geëxporteerd.	Prod

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

U hebt sleutelwaarden geëxporteerd met het label prod uit een App Service-resource, op hun status vanaf 28-07-2021 12:00:00 uur en het voorvoegsel 'TestApp' bijgesneden. De sleutelwaarden zijn geëxporteerd met een inhoudstype in JSON-indeling.

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:

• Het geselecteerde bestand moet tussen 1 en 2097152 bytes zijn. Het bestand is te groot. Selecteer een kleiner bestand.
• 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 u sleutelwaarden uit een App Configuration-archief wilt importeren, moet u toegang hebben tot dat archief. Schakel zo nodig openbare toegang in voor het bronarchief of open deze vanuit een goedgekeurd privé-eindpunt. Als u zojuist openbare toegang hebt ingeschakeld, wacht u maximaal 5 minuten totdat de cache is vernieuwd.

Volgende stappen

Integreren met een CI/CD-pijplijn