Eine Verbindung über die CLI erstellen (Vorschau)

Verwenden Sie die Power Apps Clientbibliothek für Code-Appscreate-connection, um eine Verbindung für einen Connector direkt über die Befehlszeile zu erstellen, ohne ihr Terminal zu verlassen oder Power Apps zu öffnen, wie in How to: Connect your code app to data beschrieben.

Ab Version 1.2.7 verwenden Sie den list-connectors Befehl, um Connectors anzuzeigen, die in Ihrer Umgebung verfügbar sind.

Voraussetzungen

Eine initialisierte Power-Apps-Codeanwendung. Siehe Schnellstart: Erstellen einer Code-App mithilfe der npm CLI.

Verfügbare Konnektoren auflisten

Bevor Sie eine Verbindung erstellen, verwenden Sie den list-connectors Befehl, um zu sehen, welche Connectors in Ihrer Power Platform-Umgebung verfügbar sind, und um den API-Bezeichner eines Connectors zu finden. Dies ist der Wert, den Sie an create-connection die Befehlsoption api-id übergeben.

Der list-connectors Befehl listet Connectors aus der Power Platform-Umgebung auf, auf die Ihre Code-App derzeit ausgerichtet ist. Dies ist die in power.config.json festgelegte Umgebung, als Sie power-apps init ausgeführt haben.

Verwendung

Führen Sie den Befehl aus dem Stammverzeichnis Ihres Code-App-Projekts aus:

power-apps list-connectors [--search <term>] [--json]

Options

Verwenden Sie die folgenden Optionen mit list-connectors.

Auswahl	Alias	Erforderlich	Description
--search	-s	No	Filtern Sie die Ergebnisse auf Konnektoren, deren Name oder Anzeigename dem Suchbegriff entspricht.
--json	—	No	Geben Sie die vollständige Connectorliste als JSON für Skriptszenarien aus.

Output

Standardmäßig druckt der Befehl eine Tabelle mit zwei Spalten:

Spalte	Description
Anzeigename	Der Anzeigename des Connectors, z. B. Office 365 Outlook.
Konnektor	Der eindeutige Name / API-Bezeichner des Connectors, z. B. shared_office365. Dies ist der Wert, den Sie für die Befehlsoption create-connection--api-id übergeben.

Wenn Sie den Befehl in einem interaktiven Terminal ausführen, gibt er Ergebnisse in Seiten von 20 Zeilen zurück. Drücken Sie die EINGABETASTE , um die nächste Seite anzuzeigen, oder esc/q zum Beenden. Wenn Sie die Ausgabe umleiten (nicht interaktiv) oder --json übergeben, gibt der Befehl die vollständige Liste auf einmal aus.

Die --json-Ausgabe enthält zusätzliche Felder für jeden Konnektor über die beiden Tabellenspalten hinaus:

Feld	Description
id	Die ID des Connectors.
name	Der eindeutige Name des Connectors (API-Bezeichner), zum Beispiel shared_office365.
displayName	Benutzerfreundlicher Anzeigename des Konnektors.
description	Die Beschreibung des Connectors.
isTabular	Gibt an, ob der Verbinder Tabellendatenvorgänge (Tabellen) unterstützt.

Beispiele

Alle in der aktuellen Umgebung verfügbaren Konnektoren auflisten:

power-apps list-connectors

Suchen Sie nach Konnektoren nach Namen:

power-apps list-connectors --search teams

Geben Sie die vollständige Connectorliste als JSON aus. Dies ist in Skripts und kontinuierlicher Integration (CI) nützlich:

power-apps list-connectors --json

Erstellen der Verbindung

Verwenden Sie den create-connection Befehl, um eine Verbindung für einen Verbinder direkt über die Befehlszeile zu erstellen, ohne das Terminal zu verlassen oder das Power Apps Maker-Portal zu öffnen.

Die Verbindung wird in der Power Platform-Umgebung erstellt, auf die Ihre Code-App derzeit ausgerichtet ist. Diese Umgebung wird in power.config.json festgelegt, wenn Sie power-apps init ausführen.

Verwendung

Führen Sie den Befehl aus dem Stammverzeichnis Ihres Code-App-Projekts aus:

power-apps create-connection --api-id <connectorId> [--display-name <name>] [--json]

Options

Verwenden Sie die folgenden Optionen mit create-connection.

Auswahl	Alias	Erforderlich	Description
--api-id	-a	Yes	Connector-API-Bezeichner (zum Beispiel shared_office365, shared_teams).
--display-name	-n	No	Optionaler Anzeigename für die neue Verbindung. Wenn nicht angegeben, wird ein Standardwert verwendet.
--json	—	No	Ausgabe des Ergebnisses als JSON für Skriptszenarien.

Beispiele

Erstellen einer Office 365 Verbindung:

power-apps create-connection --api-id shared_office365

Erstellen einer Teams-Verbindung mit einem benutzerdefinierten Anzeigenamen:

power-apps create-connection --api-id shared_teams --display-name "My Teams"

Erstellen Sie eine Verbindung, und geben Sie die JSON-Ausgabe aus. Dies ist in Skripts und kontinuierlicher Integration (CI) nützlich:

power-apps create-connection --api-id shared_office365 --json

Bei Erfolg druckt der Befehl die ID der neuen Verbindung. Sie können dann auf diese Verbindungs-ID verweisen, wenn Sie den Connector als Datenquelle zu Ihrer Code-App hinzufügen.