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 per App Configuration. Wenn Sie eine fortlaufende Synchronisierung mit Ihrem GitHub-Repository einrichten möchten, sehen Sie sich GitHub Actions und Azure Pipelines-Aufgaben an.

Sie können Daten entweder mit dem Azure-Portal oder über die Azure CLI importieren oder exportieren.

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.

Hinweis

Das Importieren von Featureflags aus einer Datei wird nicht unterstützt. Wenn eine Konfigurationsdatei Featureflags enthält, werden sie automatisch als reguläre Schlüsselwerte importiert.

Portal

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

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

   

2. Wählen Sie auf der Registerkarte Importieren unter Quelldienst die Option Konfigurationsdatei aus.

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

   Parameter	BESCHREIBUNG	Beispiel
   Für Sprache	Wählen Sie die Sprache der importierten Datei aus: .NET, Java (Spring) oder eine andere Sprache.	.NET
   Dateityp	Wählen Sie den Typ der importierten Datei aus: YAML, Eigenschaftendatei oder JSON.	Json

4. Wählen Sie das Symbol Ordner aus, und greifen Sie auf die zu importierende Datei zu.

   Hinweis

   Eine Meldung wird auf dem Bildschirm angezeigt, die angibt, dass die Datei erfolgreich abgerufen wurde.

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

   Parameter	BESCHREIBUNG	Beispiel
   Trennzeichen	Das Trennzeichen ist das Zeichen, das in Ihrer importierten Konfigurationsdatei analysiert wird, um Schlüsselwerte zu trennen, die Ihrem Konfigurationsspeicher hinzugefügt werden. Wählen Sie eine der folgenden Optionen aus: ., ,, :, ;, /, -, _, —.	;
   Präfix	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. Das eingegebene Präfix wird am Anfang der „key“-Eigenschaft jedes Schlüsselwerts angefügt, den Sie aus dieser Datei importieren.	TestApp:
   Bezeichnung	Optional. Wählen Sie eine vorhandene Bezeichnung aus, oder geben Sie eine neue Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird.	prod
   Inhaltstyp	Optional. Geben Sie an, ob Sie eine JSON-Datei oder Key Vault-Verweise importieren. Weitere Informationen zu Key Vault-Verweisen finden Sie unter Tutorial: Verwenden von Key Vault-Verweisen in einer ASP.NET Core-App.	JSON (application/json)

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

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.

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“ sowie 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 im Menü Vorgänge die Option Importieren/Exportieren aus.

   

2. Wählen Sie auf der Registerkarte Importieren unter Quelldienst die Option App Configuration aus.

3. Wählen Sie Ressource auswählen aus, füllen Sie das Formular mit den folgenden Parametern aus, und wählen Sie Anwenden 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

   Hinweis

   Die Meldung „Zugriffsschlüssel erfolgreich abgerufen“ gibt an, dass die Verbindung mit dem App Configuration-Speicher erfolgreich war.

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

   Parameter	BESCHREIBUNG	Beispiel
   Quellbezeichnung	Wählen Sie mindestens eine Bezeichnung aus, um Werte mit den entsprechenden Bezeichnungen zu importieren. Die Option Alle auswählen importiert Schlüsselwerte mit beliebiger Bezeichnung, und (Keine Bezeichnung) beschränkt den Import auf Schlüsselwerte ohne Bezeichnung.	prod
   Zu einem bestimmten Zeitpunkt	Optional. Geben Sie einen Wert an, um Schlüsselwerte von einem bestimmten Zeitpunkt zu importieren. Dies ist der Zeitpunkt der Schlüsselwerte im ausgewählten Konfigurationsspeicher. Format: „YYYY-MM-DDThh:mm:ssZ“. Dieses Feld wird standardmäßig auf den aktuellen Zeitpunkt der Schlüsselwerte festgelegt, wenn nicht ausgefüllt wird.	07/28/2022 12:00:00 AM
   Außerkraftsetzen von Standardbezeichnungen für Schlüsselwerte	Optional. Standardmäßig verwenden importierte Elemente ihre aktuelle Bezeichnung. Aktivieren Sie das Kontrollkästchen, und geben Sie eine Bezeichnung ein, um diese Standardeinstellungen mit einer benutzerdefinierten Bezeichnung außer Kraft zu setzen.	new
   Außerkraftsetzen von Standardinhaltstypen für Schlüsselwerte	Optional. Standardmäßig verwenden importierte Elemente ihren aktuellen Inhaltstyp. Aktivieren Sie das Kontrollkästchen, und wählen Sie Key Vault-Verweis oder JSON (application/json) unter Inhaltstyp aus, 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 „application/vnd.microsoft.appconfig.ff+json;charset=utf-8“ und wird von diesem Parameter nicht aktualisiert.	JSON (application/json)

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

Sie haben Schlüsselwerte und Featureflags mit der Bezeichnung „prod“ aus einem App Configuration-Speicher am 28. Januar 2021 um 12 Uhr importiert und ihnen die Bezeichnung „new“ zugewiesen. Für alle Schlüsselwerte, die Sie importiert haben, wurde der Inhaltstyp auf „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 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 im Menü Vorgänge die Option Importieren/Exportieren aus.

   

2. Wählen Sie auf der Registerkarte Importieren unter Quelldienst die Option App Services aus.

3. Wählen Sie Ressource auswählen aus, füllen Sie das Formular mit den folgenden Parametern aus, und wählen Sie Anwenden 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

   Hinweis

   Eine Meldung wird angezeigt, die die Anzahl der Schlüsselwerte angibt, die erfolgreich aus der App Service-Quellressource abgerufen wurden.

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

   Parameter	BESCHREIBUNG	Beispiel
   Präfix	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:
   Bezeichnung	Optional. Wählen Sie eine vorhandene Bezeichnung aus, oder geben Sie eine neue Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird.	prod
   Inhaltstyp	Optional. Geben Sie an, ob die von Ihnen importierte Datei ein Key Vault-Verweis oder eine JSON-Datei ist. Weitere Informationen zu Key Vault-Verweisen finden Sie unter Tutorial: Verwenden von Key Vault-Verweisen in einer ASP.NET Core-App.	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 „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 die folgenden Schritte aus, um Konfigurationsdaten aus einem App Configuration-Speicher in eine JSON-, YAML- oder Eigenschaftendatei zu exportieren.

Hinweis

Das Exportieren von Featureflags aus einem App Configuration-Speicher in eine Konfigurationsdatei wird derzeit nur in der CLI 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 aus.

   

2. Wählen Sie auf der Registerkarte Exportieren unter Zieldienst die Option Konfigurationsdatei aus.

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

   Parameter	BESCHREIBUNG	Beispiel
   Präfix	Optional. Dieses Präfix wird von der „key“-Eigenschaft jedes Schlüsselwerts gekürzt. 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:
   Quellbezeichnung	Wählen Sie eine vorhandene Bezeichnung aus, um den Export auf Schlüsselwerte mit einer bestimmten Bezeichnung zu beschränken. Wenn Sie keine Bezeichnung auswählen, werden standardmäßig nur Schlüsselwerte mit der Bezeichnung „Keine Bezeichnung“ exportiert. Siehe Hinweis weiter unten.	prod
   Zu einem bestimmten Zeitpunkt	Optional. Geben Sie einen Wert an, um Schlüsselwerte von einem bestimmten Zeitpunkt zu importieren. Dies ist der Zeitpunkt der Schlüsselwerte im ausgewählten Konfigurationsspeicher. Format: „YYYY-MM-DDThh:mm:ssZ“. Dieses Feld wird standardmäßig auf den aktuellen Zeitpunkt der Schlüsselwerte festgelegt, wenn nicht ausgefüllt wird.	07/28/2022 12:00:00 AM
   Dateityp	Wählen Sie den Typ der exportierten Datei aus: YAML, Eigenschaften oder JSON.	JSON
   Trennzeichen	Das Trennzeichen wird für die Vereinfachung der Schlüsselwerte in das JSON-/YAML-Format verwendet. Es unterstützt die hierarchische Struktur der Konfiguration und gilt nicht für Eigenschaftendateien und Featureflags. Wählen Sie eine der folgenden Optionen aus: ., ,, :, ;, /, -, _, — oder (Kein Trennzeichen).	;

   Wichtig

   Wenn Sie keine Von-Bezeichnung auswählen, werden nur Schlüssel ohne Bezeichnungen exportiert. Um einen Schlüsselwert mit einer Bezeichnung zu exportieren, müssen Sie dessen Bezeichnung auswählen. Beachten Sie, dass Sie nur eine Bezeichnung pro Export im Portal auswählen können. Falls Sie die Schlüsselwerte mit allen angegebenen Bezeichnungen exportieren möchten, verwenden Sie CLI.

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

Sie haben Schlüsselwerte mit der Bezeichnung „prod“ aus einer Konfigurationsdatei in ihrem Zustand vom 28.07.2021, 0 Uhr, exportiert, und das Präfix „TestApp“ gekürzt. Die Werte sind durch „;“ in der Datei getrennt.

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 dem 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 auf der Registerkarte Exportieren unter Zieldienst die Option App Configuration aus.

3. Wählen Sie Ressource auswählen aus, füllen Sie das Formular mit den folgenden Parametern aus, und wählen Sie Anwenden 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.	my-resource-group
   Resource	Wählen Sie den App Configuration-Speicher aus, der die Konfiguration enthält, die Sie importieren möchten.	my-app-config-store

4. Auf der Seite werden nun der ausgewählte Zieldienst und die Ressourcen-ID angezeigt. Mit der Aktion Ressource auswählen können Sie zu einem anderen App Configuration-Quellspeicher wechseln.

   Hinweis

   Eine Meldung wird auf dem Bildschirm angezeigt, die angibt, dass die Schlüsselwerte erfolgreich abgerufen wurden.

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

   Parameter	BESCHREIBUNG	Beispiel
   Quellbezeichnung	Wählen Sie mindestens eine Bezeichnung aus, um Werte mit den entsprechenden Bezeichnungen zu exportieren. Die Option Alle auswählen exportiert Schlüsselwerte mit beliebiger Bezeichnung, und (Keine Bezeichnung) beschränkt den Export auf Schlüsselwerte ohne Bezeichnung.	prod
   Zu einem bestimmten Zeitpunkt	Optional. Geben Sie einen Wert an, um Schlüsselwerte von einem bestimmten Zeitpunkt zu importieren. Dies ist der Zeitpunkt der Schlüsselwerte im ausgewählten Konfigurationsspeicher. Format: „YYYY-MM-DDThh:mm:ssZ“. Dieses Feld wird standardmäßig auf den aktuellen Zeitpunkt der Schlüsselwerte festgelegt, wenn nicht ausgefüllt wird.	07/28/2022 12:00:00 AM
   Außerkraftsetzen von Standardbezeichnungen für Schlüsselwerte	Optional. Standardmäßig verwenden importierte Elemente ihre aktuelle Bezeichnung. Aktivieren Sie das Kontrollkästchen, und geben Sie eine Bezeichnung ein, um diese Standardeinstellungen mit einer benutzerdefinierten Bezeichnung außer Kraft zu setzen.	new

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

Sie haben Schlüsselwerte und Featureflags mit der Bezeichnung „prod“ aus einem App Configuration-Speicher im Zustand vom 28.07.2022, 0 Uhr, exportiert und ihnen die Bezeichnung „new“ 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 derzeit 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 im Menü Vorgänge die Option Importieren/Exportieren aus.

   

2. Wählen Sie auf der Registerkarte Exportieren unter Zieldienst die Option App Services aus.

3. Wählen Sie Ressource auswählen aus, füllen Sie das Formular mit den folgenden Parametern aus, und wählen Sie Anwenden 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 exportierenden Konfiguration enthält.	my-resource-group
   Resource	Wählen Sie den App Service aus, der die Konfiguration enthält, die Sie exportieren möchten.	my-app-service

4. Auf der Seite werden nun der ausgewählte Zieldienst und die Ressourcen-ID angezeigt. Mit der Aktion Ressource auswählen können Sie zu einer anderen App Service-Zielressource wechseln.

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

   Parameter	BESCHREIBUNG	Beispiel
   Präfix	Optional. Dieses Präfix wird von der „key“-Eigenschaft jedes exportierten Schlüsselwerts gekürzt. 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:
   Als Verweis exportieren	Optional. Aktivieren Sie diese Option, um Schlüsselwerte als App Configuration-Verweise in App Service zu exportieren. Weitere Informationen
   Zu einem bestimmten Zeitpunkt	Optional. Geben Sie einen Wert an, um Schlüsselwerte von einem bestimmten Zeitpunkt zu exportieren. Dies ist der Zeitpunkt der Schlüsselwerte im ausgewählten Konfigurationsspeicher. Format: „YYYY-MM-DDThh:mm:ssZ“. Dieses Feld wird standardmäßig auf den aktuellen Zeitpunkt der Schlüsselwerte festgelegt, wenn nicht ausgefüllt wird.	07/28/2022 12:00:00 AM
   Quellbezeichnung	Optional. Wählen Sie eine vorhandene Bezeichnung aus, um den Export auf Schlüsselwerte mit einer bestimmten Bezeichnung zu beschränken. Wenn Sie keine Bezeichnung auswählen, werden nur Schlüsselwerte mit der Bezeichnung „Keine Bezeichnung“ exportiert.	prod

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

Sie haben Schlüsselwerte mit der Bezeichnung „prod“ aus einer App Service-Ressource in ihrem Zustand vom 28.07.2021, 0 Uhr, exportiert, und das Präfix „TestApp“ gekürzt. Die Schlüsselwerte wurden mit einem Inhaltstyp im JSON-Format exportiert.

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:

• Ausgewählte Datei muss zwischen 1 und 2097152 Bytes sein.: Ihre Datei ist zu groß. Wählen Sie eine kleinere Datei aus.
• Ö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. Um Schlüsselwerte aus einem App Configuration-Speicher zu importieren, müssen Sie Zugriff auf diesen Speicher haben. Aktivieren Sie bei Bedarf den öffentlichen Zugriff für den Quellspeicher, oder greifen Sie von einem genehmigten privaten Endpunkt aus darauf zu. Wenn Sie den öffentlichen Zugriff gerade erst aktiviert haben, warten Sie bis zu 5 Minuten, bis der Cache aktualisiert wird.

Nächste Schritte

Integrieren in eine CI/CD-Pipeline