Importieren oder Exportieren von Konfigurationsdaten

Azure App-Konfiguration unterstützt Datenimport- und Exportvorgänge. Verwenden Sie diese Vorgänge, um mit Konfigurationsdaten in Massen zu arbeiten und Daten zwischen Ihrem App-Konfigurationsspeicher und Codeprojekt auszutauschen. Sie können z. B. einen App-Konfigurationsspeicher für Tests und einen anderen für die Produktion einrichten. Sie können Anwendungseinstellungen zwischen ihnen kopieren, sodass Sie keine Daten 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 die Konfiguration als Code übernommen und Ihre Konfigurationen in GitHub oder Azure DevOps verwaltet haben, können Sie den import von fortlaufenden Konfigurationsdateien mithilfe von GitHub-Aktionen einrichten oder die Azure Pipeline Import Task verwenden.

Importieren von Daten

Der Import führt Konfigurationsdaten aus einer vorhandenen Quelle in einen App-Konfigurationsspeicher ein. Verwenden Sie die Importfunktion, um Daten in einen App-Konfigurationsspeicher zu migrieren oder Daten aus mehreren Quellen zu aggregieren.

In diesem Handbuch wird gezeigt, wie Sie App-Konfigurationsdaten importieren:

• aus einer Konfigurationsdatei in JSON, YAML oder Eigenschaften
• aus einem Anwendungs-Konfigurationsspeicher
• aus Azure App Service
• aus Azure Kubernetes Service ConfigMaps

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 zum App-Konfigurationsspeicher, und wählen Sie im Menü "Vorgänge" die Option "Importieren/Exportieren" aus.

   

2. Das Radio Button "Importieren" ist standardmäßig ausgewählt. Wählen Sie unter "Quelltyp" die Option "Konfigurationsdatei" aus.

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

   Parameter	Description	Example
   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	Description	Example
   Dateiinhaltsprofil	Wählen Sie ein Inhaltsprofil aus: Standard oder KVSet. Das Standarddateiinhaltsprofil bezieht sich auf das herkömmliche Konfigurationsdateischema, das von vorhandenen Programmierframeworks oder Systemen weit verbreitet wird, unterstützt JSON-, YAML- oder Properties-Dateiformate. Das KVSet-Dateiinhaltsprofil bezieht sich auf ein Dateischema, das alle Eigenschaften eines App-Konfigurationsschlüsselwerts enthält, einschließlich Schlüssel, Wert, Bezeichnung, Inhaltstyp und Tags.	Vorgabe
   Importmodus	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
   Feature-Flag ausschließen	Wenn diese Option aktiviert ist, werden keine Featurekennzeichnungen importiert.	Nicht ausgewählt
   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 ausgewählt
   Trennzeichen	Die Trennlinie ist das Trennzeichen, das zum Abflachen von JSON- oder YAML-Dateien in Schlüsselwerte verwendet wird. Sie wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Unterstützte Werte sind kein Trennzeichen, Punkt (.), Komma (,), Semikolon (;), Bindestrich (-), Unterstrich (_), Doppelter Unterstrich (_), Schrägstrich (/) und Doppelpunkt (:)).	:
   Tiefe	Wahlfrei. 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	Wahlfrei. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Bezeichnung hinzufügen	Wahlfrei. Wenn angegeben, wird die angegebene Bezeichnung allen importierten Schlüsselwerten zugewiesen.	prod
   Inhaltstyp hinzufügen	Wahlfrei. Wenn angegeben, wird der bereitgestellte Inhaltstyp allen importierten Schlüsselwerten hinzugefügt.	JSON (application/json)
   Hinzufügen von Tags	Wahlfrei. Wenn angegeben, werden die bereitgestellten Tags allen importierten Schlüsselwerten hinzugefügt.	{tag: 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 dem Präfix TestApp: versehen. Alle importierten Schlüsselwerte sind als prod gekennzeichnet, haben einen Inhaltstyp von application/json, und sind mit tag: tag1 markiert.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie die Eingabetaste file ein, um anzugeben, dass Sie App-Konfigurationsdaten aus einer Datei importieren.	file
   --path	Geben Sie den lokalen Pfad zu der Datei ein, die die zu importierenden Daten enthält.	C:/Users/john/Downloads/data.json
   --format	Geben Sie Yaml, Eigenschaften oder JSON ein, um das Format der zu importierenden Datei anzugeben.	json

2. Fügen Sie optional auch die folgenden Parameter hinzu:

   Parameter	Description	Example
   --separator	Wahlfrei. Das Trennzeichen wird zur Vereinfachung der Schlüsselwerte in das JSON-/YAML-Format verwendet. Sie ist für den Export hierarchischer Struktur erforderlich und wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Wählen Sie eine der folgenden Optionen aus: ., , ,, :, ;, /, -, . _—	;
   --prefix	Wahlfrei. Ein Schlüsselpräfix ist der Anfangteil eines Schlüssels. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Dieses Präfix wird an die Vorderseite der Eigenschaft "key" jedes importierten Schlüsselwerts angefügt.	TestApp:
   --label	Wahlfrei. Geben Sie eine Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird.	prod
   --content-type	Wahlfrei. Geben Sie appconfig/kvset oder application/json ein, um anzugeben, dass der importierte Inhalt aus einem Schlüsseltresorverweis oder einer JSON-Datei besteht.	application/json

   Beispiel: Importieren Sie alle Schlüsselwerte und Featurekennzeichnungen aus einer JSON-Datei, wenden Sie die Bezeichnung "prod" an, und fügen Sie das Präfix "TestApp" an. 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. In der Befehlszeile wird eine Liste der bevorstehenden Änderungen angezeigt. Bestätigen Sie den Import, indem Sie die Option auswählen y.

   

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 alle von Ihnen importierten Schlüsselwerte haben den Inhaltstyp als "JSON" festgelegt.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv import.

Importieren von Daten aus einem App-Konfigurationsspeicher

Sie können Werte aus einem App-Konfigurationsspeicher in einen anderen App-Konfigurationsspeicher importieren oder Werte aus einem App-Konfigurationsspeicher in denselben App-Konfigurationsspeicher importieren, um ihre Werte zu duplizieren und unterschiedliche Parameter anzuwenden, z. B. neue Bezeichnung oder Inhaltstyp.

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

Portal

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

1. Navigieren Sie zum App-Konfigurationsspeicher, und wählen Sie im Menü "Vorgänge" die Option "Importieren/Exportieren" aus.

   

2. Das Radio Button "Importieren" ist standardmäßig ausgewählt. Wählen Sie unter "Quelltyp" die Option "App-Konfiguration" 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	Description	Example
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	Mein Abonnement
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe aus, die den App-Konfigurationsspeicher mit der zu importierenden Konfiguration enthält. Ihre aktuelle Ressourcengruppe ist standardmäßig ausgewählt.	my-resource-group
   Resource	Wählen Sie den App-Konfigurationsspeicher aus, der die zu importierende Konfiguration enthält.	mein-andere-app-konfigurations-speicher

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

   Parameter	Description	Example
   Auswahlmodus	Wählen Sie aus, ob Sie von regulären Schlüsselwerten, was die Standardoption ist, oder von einer Momentaufnahme importieren möchten.	Vorgabe
   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	Wahlfrei. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu importieren. Wenn sie leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	28.07.2022 12:00:00 Uhr
   Aus Etikett	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
   Feature-Flag ausschließen	Wenn diese Option aktiviert ist, werden keine Featurekennzeichnungen importiert.	Nicht ausgewählt
   Präfix hinzufügen	Wahlfrei. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Überschreiben von Bezeichnungen	Wahlfrei. 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.	Neu
   Überschreiben von Inhaltstypen	Wahlfrei. 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 am 28. Januar 2021 um 0 Uhr Schlüsselwerte aus einem App-Konfigurationsspeicher importiert, wobei die Schlüsselnamen mit test beginnen und das Label prod lautet. Die Schlüsselnamen wurden dem Präfix vorangestellt TestApp:. Allen importierten Schlüsselwerten wurden die Bezeichnung new und der Inhaltstyp application/jsonzugewiesen.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie die Eingabetaste appconfig ein, um anzugeben, dass Sie Daten aus einem App-Konfigurationsspeicher importieren.	appconfig
   --src-name	Geben Sie den Namen des App-Konfigurationsspeichers ein, aus dem Sie Daten importieren möchten.	my-source-app-config
   --src-label	Beschränken Sie den Import auf Schlüsselwerte mit einer bestimmten Bezeichnung. Wenn Sie diesen Parameter nicht verwenden, werden nur Schlüsselwerte mit einer NULL-Bezeichnung importiert. Unterstützt Sternchen als Filter: Geben Sie * für alle Labels ein; abc* für alle Labels mit abc als Präfix.	prod

2. Fügen Sie optional die folgenden Parameter hinzu:

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

   Beispiel: Importieren Sie Schlüsselwerte und Featurekennzeichnungen mit der Bezeichnung "prod" aus einer anderen App-Konfiguration, und weisen Sie sie der Bezeichnung "neu" zu. 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. In der Befehlszeile wird eine Liste der bevorstehenden Änderungen angezeigt. Bestätigen Sie den Import, indem Sie die Option auswählen y.

   

Sie haben Schlüsselwerte mit der Bezeichnung "prod" aus einem App-Konfigurationsspeicher importiert und ihnen die Bezeichnung "neu" zugewiesen. Alle von Ihnen importierten Schlüsselwerte haben den Inhaltstyp als "JSON" festgelegt.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az 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 Featurekennzeichnungen. Alle in App Service importierten Featurekennzeichnungen 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 zum App-Konfigurationsspeicher, und wählen Sie im Menü "Vorgänge" die Option "Importieren/Exportieren" aus.

   

2. Das Radio Button "Importieren" ist standardmäßig ausgewählt. Wählen Sie unter "Quelltyp" "App-Dienste" 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	Description	Example
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	Mein Abonnement
   Ressourcengruppe	Wählen Sie eine Ressourcengruppe aus, die den App-Dienst mit der zu importierenden Konfiguration enthält.	my-resource-group
   Resource	Wählen Sie den App-Dienst aus, der die zu importierende Konfiguration enthält.	my-app-service

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

   Parameter	Description	Example
   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 finden Sie unter Verwenden von App-Konfigurationsreferenzen für App Service und Azure-Funktionen.	Überprüft
   Präfix hinzufügen	Wahlfrei. Wenn angegeben, wird dem Schlüsselnamen aller importierten Schlüsselwerte ein Präfix hinzugefügt.	TestApp:
   Bezeichnung hinzufügen	Wahlfrei. Wenn angegeben, wird die angegebene Bezeichnung allen importierten Schlüsselwerten zugewiesen.	prod
   Inhaltstyp hinzufügen	Wahlfrei. 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. Alle von Ihnen importierten Schlüsselwerte haben den Inhaltstyp als application/jsonfestgelegt.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie die Eingabetaste appservice ein, um anzugeben, dass Sie App-Konfigurationsdaten aus Azure App Service importieren.	appservice
   --appservice-account	Geben Sie die ARM-ID des App-Diensts ein, oder verwenden Sie den Namen des App-Diensts, wenn sie sich in derselben Abonnement- und Ressourcengruppe wie die App-Konfiguration befindet.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service oder my-app-service

2. Fügen Sie optional auch die folgenden Parameter hinzu:

   Parameter	Description	Example
   --prefix	Wahlfrei. Ein Schlüsselpräfix ist der Anfangsteil der Schlüsseleigenschaft eines Schlüsselwerts. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Dieses Präfix wird an die Vorderseite der Eigenschaft "key" jedes importierten Schlüsselwerts angefügt.	TestApp:
   --label	Wahlfrei. 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	Wahlfrei. 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-accountabzurufen, verwenden Sie den Befehl az webapp show --resource-group <resource-group> --name <resource-name>.

   Beispiel: Importieren Sie alle Anwendungseinstellungen aus Ihrem App-Dienst als Schlüsselwerte mit der Bezeichnung "prod", in Ihren App-Konfigurationsspeicher, und fügen Sie ein Präfix "TestApp:" hinzu.

   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. In der Befehlszeile wird eine Liste der bevorstehenden Änderungen angezeigt. Bestätigen Sie den Import, indem Sie die Option auswählen y.

   

Sie haben alle Anwendungseinstellungen aus Ihrem App Service als Schlüsselwerte importiert, ihnen die Bezeichnung "prod" zugewiesen und ein Präfix "TestApp:" hinzugefügt. Alle von Ihnen importierten Schlüsselwerte haben den Inhaltstyp als "JSON" festgelegt.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv import.

Importieren von Daten aus Azure Kubernetes Service ConfigMaps

Führen Sie die folgenden Schritte aus, um Schlüsselwerte aus Azure Kubernetes Service ConfigMaps zu importieren. Die Portalunterstützung für dieses Feature befindet sich in der Entwicklung, verwenden Sie bitte Azure CLI, um aus AKS zu importieren.

Portal

Die Azure-Portalunterstützung für dieses Feature befindet sich in der Entwicklung.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, in den Sie Daten importieren möchten.	my-app-config-store
   --source	Geben Sie aks ein, um anzugeben, dass Sie App-Konfigurationsdaten aus dem Azure Kubernetes Service importieren.	aks
   --aks-cluster	Geben Sie die ARM-ID des Azure Kubernetes-Diensts ein, oder verwenden Sie den Namen des Azure Kubernetes-Diensts, wenn er sich in derselben Abonnement- und Ressourcengruppe wie die App-Konfiguration befindet.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster oder my-aks-cluster
   --configmap-namespace	Geben Sie den Namespace der ConfigMap ein, die Sie importieren möchten.	default
   --configmap-name	Geben Sie den Namen der ConfigMap ein, die Sie importieren möchten.	my-configmap

2. Fügen Sie optional auch die folgenden Parameter hinzu:

   Parameter	Description	Example
   --prefix	Wahlfrei. Ein Schlüsselpräfix ist der Anfangsteil der Schlüsseleigenschaft eines Schlüsselwerts. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden. Dieses Präfix wird an die Vorderseite der Eigenschaft "key" jedes importierten Schlüsselwerts angefügt.	TestApp:
   --label	Wahlfrei. Geben Sie eine Bezeichnung ein, die Ihren importierten Schlüsselwerten zugewiesen wird. Wenn Sie keine Bezeichnung angeben, wird Ihren Schlüsselwerten die Nullbezeichnung zugewiesen.	test
   --content-type	Wahlfrei. 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
   --format	Wahlfrei. Geben Sie Yaml, Eigenschaften oder JSON ein, um das Format von ConfigMap anzugeben, das Sie importieren.	json
   --separator	Wahlfrei. Das Trennzeichen dient als Delimiter zum Vereinfachen der Schlüsselwerte. Sie ist für den Export hierarchischer Struktur erforderlich und wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Wählen Sie eine der folgenden Optionen aus: ., , ,, :, ;, /, -, . _—	;

   Um den Wert für --aks-clusterabzurufen, verwenden Sie den Befehl az aks show --resource-group <resource-group> --name <aks-cluster-name>.

   Beispiel: Importieren Sie alle Einstellungen aus Ihrer AKS Configmap als Schlüsselwerte mit der Bezeichnung "test", in Ihren App-Konfigurationsspeicher, und fügen Sie ein Präfix "TestApp:" hinzu.

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. In der Befehlszeile wird eine Liste der bevorstehenden Änderungen angezeigt. Bestätigen Sie den Import, indem Sie die Option auswählen y.

   

Sie haben alle Einstellungen aus Ihrer AKS ConfigMap als Schlüsselwerte importiert, ihnen die Bezeichnung "test" zugewiesen und ein Präfix "TestApp:" hinzugefügt.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv import.

Datenexport

Exportiert Konfigurationsdaten, die in der App-Konfiguration gespeichert sind, in ein anderes Ziel. Verwenden Sie beispielsweise die Exportfunktion, um Daten aus einem App-Konfigurationsspeicher in einer Datei zu speichern, die während der Bereitstellung in Ihren Anwendungscode eingebettet werden kann.

In diesem Handbuch wird gezeigt, wie Sie App-Konfigurationsdaten exportieren:

• zu einer Konfigurationsdatei in JSON, YAML oder Eigenschaften
• zu einem App-Konfigurationsstore
• zu einer Azure App Service-Ressource

Exportieren von Daten in eine Konfigurationsdatei

Führen Sie die folgenden 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-Konfigurationsspeicher, und wählen Sie "Importieren/Exportieren" aus.

   

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

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

   Parameter	Description	Example
   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 bezieht sich auf das herkömmliche Konfigurationsdateischema, das von vorhandenen Programmierframeworks oder Systemen weit verbreitet wird, unterstützt JSON-, YAML- oder Properties-Dateiformate. Das KVSet-Dateiinhaltsprofil bezieht sich auf ein Dateischema, das alle Eigenschaften eines App-Konfigurationsschlüsselwerts enthält, einschließlich Schlüssel, Wert, Bezeichnung, Inhaltstyp und Tags.	Vorgabe
   Auswahlmodus	Wählen Sie, ob Sie aus regulären Schlüsselwerten exportieren möchten, was die Standardoption ist, oder aus einer Momentaufnahme.	Vorgabe
   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	Wahlfrei. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn sie leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	28.07.2022 12:00:00 Uhr
   Aus Etikett	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	Wahlfrei. Wenn angegeben, wird das Präfix aus den Schlüsselnamen aller exportierten Schlüsselwerte entfernt, die es enthalten.	TestApp:
   Trennzeichen	Das Trennzeichen ist der Delimiter, der zum Segmentieren von Schlüsselnamen und zum Rekonstruieren hierarchischer Konfigurationen für JSON- oder YAML-Dateien aus Schlüsselwerten verwendet wird. Sie wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Unterstützte Werte enthalten 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 am 28. Juli 2021 um 12 Uhr Schlüsselwerte aus einem App-Konfigurationsspeicher exportiert, wobei die Schlüsselnamen mit TestApp: und die Bezeichnung mit prod beginnen, in eine JSON-Datei. Das Präfix TestApp: wurde von Schlüsselnamen gekürzt, und das Trennzeichen : wurde verwendet, um die Schlüsselnamen zu segmentieren und das hierarchische JSON-Format zu rekonstruieren.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, der die Schlüsselwerte enthält, die Sie exportieren möchten.	my-app-config-store
   --destination	Geben Sie die Eingabetaste file ein, um anzugeben, dass Sie Daten in eine Datei exportieren.	file
   --path	Geben Sie den Pfad ein, in dem Sie die Datei speichern möchten.	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 Featurekennzeichnungen mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featurekennzeichnungen ohne Bezeichnung. Sie können ein Etikett eingeben, mehrere Etiketten eingeben, indem Sie sie mit , trennen, oder * verwenden, um alle Etiketten zu berücksichtigen.	prod

   Von Bedeutung

   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. Fügen Sie optional auch die folgenden Parameter hinzu:

   Parameter	Description	Example
   --separator	Wahlfrei. Das Trennzeichen wird zur Vereinfachung der Schlüsselwerte in das JSON-/YAML-Format verwendet. Sie ist für den Export hierarchischer Struktur erforderlich und wird für Eigenschaftendateien und Featurekennzeichnungen ignoriert. Wählen Sie eine der folgenden Optionen aus: ., , ,, :, ;, /, -, . _—	;
   --prefix	Wahlfrei. Das von der „key“-Eigenschaft jedes Schlüsselwerts zu kürzende Präfix. Ein Schlüsselpräfix ist der Anfangteil 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 Sie alle Schlüsselwerte und Featurekennzeichnungen 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. In der Befehlszeile wird eine Liste der Schlüsselwerte angezeigt, die in die Datei exportiert werden. Bestätigen Sie den Export, indem Sie y auswählen.

   

Variant-Featurekennzeichnungen werden mithilfe des Microsoft Feature Management-Schemas in eine Datei exportiert, während andere Featurekennzeichnungen mithilfe des .NET Feature Management-Schemas zur Kompatibilität exportiert werden. Wenn Sie Featurekennzeichnungen ausschließlich mithilfe des Microsoft Feature Management-Schemas exportieren möchten, legen Sie die Umgebungsvariable AZURE_APPCONFIG_FM_COMPATIBLE auf "False" fest.

Sie haben Schlüsselwerte und Featurekennzeichnungen mit der Bezeichnung "prod" in eine Konfigurationsdatei exportiert und das Präfix "TestApp" gekürzt. Werte werden in der Datei durch ";" getrennt.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv export.

Exportieren von Daten in einen App-Konfigurationsspeicher

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

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

Portal

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

1. Navigieren Sie zu Ihrem App-Konfigurationsspeicher, der die zu exportierenden Daten enthält, und wählen Sie " Importieren/Exportieren " aus dem Menü "Vorgänge " aus.

   

2. Wählen Sie die Optionsschaltfläche Export und unter Zieltyp die Option App-Konfiguration aus.

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

   Parameter	Description	Example
   Auswahlmodus	Wählen Sie, ob Sie aus regulären Schlüsselwerten exportieren möchten, was die Standardoption ist, oder aus einer Momentaufnahme.	Vorgabe
   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	Wahlfrei. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn sie leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	28.07.2022 12:00:00 Uhr
   Aus Etikett	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
   Feature-Flag ausschließen	Wenn aktiviert, werden Featurekennzeichnungen nicht exportiert.	Nicht ausgewählt

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

   Parameter	Description	Example
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	Mein Abonnement
   Ressourcengruppe	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.	mein-andere-app-konfigurations-speicher

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

   Parameter	Description	Example
   Präfix entfernen	Wahlfrei. Wenn angegeben, wird das Präfix aus den Schlüsselnamen aller exportierten Schlüsselwerte entfernt, die es enthalten.	TestApp:
   Überschreiben von Bezeichnungen	Wahlfrei. 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.	Neu
   Überschreiben von Inhaltstypen	Wahlfrei. 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 mit dem Export fortzufahren.

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 prodin einen anderen App-Konfigurationsspeicher. Alle exportierten Schlüsselwerte wurden um das Schlüsselpräfix TestApp: gekürzt und dem Label new sowie dem Inhaltstyp application/json zugewiesen.

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, der die Schlüsselwerte enthält, die Sie exportieren möchten.	my-app-config-store
   --destination	Geben Sie die Eingabetaste appconfig ein, um anzugeben, dass Sie Daten in einen App-Konfigurationsspeicher exportieren.	appconfig
   --dest-name	Geben Sie den Namen des App-Konfigurationsspeichers ein, in den Sie Daten exportieren möchten.	my-other-app-config-store
   --label	Geben Sie eine Bezeichnung ein, um Schlüsselwerte und Featurekennzeichnungen mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featurekennzeichnungen ohne Bezeichnung. Sie können ein Etikett eingeben, mehrere Bezeichnungen eingeben, indem Sie sie trennen ,oder verwenden * , um alle Bezeichnungen zu berücksichtigen.	prod

   Von Bedeutung

   Wenn die Schlüsselwerte, die Sie exportieren möchten, Beschriftungen 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 Kommazeichen (,), um mehrere Bezeichnungen auszuwählen, oder verwenden Sie *, um alle Bezeichnungen einzuschließen, einschließlich des Null-Labels (keine Bezeichnung).

2. Fügen Sie optional auch den folgenden Parameter hinzu:

   Parameter	Description	Example
   --dest-label	Wahlfrei. Geben Sie eine Zielbezeichnung ein, um diese Bezeichnung exportierten Schlüsselwerten zuzuweisen.	new

   Beispiel: Exportieren Sie Schlüsselwerte und Featurekennzeichnungen mit der Bezeichnung "prod" in einen anderen App-Konfigurationsspeicher, und fügen Sie die Zielbezeichnung "neu" hinzu.

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

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

   

Sie haben Schlüsselwerte und Featurekennzeichnungen exportiert, die die Bezeichnung "prod" aus einem App-Konfigurationsspeicher aufweisen und ihnen die Bezeichnung "neu" zugewiesen haben.

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv import.

Exportieren von Daten in Azure App Service

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

Hinweis

Das Exportieren von Featurekennzeichnungen in App Service wird nicht unterstützt.

Portal

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

1. Navigieren Sie zum App-Konfigurationsspeicher, und wählen Sie im Menü "Vorgänge" die Option "Importieren/Exportieren" aus.

   

2. Wählen Sie die Schaltfläche Export und unter Zieltyp die Option 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 App Configuration verwalten, wobei der App Service automatisch die aktuellen Werte aus App Configuration abruft. Weitere Informationen finden Sie unter Verwenden von App-Konfigurationsreferenzen für App Service und Azure-Funktionen. Wenn das Kontrollkästchen deaktiviert ist, wird 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 einnimmt.

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

   Parameter	Description	Example
   Auswahlmodus	Wählen Sie, ob Sie aus regulären Schlüsselwerten exportieren möchten, was die Standardoption ist, oder aus einer Momentaufnahme.	Vorgabe
   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	Wahlfrei. Füllen Sie dieses Feld aus, um Schlüsselwerte aus einem bestimmten Zeitpunkt im ausgewählten Konfigurationsspeicher zu exportieren. Wenn sie leer gelassen wird, wird standardmäßig der aktuelle Zeitpunkt der Schlüsselwerte angegeben.	28.07.2022 12:00:00 Uhr
   Aus Etikett	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	Description	Example
   Subscription	Ihr aktuelles Abonnement ist standardmäßig ausgewählt.	Mein Abonnement
   Ressourcengruppe	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. Geben Sie optional den nächsten Teil des Formulars aus:

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

7. Wählen Sie "Anwenden" aus, um mit dem Export fortzufahren.

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 gekürzt.

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

Azure CLI

Führen Sie in der Azure CLI die folgenden Schritte aus. Wenn Sie die Azure CLI nicht lokal installiert haben, 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	Description	Example
   --name	Geben Sie den Namen des App-Konfigurationsspeichers ein, der die Schlüsselwerte enthält, die Sie exportieren möchten.	my-app-config-store
   --destination	Geben Sie die Eingabetaste appservice ein, um anzugeben, dass Sie Daten nach App Service exportieren.	appservice
   --appservice-account	Geben Sie die ARM-ID des App-Diensts ein, oder verwenden Sie den Namen des App-Diensts, wenn sie sich in derselben Abonnement- und Ressourcengruppe wie die App-Konfiguration befindet.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service oder my-app-service
   --label	Wahlfrei. Geben Sie eine Bezeichnung ein, um Schlüsselwerte und Featurekennzeichnungen mit dieser Bezeichnung zu exportieren. Wenn Sie keine Bezeichnung angeben, exportieren Sie standardmäßig nur Schlüsselwerte und Featurekennzeichnungen ohne Bezeichnung.	prod

   Um den Wert für --appservice-accountabzurufen, 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	Description	Example
   --prefix	Wahlfrei. Das von der „key“-Eigenschaft eines exportierten Schlüsselwerts zu kürzende Präfix. Ein Schlüsselpräfix ist der Anfangteil eines Schlüssels. Präfixe können zum Verwalten von Gruppen von Schlüsselwerten in einem Konfigurationsspeicher verwendet werden.	TestApp:

   Beispiel: Exportieren Sie alle Schlüsselwerte mit der Bezeichnung "prod" in eine App Service-Anwendung, und kürzen Sie das Präfix "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:
   

   In der Befehlszeile wird eine Liste der Schlüsselwerte angezeigt, 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, das als App-Konfigurationsreferenz exportiert werden soll.

   Parameter	Description
   --export-as-reference -r	Wahlfrei. Geben Sie an, ob Schlüsselwerte als App-Konfigurationsverweise in App Service exportiert werden. Erfahren Sie mehr.

   Beispiel: Exportieren Sie alle Schlüsselwerte mit der Bezeichnung "prod" als App-Konfigurationsverweise auf eine App-Dienstanwendung.

   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
   

   In der Befehlszeile wird eine Liste der Schlüsselwerte angezeigt, die als App-Konfigurationsverweise auf 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-Konfigurationsverweise auf eine Azure App Service-Ressource exportiert. In Ihrer App Service-Ressource werden die importierten Schlüsselwerte als App-Konfigurationsverweise in der Spalte "Quelle" angegeben.

   

Für weitere optionale Parameter und Beispiele wechseln Sie zu az appconfig kv export.

Fehlermeldungen

Beim Importieren oder Exportieren von App-Konfigurationsschlüsselwerten treten möglicherweise die folgenden Fehlermeldungen auf:

• Der öffentliche Zugriff ist für Ihren Store deaktiviert, oder Sie greifen von einem privaten Endpunkt aus zu, der nicht in den Konfigurationen des privaten Endpunkts des Stores enthalten ist. 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

Integration in eine CI/CD-Pipeline