Importieren oder Exportieren von Konfigurationsdaten

Azure App Configuration unterstützt Datenimport- und -exportvorgänge. Verwenden Sie diese Vorgänge, um mit großen Mengen von Konfigurationsdaten zu arbeiten und Daten zwischen Ihrem App-Konfigurationsspeicher und dem Codeprojekt auszutauschen. Beispielsweise können Sie einen App Configuration-Speicher zum Testen und einen anderen für die Produktion einrichten. Sie können Anwendungseinstellungen zwischen diesen Speichern kopieren, damit Sie Daten nicht zweimal eingeben müssen.

Dieser Artikel enthält eine Anleitung zum Importieren und Exportieren von Daten mithilfe des Azure-Portals oder der Azure CLI. Wenn Sie Konfiguration als Code übernommen und Ihre Konfigurationen in GitHub oder Azure DevOps verwaltet haben, können Sie den Import der fortlaufenden Konfigurationsdatei mithilfe von GitHub Actions einrichten oder die Azure Pipeline-Importaufgabe verwenden.

Daten importieren

Beim Import werden Konfigurationsdaten aus einer vorhandenen Quelle in einen App Configuration-Speicher eingefügt. Verwenden Sie die Importfunktion zum Migrieren von Daten in einen App Configuration-Speicher oder zum Aggregieren von Daten aus mehreren Quellen.

In diesem Leitfaden wird gezeigt, wie App Configuration-Daten importiert werden:

• aus einer Konfigurationsdatei im JSON- oder YAML-Format oder aus einer Eigenschaftendatei
• aus einem App Configuration-Speicher
• aus Azure App Service

Importieren von Daten aus einer Konfigurationsdatei

Führen Sie die folgenden Schritte aus, um Schlüsselwerte aus einer Datei zu importieren.

Portal

Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, und wählen Sie Importieren/Exportieren im Menü Vorgänge aus.

   

2. Das Optionsfeld Importieren ist standardmäßig aktiviert. Wählen Sie unter Quelltyp die Option Konfigurationsdatei aus.

3. Füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Dateityp	Wählen Sie den Dateityp für den Import aus: YAML, Eigenschaften oder JSON.	Json

4. Klicken Sie auf die Schaltfläche Durchsuchen und wählen Sie die zu importierende Datei aus.

5. Füllen Sie den nächsten Teil des Formulars aus:

   Parameter	BESCHREIBUNG	Beispiel
   Dateiinhaltsprofil	Wählen Sie ein Inhaltsprofil aus: Standard oder KVSet. Das Standarddateiinhaltsprofil bezeichnet das herkömmliche Konfigurationsdateischema, das bei vorhandenen Programmierframeworks oder Systemen weit verbreitet ist und JSON-, Yaml- oder Properties-Dateiformate unterstützt. Das KVSet-Dateiinhaltsprofil bezieht sich auf ein Dateischema, das alle Eigenschaften eines App Configuration-Schlüssel-Wert-Paars enthält, einschließlich Schlüssel, Wert, Bezeichnung, Inhaltstyp und Tags.	Standard
   Import-Modus	Der Importmodus wird verwendet, um zu bestimmen, ob identische Schlüsselwerte ignoriert werden sollen. Bei der Option Übereinstimmung ignorieren werden alle Schlüsselwerte im Speicher ignoriert, die mit denen in der Konfigurationsdatei übereinstimmen. Mit der Option Alle werden alle Schlüsselwerte in der Konfigurationsdatei aktualisiert.	Übereinstimmung ignorieren
   Featurekennzeichnung ausschließen	Wenn diese Option aktiviert ist, werden keine Featurekennzeichnungen importiert.	Nicht aktiviert
   Strict	Wenn das Kontrollkästchen aktiviert ist, werden alle Schlüsselwerte im Speicher mit dem angegebenen Präfix und der Bezeichnung, die nicht in der Konfigurationsdatei enthalten sind, gelöscht, wenn das Dateiinhaltsprofil auf „Standard“ festgelegt ist. Wenn das Dateiinhaltsprofil auf KVSet festgelegt ist, werden alle Schlüsselwerte im Speicher gelöscht, die nicht in der Konfigurationsdatei enthalten sind. Wenn das Kontrollkästchen deaktiviert ist, werden keine Schlüsselwerte im Speicher gelöscht.	Nicht aktiviert
   Trennzeichen	Die Trennlinie ist das Trennzeichen, das zum Abflachen von JSON- oder YAML-Dateien in Schlüsselwerte verwendet wird. Es wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Unterstützte Werte sind kein Trennzeichen, Punkt (.), Komma (,), Semikolon (;), Bindestrich (-), Unterstrich (_), Doppelter Unterstrich (_), Schrägstrich (/) und Doppelpunkt (:).	:
   Depth	Optional. Die Tiefe zum Abflachen von JSON- oder YAML-Dateien in Schlüsselwertpaare. Standardmäßig werden Dateien auf die tiefste Ebene abgeflacht, wenn ein Trennzeichen ausgewählt ist. Diese Einstellung gilt nicht für Eigenschaftendateien oder Featurekennzeichnungen.
   Präfix hinzufügen	Optional. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Hinzufügen einer Bezeichnung	Optional. Wenn angegeben, wird die angegebene Bezeichnung allen importierten Schlüsselwerten zugewiesen.	prod
   Inhaltstyp hinzufügen	Optional. Wenn angegeben, wird der bereitgestellte Inhaltstyp allen importierten Schlüsselwerten hinzugefügt.	JSON (application/json)
   Hinzufügen von Tags	Optional. Wenn angegeben, werden die bereitgestellten Tags allen importierten Schlüsselwerten hinzugefügt.	{Markierung: tag1}

6. Wählen Sie Anwenden aus, um den Import fortzusetzen.

Sie haben Schlüsselwerte erfolgreich aus einer JSON-Datei importiert. Die Schlüsselnamen wurden mit dem : Trennzeichen abgeflacht und mit TestApp: präfixiert. Alle importierten Schlüsselwerte werden als prod, mit dem Inhaltstyp application/json und mit tag: tag1 gekennzeichnet.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Importbefehl az appconfig kv import ein, und fügen Sie die folgenden Parameter hinzu:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie file ein, um anzugeben, dass Sie App Configuration-Daten aus einer Datei importieren.	file
   --path	Geben Sie den lokalen Pfad zu der Datei ein, die die Daten enthält, die Sie importieren möchten.	C:/Users/john/Downloads/data.json
   --format	Geben Sie YAML, Eigenschaften oder JSON ein, um das Format der zu importierenden Datei anzugeben.	json

2. Optional können Sie auch die folgenden Parameter hinzufügen:

   Parameter	BESCHREIBUNG	Beispiel
   --separator	Optional. Das Trennzeichen wird für die Vereinfachung der Schlüsselwerte in das JSON-/YAML-Format verwendet. Es ist erforderlich, um die hierarchische Struktur zu exportieren, und wird bei Eigenschaftendateien und Featureflags ignoriert. Wählen Sie eine der folgenden Optionen aus: ., ,, :, ;, /, -, _, —.	;
   --prefix	Optional. Ein Schlüsselpräfix ist der Anfangsteil eines Schlüssels. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Dieses Präfix wird am Anfang der „key“-Eigenschaft jedes importierten Schlüsselwerts angefügt.	TestApp:
   --label	Optional. Geben Sie eine Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird.	prod
   --content-type	Optional. Geben Sie appconfig/kvset oder application/json ein, um anzugeben, dass der importierte Inhalt aus einem Key Vault-Verweis oder einer JSON-Datei besteht.	application/json

   Beispiel: Importieren aller Schlüsselwerte und Featureflags aus einer JSON-Datei, Anwenden der Bezeichnung „prod“ und Anfügen des Präfixes „TestApp“. Fügen Sie den Inhaltstyp „application/json“ hinzu.

   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. Die Befehlszeile zeigt eine Liste der bevorstehenden Änderungen an. Bestätigen Sie den Import, indem Sie y auswählen.

   

Sie haben Schlüsselwerte aus einer JSON-Datei importiert und ihnen die Bezeichnung „prod“ und das Präfix „TestApp“ zugewiesen. Das Trennzeichen „;“ wird verwendet, und für alle Schlüsselwerte, die Sie importiert haben, wird der Inhaltstyp auf „JSON“ festgelegt.

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv import.

Imp von Daten aus einem App Configuration-Speicher

Sie können Werte aus einem App Configuration-Speicher in einen anderen App Configuration-Speicher importieren oder Werte aus einem App Configuration-Speicher in denselben App Configuration-Speicher importieren, um die Werte zu duplizieren und verschiedene Parameter, z. B. eine neue Bezeichnung oder einen neuen Inhaltstyp, anzuwenden.

Führen Sie die folgenden Schritte aus, um Schlüsselwerte und Featureflags aus einem Azure App Configuration-Speicher zu importieren.

Portal

Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, und wählen Sie Importieren/Exportieren im Menü Vorgänge aus.

   

2. Das Optionsfeld Importieren ist standardmäßig aktiviert. Wählen Sie unter Quelltyp die Option App-Konfigurationsdatei aus.

3. Wählen Sie einen App-Konfigurationsspeicher aus, aus dem Daten importiert werden sollen, und füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	my-subscription
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe aus, die den App Configuration-Speicher mit der zu importierenden Konfiguration enthält. Ihre aktuelle Ressourcengruppe ist standardmäßig ausgewählt.	my-resource-group
   Resource	Wählen Sie den App Configuration-Speicher aus, der die Konfiguration enthält, die Sie importieren möchten.	my-other-app-config-store

4. Füllen Sie den nächsten Teil des Formulars aus:

   Parameter	BESCHREIBUNG	Beispiel
   Auswahlmodus	Wählen Sie aus regulären Schlüsselwerten aus, bei denen es sich um die Standardoption oder eine Momentaufnahme handelt.	Standard
   Schlüsselfilter	Wird verwendet, um Schlüsselwerte basierend auf dem Schlüsselnamen für den Import zu filtern. Wenn keine Schlüssel angegeben sind, sind alle Schlüssel berechtigt.	Beginnt mit Test
   Zu einem bestimmten Zeitpunkt	Optional. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu importieren. Wenn es leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	07/28/2022 12:00:00 AM
   Quellbezeichnung	Wählen Sie eine oder mehrere Bezeichnungen aus, um Schlüsselwerte zu importieren, die diesen Bezeichnungen zugeordnet sind. Wenn keine Bezeichnung ausgewählt ist, sind alle Bezeichnungen berechtigt.	prod
   Featurekennzeichnung ausschließen	Wenn diese Option aktiviert ist, werden keine Featurekennzeichnungen importiert.	Nicht aktiviert
   Präfix hinzufügen	Optional. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Überschreiben von Bezeichnungen	Optional. Standardmäßig bleiben die ursprünglichen Bezeichnungen der Quellschlüsselwerte erhalten. Um sie außer Kraft zu setzen, aktivieren Sie das Kontrollkästchen, und geben Sie eine neue Bezeichnung für importierte Schlüsselwerte ein.	new
   Überschreiben von Inhaltstypen	Optional. Standardmäßig werden die ursprünglichen Inhaltstypen der Quellschlüsselwerte beibehalten. Um sie außer Kraft zu setzen, aktivieren Sie das Kontrollkästchen, und geben Sie einen neuen Inhaltstyp für importierte Schlüsselwerte ein. Beachten Sie, dass der Inhaltstyp von Featurekennzeichnungen nicht außer Kraft gesetzt werden kann.	JSON (application/json)

5. Wählen Sie Anwenden aus, um den Import fortzusetzen.

Sie haben Schlüsselwerte ab dem 28. Januar 2021 um 12 Uhr aus einem App-Konfigurationsspeicher importiert, wobei die Schlüsselnamen mit test und der Bezeichnung prod beginnen. Die Schlüsselnamen wurden dem Präfix vorangestellt TestApp:. Allen importierten Schlüsselwerten wurden die Bezeichnung new und der Inhaltstyp application/json zugewiesen.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Importbefehl az appconfig kv import ein, und geben Sie die folgenden Parameter ein:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie appconfig ein, um anzugeben, dass Sie Daten aus einem App Configuration-Speicher importieren.	appconfig
   --src-name	Geben Sie den Namen des App Configuration-Speichers ein, aus dem Sie Daten importieren möchten.	my-source-app-config
   --src-label	Beschränken Sie Ihren Import auf Schlüsselwerte mit einer bestimmten Bezeichnung. Wenn Sie diesen Parameter nicht verwenden, werden nur Schlüsselwerte mit einer Nullbezeichnung importiert. Unterstützt das Sternchen-Symbol als Filter: Geben Sie * für alle Bezeichnungen ein und abc* für alle Bezeichnungen mit „abc“ als Präfix.	prod

2. Optional können Sie die folgenden Parameter hinzufügen:

   Parameter	BESCHREIBUNG	Beispiel
   --label	Optional. Geben Sie eine Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird.	new
   --content-type	Optional. Geben Sie appconfig/kvset oder application/json ein, um anzugeben, dass der importierte Inhalt aus einem Key Vault-Verweis oder einer JSON-Datei besteht. Der Inhaltstyp kann nur für importierte Schlüsselwerte außer Kraft gesetzt werden. Der Standardinhaltstyp für Featureflags lautet standardmäßig „application/vnd.microsoft.appconfig.ff+json;charset=utf-8“ und wird von diesem Parameter nicht aktualisiert.	application/json

   Beispiel: Importieren von Schlüsselwerten und Featureflags mit der Bezeichnung „prod“ aus einer anderen App Configuration und Zuweisen der Bezeichnung „new“. Fügen Sie den Inhaltstyp „application/json“ hinzu.

   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. Die Befehlszeile zeigt eine Liste der bevorstehenden Änderungen an. Bestätigen Sie den Import, indem Sie y auswählen.

   

Sie haben Schlüsselwerte mit der Bezeichnung „prod“ aus einem App Configuration-Speicher importiert und ihnen die Bezeichnung „new“ zugewiesen. Für alle Schlüsselwerte, die Sie importiert haben, wurde der Inhaltstyp auf „JSON“ festgelegt.

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv import.

Importieren von Daten aus Azure App Service

Führen Sie die folgenden Schritte aus, um Schlüsselwerte aus Azure App Service zu importieren.

Hinweis

App Service unterstützt derzeit keine Featureflags. Alle in App Service importierten Featureflags werden automatisch in Schlüsselwerte konvertiert. Ihre App Service-Ressourcen können nur Schlüsselwerte enthalten.

Portal

Gehen Sie im Azure-Portal so vor:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, und wählen Sie Importieren/Exportieren im Menü Vorgänge aus.

   

2. Das Optionsfeld Importieren ist standardmäßig aktiviert. Wählen Sie unter Quelltyp App Services aus.

3. Wählen Sie einen App-Konfigurationsspeicher aus, aus dem Daten importiert werden sollen, und füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	my-subscription
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe aus, die den App Service mit der zu importierenden Konfiguration enthält.	my-resource-group
   Resource	Wählen Sie den App Service aus, der die Konfiguration enthält, die Sie importieren möchten.	my-app-service

4. Füllen Sie den nächsten Teil des Formulars aus:

   Parameter	BESCHREIBUNG	Beispiel
   Aktualisieren von Einstellungen, auf die verwiesen werden soll	Wenn diese Option aktiviert ist, werden die App-Einstellungen im App-Dienst auf App-Konfigurationsverweise für die importierten Schlüsselwerte aktualisiert. Auf diese Weise können Sie Ihre App-Einstellungen in der App-Konfiguration in Zukunft verwalten. Ihr App-Dienst ruft automatisch den aktuellen Wert aus der App-Konfiguration ab. Weitere Informationen erhalten Sie unter Verwenden von App Configuration-Verweisen für App Service und Azure Functions (Vorschau).	Überprüft
   Präfix hinzufügen	Optional. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Hinzufügen einer Bezeichnung	Optional. Wenn angegeben, wird die angegebene Bezeichnung allen importierten Schlüsselwerten zugewiesen.	prod
   Inhaltstyp hinzufügen	Optional. Wenn angegeben, wird der bereitgestellte Inhaltstyp allen importierten Schlüsselwerten hinzugefügt.	JSON (application/json)

5. Wählen Sie Anwenden aus, um den Import fortzusetzen.

Sie haben alle Anwendungseinstellungen aus einem App Service als Schlüsselwerte importiert und ihnen die Bezeichnung prod und das Präfix TestApp: zugewiesen. Für alle Schlüsselwerte, die Sie importiert haben, wurde der Inhaltstyp auf application/json festgelegt.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Importbefehl az appconfig kv import ein, und fügen Sie die folgenden Parameter hinzu:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie appservice ein, um anzugeben, dass Sie App Configuration-Daten aus Azure App Service importieren.	appservice
   --appservice-account	Geben Sie die ARM-ID des App Service ein, oder verwenden Sie seinen Namen, wenn er sich im selben Abonnement und derselben Ressourcengruppe wie App Configuration befindet.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service oder my-app-service

2. Optional können Sie auch die folgenden Parameter hinzufügen:

   Parameter	BESCHREIBUNG	Beispiel
   --prefix	Optional. Ein Schlüsselpräfix ist der Anfangsteil der „key“-Eigenschaft eines Schlüsselwerts. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Dieses Präfix wird am Anfang der „key“-Eigenschaft jedes importierten Schlüsselwerts angefügt.	TestApp:
   --label	Optional. Geben Sie eine Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird. Wenn Sie keine Bezeichnung angeben, wird Ihren Schlüsselwerten die Nullbezeichnung zugewiesen.	prod
   --content-type	Optional. Geben Sie „appconfig/kvset“ oder „application/json“ ein, um anzugeben, dass der importierte Inhalt aus einem Key Vault-Verweis oder einer JSON-Datei besteht.	application/json

   Um den Wert für --appservice-account abzurufen, verwenden Sie den Befehl az webapp show --resource-group <resource-group> --name <resource-name>.

   Beispiel: Importieren aller Anwendungseinstellungen aus Ihrem App Service als Schlüsselwerte mit der Bezeichnung „prod“ in Ihren App Configuration-Speicher und Hinzufügen eines Präfixes „TestApp:“.

   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. Die Befehlszeile zeigt eine Liste der bevorstehenden Änderungen an. Bestätigen Sie den Import, indem Sie y auswählen.

   

Sie haben alle Anwendungseinstellungen aus Ihrem App Service als Schlüsselwerte importiert und ihnen die Bezeichnung „prod“ zugewiesen sowie ein Präfix „TestApp:“ hinzugefügt. Für alle Schlüsselwerte, die Sie importiert haben, wurde der Inhaltstyp auf „JSON“ festgelegt.

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv import.

Daten exportieren

Beim Export werden in App Configuration gespeicherte Daten an ein anderes Ziel geschrieben. Verwenden Sie die Exportfunktion beispielsweise zum Speichern von Daten aus einem App Configuration-Speicher in einer Datei, die während der Bereitstellung in Ihren Anwendungscode eingebettet werden kann.

In diesem Leitfaden wird gezeigt, wie App Configuration-Daten exportiert werden:

• in eine Konfigurationsdatei im JSON- oder YAML-Format oder in eine Eigenschaftendatei
• in einen App Configuration-Speicher
• in eine Azure App Service-Ressource

Exportieren von Daten in eine Konfigurationsdatei

Führen Sie diese Schritte aus, um Konfigurationsdaten aus einem App Konfigurationsspeicher in eine JSON-, YAML- oder Eigenschaftendatei zu exportieren.

Portal

Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, und wählen Sie Import/Export aus.

   

2. Wählen Sie das Optionsfeld Exportieren aus, und wählen Sie unter Zieltyp Konfigurationsdatei aus.

3. Füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Dateityp	Wählen Sie den Dateityp für den Export aus: YAML, Eigenschaften oder JSON.	JSON
   Dateiinhaltsprofil	Wählen Sie ein Inhaltsprofil aus: Standard oder KVSet. Das Standarddateiinhaltsprofil bezeichnet das herkömmliche Konfigurationsdateischema, das bei vorhandenen Programmierframeworks oder Systemen weit verbreitet ist und JSON-, Yaml- oder Properties-Dateiformate unterstützt. Das KVSet-Dateiinhaltsprofil bezieht sich auf ein Dateischema, das alle Eigenschaften eines App Configuration-Schlüssel-Wert-Paars enthält, einschließlich Schlüssel, Wert, Bezeichnung, Inhaltstyp und Tags.	Standard
   Auswahlmodus	Wählen Sie aus regulären Schlüsselwerten aus, bei denen es sich um die Standardoption oder eine Momentaufnahme handelt.	Standard
   Schlüsselfilter	Wird verwendet, um Schlüsselwerte basierend auf dem Schlüsselnamen für den Export zu filtern. Wenn keine Schlüssel angegeben sind, sind alle Schlüssel berechtigt.	Beginnt mit TestApp:
   Zu einem bestimmten Zeitpunkt	Optional. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn es leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	07/28/2022 12:00:00 AM
   Quellbezeichnung	Wählen Sie die Bezeichnung aus, um Schlüsselwerte zu exportieren, die diesen Bezeichnungen zugeordnet sind. Wenn keine Bezeichnung ausgewählt ist, sind alle Bezeichnungen berechtigt. Beachten Sie, dass Sie beim Exportieren mit dem Default-Dateiinhaltsprofil nur eine Bezeichnung auswählen können. Verwenden Sie das KVSet-Dateiinhaltsprofil, um Schlüsselwerte mit mehreren Bezeichnungen zu exportieren.	prod
   Präfix entfernen	Optional. Wenn angegeben, wird das Präfix aus den Schlüsselnamen aller exportierten Schlüsselwerte, die es enthalten, entfernt wird.	TestApp:
   Trennzeichen	Das Trennzeichen ist das Trennzeichen, das zum Segmentieren von Schlüsselnamen und zum Rekonstruieren hierarchischer Konfigurationen für JSON- oder YAML-Dateien aus Schlüsselwerten verwendet wird. Es wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Unterstützte Werte sind kein Trennzeichen, Punkt (.), Komma (,), Semikolon (;), Bindestrich (-), Unterstrich (_), Doppelter Unterstrich (_), Schrägstrich (/) und Doppelpunkt (:).	:

4. Wählen Sie Exportieren aus, um den Export abzuschließen.

Sie haben Schlüsselwerte ab dem 28. Juli 2021 um 12 Uhr aus einem App-Konfigurationsspeicher exportiert, wobei die Schlüsselnamen mit TestApp: und der Bezeichnung prod für eine JSON-Datei beginnen. Das Präfix TestApp: wurde aus den Schlüsselnamen entfernt, und das Trennzeichen : wurde verwendet, um die Schlüsselnamen zu segmentieren und das hierarchische JSON-Format zu rekonstruieren.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Exportbefehl az appconfig kv export ein, und fügen Sie die folgenden Parameter hinzu:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, der die zu exportierenden Schlüsselwerte enthält.	my-app-config-store
   --destination	Geben Sie file ein, um anzugeben, dass Sie Daten in eine Datei exportieren.	file
   --path	Gibt den Pfad an, in dem die Datei gespeichert werden soll.	C:/Users/john/Downloads/data.json
   --format	Geben Sie yaml, properties oder json ein, um das Format der Datei anzugeben, die Sie exportieren möchten.	json
   --label	Geben Sie eine Bezeichnung ein, um Schlüsselwerte und Featureflags mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featureflags ohne Bezeichnung. Sie können eine Bezeichnung eingeben, aber auch mehrere, indem Sie sie durch , trennen, oder Sie verwenden *, um alle Bezeichnungen zu berücksichtigen.	prod

   Wichtig

   Wenn Sie keine Bezeichnung auswählen, werden nur Schlüsselwerte ohne Bezeichnungen exportiert. Um einen Schlüsselwert mit einer Bezeichnung zu exportieren, müssen Sie dessen Bezeichnung auswählen.

2. Optional können Sie auch die folgenden Parameter hinzufügen:

   Parameter	BESCHREIBUNG	Beispiel
   --separator	Optional. Das Trennzeichen wird für die Vereinfachung der Schlüsselwerte in das JSON-/YAML-Format verwendet. Es ist erforderlich, um die hierarchische Struktur zu exportieren, und wird bei Eigenschaftendateien und Featureflags ignoriert. Wählen Sie eine der folgenden Optionen aus: ., ,, :, ;, /, -, _, —.	;
   --prefix	Optional. Das von der „key“-Eigenschaft jedes Schlüsselwerts zu kürzende Präfix. Ein Schlüsselpräfix ist der Anfangsteil eines Schlüssels. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Das Präfix wird bei Featureflags ignoriert.	TestApp:

   Beispiel: Exportieren aller Schlüsselwerte und Featureflags mit der Bezeichnung „prod“ in eine JSON-Datei.

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

3. Die Befehlszeile zeigt eine Liste der Schlüsselwerte an, die in die Datei exportiert werden. Bestätigen Sie den Export, indem Sie y auswählen.

   

Sie haben Schlüsselwerte und Featureflags mit der Bezeichnung „prod“ in eine Konfigurationsdatei exportiert und das Präfix „TestApp“ gekürzt. Die Werte sind durch „;“ in der Datei getrennt.

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv export.

Exportieren von Daten in einen App Configuration-Speicher

Führen Sie die folgenden Schritte aus, um Schlüsselwerte und Featureflags in einen Azure App Configuration-Speicher zu exportieren.

Sie können Werte aus einem App Configuration-Speicher in einen anderen App Configuration-Speicher exportieren oder Werte aus einem App Configuration-Speicher in denselben App Configuration-Speicher exportieren, um die Werte zu duplizieren und verschiedene Parameter, z. B. eine neue Bezeichnung oder einen neuen Inhaltstyp, anzuwenden.

Portal

Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, der die zu exportierenden Daten enthält, und wählen Sie im Menü Vorgänge die Option Importieren/Exportieren aus.

   

2. Wählen Sie das Optionsfeld Exportieren und unter Zieltyp App-Konfiguration aus.

3. Füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Auswahlmodus	Wählen Sie aus regulären Schlüsselwerten aus, bei denen es sich um die Standardoption oder eine Momentaufnahme handelt.	Standard
   Schlüsselfilter	Wird verwendet, um Schlüsselwerte basierend auf dem Schlüsselnamen für den Export zu filtern. Wenn keine Schlüssel angegeben sind, sind alle Schlüssel berechtigt.	Beginnt mit TestApp:
   Zu einem bestimmten Zeitpunkt	Optional. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn es leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	07/28/2022 12:00:00 AM
   Quellbezeichnung	Wählen Sie eine oder mehrere Bezeichnungen aus, um Schlüsselwerte zu exportieren, die diesen Bezeichnungen zugeordnet sind. Wenn keine Bezeichnung ausgewählt ist, sind alle Bezeichnungen berechtigt.	prod
   Featurekennzeichnung ausschließen	Wenn aktiviert, werden Featurekennzeichnungen nicht exportiert.	Nicht aktiviert

4. Wählen Sie den Zielspeicher aus, füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	my-subscription
   Resource group	Wählen Sie eine Ressourcengruppe aus, die den App-Konfigurationsspeicher enthält, in den Sie die Konfiguration exportieren möchten. Ihre aktuelle Ressourcengruppe ist standardmäßig ausgewählt.	my-resource-group
   Resource	Wählen Sie den App-Konfigurationsspeicher aus, in den Sie die Konfiguration exportieren möchten.	my-other-app-config-store

5. Füllen Sie den nächsten Teil des Formulars aus:

   Parameter	BESCHREIBUNG	Beispiel
   Präfix entfernen	Optional. Wenn angegeben, wird das Präfix aus den Schlüsselnamen aller exportierten Schlüsselwerte, die es enthalten, entfernt wird.	TestApp:
   Überschreiben von Bezeichnungen	Optional. Standardmäßig bleiben die ursprünglichen Bezeichnungen der Quellschlüsselwerte erhalten. Um sie außer Kraft zu setzen, aktivieren Sie das Kontrollkästchen, und geben Sie eine neue Bezeichnung für exportierte Schlüsselwerte ein.	new
   Überschreiben von Inhaltstypen	Optional. Standardmäßig werden die ursprünglichen Inhaltstypen der Quellschlüsselwerte beibehalten. Um sie außer Kraft zu setzen, aktivieren Sie das Kontrollkästchen, und geben Sie einen neuen Inhaltstyp für exportierte Schlüsselwerte ein. Beachten Sie, dass der Inhaltstyp von Featurekennzeichnungen nicht außer Kraft gesetzt werden kann.	JSON (application/json)

6. Wählen Sie Anwenden aus, um den Export fortzusetzen.

Sie exportierten Schlüsselwerte aus einem App-Konfigurationsspeicher ab dem 28. Juli 2022 um 12 Uhr mit Schlüsselnamen beginnend mit TestApp: und der Bezeichnung prod in einen anderen App-Konfigurationsspeicher. Alle exportierten Schlüsselwerte wurden um das Schlüsselpräfix TestApp: gekürzt und der Bezeichnung new und dem Inhaltstyp application/json zugewiesen.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Exportbefehl az appconfig kv export ein, und geben Sie die folgenden Parameter ein:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, der die zu exportierenden Schlüsselwerte enthält.	my-app-config-store
   --destination	Geben Sie appconfig ein, um anzugeben, dass Sie Daten in einen App Configuration-Speicher exportieren.	appconfig
   --dest-name	Geben Sie den Namen des App Configuration-Speichers ein, in den Sie Daten exportieren möchten.	my-other-app-config-store
   --label	Geben Sie eine Bezeichnung ein, um Schlüsselwerte und Featureflags mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featureflags ohne Bezeichnung. Sie können eine Bezeichnung eingeben, aber auch mehrere, indem Sie sie durch , trennen, oder Sie verwenden *, um alle Bezeichnungen zu berücksichtigen.	prod

   Wichtig

   Wenn die Schlüsselwerte, die Sie exportieren möchten, Bezeichnungen aufweisen, müssen Sie den Befehl --label verwenden und die entsprechenden Bezeichnungen eingeben. Wenn Sie keine Bezeichnung auswählen, werden nur Schlüsselwerte ohne Bezeichnungen exportiert. Verwenden Sie ein Komma (,), um mehrere Bezeichnungen auszuwählen, oder verwenden Sie *, um alle Bezeichnungen einzuschließen, einschließlich der Nullbezeichnung („Keine Bezeichnung“).

2. Optional können Sie auch den folgenden Parameter hinzufügen:

   Parameter	BESCHREIBUNG	Beispiel
   --dest-label	Optional. Geben Sie eine Zielbezeichnung ein, um diese Bezeichnung den exportierten Schlüsselwerten zuzuweisen.	new

   Beispiel: Exportieren von Schlüsselwerten und Featureflags mit der Bezeichnung „prod“ in einen anderen App Configuration-Speicher und Hinzufügen der Zielbezeichnung „new“.

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

3. Die Befehlszeile zeigt eine Liste der Schlüsselwerte an, die in die Dateien exportiert werden. Bestätigen Sie den Export, indem Sie y auswählen.

   

Sie haben Schlüsselwerte und Featureflags mit der Bezeichnung „prod“ aus einem App Configuration-Speicher exportiert und ihnen die Bezeichnung „new“ zugewiesen.

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv import.

Exportieren von Daten nach Azure App Service

Führen Sie die folgenden Schritte aus, um Schlüsselwerte nach Azure App Service zu exportieren.

Hinweis

Das Exportieren von Featureflags nach App Service wird nicht unterstützt.

Portal

Führen Sie im Azure-Portal die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem App Configuration-Speicher, und wählen Sie Importieren/Exportieren im Menü Vorgänge aus.

   

2. Wählen Sie das Optionsfeld Exportieren und unter Zieltyp App Services aus.

3. Die Option Als Referenz exportieren ist standardmäßig aktiviert. Wenn das Kontrollkästchen aktiviert ist, werden die Anwendungseinstellungen in App Service als App-Konfigurationsverweise für die exportierten Schlüsselwerte hinzugefügt. Auf diese Weise können Sie Ihre Einstellungen in der App-Konfiguration verwalten, wobei der App-Dienst automatisch die aktuellen Werte aus der App-Konfiguration abruft. Weitere Informationen erhalten Sie unter Verwenden von App Configuration-Verweisen für App Service und Azure Functions (Vorschau). Wenn das Kontrollkästchen deaktiviert ist, werden der Schlüssel und der Wert direkt in App Service exportiert. Denken Sie daran, Ihre Daten immer dann erneut zu exportieren, wenn Sie Änderungen an der App-Konfiguration vornehmen, um sicherzustellen, dass ihre Anwendung die Updates annimmt.

4. Füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Auswahlmodus	Wählen Sie aus regulären Schlüsselwerten aus, bei denen es sich um die Standardoption oder eine Momentaufnahme handelt.	Standard
   Schlüsselfilter	Wird verwendet, um Schlüsselwerte basierend auf dem Schlüsselnamen für den Export zu filtern. Wenn keine Schlüssel angegeben sind, sind alle Schlüssel berechtigt.	Beginnt mit TestApp:
   Zu einem bestimmten Zeitpunkt	Optional. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn es leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	07/28/2022 12:00:00 AM
   Quellbezeichnung	Wählen Sie eine Bezeichnung aus, um Schlüsselwerte zu exportieren, die dieser Bezeichnung zugeordnet sind.	prod

5. Wählen Sie einen Zielspeicher aus und füllen Sie das Formular mit den folgenden Parametern aus:

   Parameter	BESCHREIBUNG	Beispiel
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	my-subscription
   Resource group	Wählen Sie eine Ressourcengruppe aus, die den App-Dienst enthält, in den Sie die Konfiguration exportieren möchten.	my-resource-group
   Resource	Wählen Sie den App-Dienst aus, in den Sie die Konfiguration exportieren möchten.	my-app-service

6. Füllen Sie optional den nächsten Teil des Formulars aus:

   Parameter	BESCHREIBUNG	Beispiel
   Präfix entfernen	Optional. Wenn angegeben, wird das Präfix aus den Schlüsselnamen aller exportierten Schlüsselwerte, die es enthalten, entfernt wird.	TestApp:

7. Wählen Sie Anwenden aus, um den Export fortzusetzen.

Sie haben Schlüsselwerte ab dem 28. Juli 2022 um 12 Uhr aus einem App-Konfigurationsspeicher exportiert, wobei die Schlüsselnamen beginnend mit TestApp: und der Bezeichnung prod auf die Anwendungseinstellungen einer App Service-Ressource angewendet werden. Das Präfix TestApp: wurde aus exportierten Schlüsselnamen entfernt.

Wenn Sie das Kontrollkästchen zum Exportieren von Schlüsselwerten als Verweise aktiviert haben, werden die exportierten Schlüsselwerte in der Spalte „Quelle“ Ihrer App Service-Ressourcenkonfigurationseinstellungen als App Configuration-Verweise angegeben.

Azure-Befehlszeilenschnittstelle

Führen Sie die nachstehenden Schritte in der Azure CLI aus. Ist die Azure CLI bei Ihnen nicht lokal installiert, können Sie optional Azure Cloud Shell verwenden.

1. Geben Sie den Exportbefehl az appconfig kv export ein, und geben Sie die folgenden Parameter ein:

   Parameter	BESCHREIBUNG	Beispiel
   --name	Geben Sie den Namen des App Configuration-Speichers ein, der die zu exportierenden Schlüsselwerte enthält.	my-app-config-store
   --destination	Geben Sie appservice ein, um anzugeben, dass Sie Daten in App Service exportieren.	appservice
   --appservice-account	Geben Sie die ARM-ID des App Service ein, oder verwenden Sie seinen Namen, wenn er sich im selben Abonnement und derselben Ressourcengruppe wie App Configuration befindet.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service oder my-app-service
   --label	Optional. Geben Sie eine Bezeichnung ein, um Schlüsselwerte und Featureflags mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featureflags ohne Bezeichnung.	prod

   Um den Wert für --appservice-account abzurufen, verwenden Sie den Befehl az webapp show --resource-group <resource-group> --name <resource-name>.

2. Fügen Sie optional auch ein Präfix hinzu:

   Parameter	BESCHREIBUNG	Beispiel
   --prefix	Optional. Das von der „key“-Eigenschaft eines exportierten Schlüsselwerts zu kürzende Präfix. Ein Schlüsselpräfix ist der Anfangsteil eines Schlüssels. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden.	TestApp:

   Beispiel: Exportieren aller Schlüsselwerte mit der Bezeichnung „prod“ in eine App Service-Anwendung und Kürzen des Präfixes „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:
   

   Die Befehlszeile zeigt eine Liste der Schlüsselwerte an, die in eine App Service-Ressource exportiert werden. Bestätigen Sie den Export, indem Sie y auswählen.

   

   Sie haben alle Schlüsselwerte mit der Bezeichnung „prod“ in eine Azure App Service-Ressource exportiert und das Präfix „TestApp:“ gekürzt.

3. Geben Sie optional ein Flag an, damit als App Configuration-Verweis exportiert wird.

   Parameter	BESCHREIBUNG
   --export-as-reference -r	Optional. Geben Sie an, ob Schlüsselwerte als App Configuration-Verweise in App Service exportiert werden. Weitere Informationen

   Beispiel: Exportieren aller Schlüsselwerte mit der Bezeichnung „prod“ als App Configuration-Verweise in eine App Service-Anwendung.

   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
   

   Die Befehlszeile zeigt eine Liste der Schlüsselwerte an, die als App Configuration-Verweise in eine App Service-Ressource exportiert werden. Bestätigen Sie den Export, indem Sie y auswählen.

   

   Sie haben alle Schlüsselwerte mit der Bezeichnung „prod“ als App Configuration-Verweise in eine Azure App Service-Ressource exportiert. In Ihrer App Service-Ressource werden die importierten Schlüsselwerte in der Spalte „Quelle“ als App Configuration-Verweise angegeben.

   

Weitere optionale Parameter und Beispiele finden Sie unteraz appconfig kv export.

Fehlermeldungen

Beim Importieren oder Exportieren von App Configuration-Schlüsselwerten können die folgenden Fehlermeldungen auftreten:

• Öffentlicher Zugriff ist für Ihren Speicher deaktiviert, oder Sie greifen von einem privaten Endpunkt aus zu, der sich nicht in den Konfigurationen des privaten Endpunkts des Speichers befindet. Wenn Ihr App-Konfigurationsspeicher private Endpunkte aktiviert hat, können Sie standardmäßig nur über das konfigurierte virtuelle Netzwerk darauf zugreifen. Stellen Sie sicher, dass der Computer, auf dem das Azure-Portal oder die CLI ausgeführt wird, mit demselben virtuellen Netzwerk wie der private Endpunkt verbunden ist. Wenn Sie nur den Zugriff auf das öffentliche Netzwerk für Ihren App-Konfigurationsspeicher aktiviert haben, warten Sie mindestens 5 Minuten, bevor Sie erneut versuchen, den Cache zu aktualisieren.

Nächste Schritte

Integrieren in eine CI/CD-Pipeline