pac-Konnektor

Befehle zum Arbeiten mit Power Platform-Konnektoren

Befehle

Command	Beschreibung
pac-Konnektor erstellen	Erstellt eine neue Zeile in der Konnektor-Tabelle in Dataverse.
pac-Konnektor herunterladen	OpenApiDefinition- und API-Eigenschaftendatei eines Konnektors herunterladen
pac-Konnektor initiieren	Initialisiert eine neue API-Eigenschaftendatei für einen Konnektor
pac-Konnektorliste	Listet die in Dataverse registrierten Konnektoren auf.
pac-Konnektor aktualisieren	Aktualisiert eine Konnektorentität in Dataverse.

pac-Konnektor erstellen

Erstellt eine neue Zeile in der Konnektor-Tabelle in Dataverse.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac connector create Befehls.

• Grund-Konnektorerstellung in der aktuellen Umgebung
• Grund-Konnektorerstellung in bestimmter Umgebung

Grund-Konnektorerstellung in der aktuellen Umgebung

Dieses Beispiel erstellt einen Konnektor in der Umgebung Ihres derzeit aktiven Authentifizierungsprofils.

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json

Grund-Konnektorerstellung in bestimmter Umgebung

Dieses Beispiel erstellt einen Konnektor in einer bestimmten Umgebung

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json
  --environment 00000000-0000-0000-0000-000000000000

Optionale Parameter für das Erstellen des Connectors

--api-definition-file -df

Dateiname und Pfad zum Lesen der OpenApiDefinition-Konnektordatei

--api-properties-file -pf

Dateiname und Pfad zum Lesen der Eigenschaftendatei der Konnektor-API

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--icon-file -if

Der Dateiname und der Pfad zur .png-Datei einschließlich des Symbols.

--script-file -sf

Der Dateiname und Pfad zu einer .csx-Skriptdatei

--settings-file

Der Dateiname und der Pfad zur Einstellungsdatei für den Konnektor.

--solution-unique-name -sol

Der eindeutige Name der Lösung, zu der der Konnektor hinzugefügt werden soll

pac-Konnektor herunterladen

OpenApiDefinition- und API-Eigenschaftendatei eines Konnektors herunterladen

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac connector download Befehls.

• Grund-Konnektor herunterladen
• Grund-Konnektorerstellung von bestimmter Umgebung herunterladen
• Grund-Konnektor aus der angegebenen Umgebung in das angegebene Verzeichnis herunterladen

Grund-Konnektor herunterladen

Dieses Beispiel lädt den angegebenen Konnektor in das aktuelle Verzeichnis herunter.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 

Grund-Konnektorerstellung von bestimmter Umgebung herunterladen

Dieses Beispiel lädt den angegebenen Konnektor von der angegebenen Umgebung in das aktuelle Verzeichnis herunter.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000 

Grund-Konnektor aus der angegebenen Umgebung in das angegebene Verzeichnis herunterladen

Dieses Beispiel lädt den angegebenen Konnektor von der angegebenen Umgebung in das angegebene Verzeichnis herunter.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000 `
  --outputDirectory "contoso_Connector"

Erforderliche Parameter für den Connector-Download

--connector-id -id

Die ID des Konnektors

Hinweis: Die Connector-ID muss eine gültige GUID sein.

Optionale Parameter für den Connector-Download

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--outputDirectory -o

Ausgabeverzeichnis

pac-Konnektor initiieren

Initialisiert eine neue API-Eigenschaftendatei für einen Konnektor

Beispiel

Das folgende Beispiel zeigt die Verwendung des pac connector init-Befehls.

Connector-Init mit Ausgabeverzeichnis und Verbindungsvorlage für die Microsoft Entra ID-OAuth-Authentifizierung

In diesem Beispiel wird ein Konnektor im aktuellen Verzeichnis initialisiert.

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file "contoso_script_file" `
  --generate-settings-file "contoso_settings_file" `
  --outputDirectory "contoso_Connector"

Optionale Parameter für das Connector-init

--connection-template -ct

Einen anfänglichen Verbindungsparametersatz mit der angegebenen Vorlage generieren

Verwenden Sie einen dieser Werte:

• NoAuth
• BasicAuth
• ApiKey
• OAuthGeneric
• OAuthAAD

--generate-script-file

Ursprüngliche Konnektor-Skriptdatei generieren

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--generate-settings-file

Ursprüngliche Konnektor-Einstellungsdatei generieren

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

--outputDirectory -o

Ausgabeverzeichnis

pac-Konnektorliste

Listet die in Dataverse registrierten Konnektoren auf.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac connector list Befehls.

• Konnektoren in der aktuellen Umgebung auflisten
• Konnektoren in der bestimmten Umgebung auflisten

Konnektoren in der aktuellen Umgebung auflisten

Dieses Beispiel führt alle Konnektoren in der Umgebung Ihres derzeit aktiven Authentifizierungsprofils auf.

pac connector list

Konnektoren in der bestimmten Umgebung auflisten

Dieses Beispiel führt alle Konnekoren in der bestimmten Umgebung auf.

pac connector list `
  --environment 00000000-0000-0000-0000-000000000000

Optionale Parameter für die Connector-Liste

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--json

Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.

pac-Konnektor aktualisieren

Aktualisiert eine Konnektorentität in Dataverse.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac connector update Befehls.

• Grund-Konnektoraktualisierung in der aktuellen Umgebung
• Grund-Konnektoraktualisierung in bestimmter Umgebung

Grund-Konnektoraktualisierung in der aktuellen Umgebung

Dieses Beispiel aktualisiert einen Konnektor in der Umgebung Ihres derzeit aktiven Authentifizierungsprofils.

pac connector update `
  --api-definition-file ./apiDefinition.json

Grund-Konnektoraktualisierung in bestimmter Umgebung

Dieses Beispiel aktualisiert einen Konnektor in einer bestimmten Umgebung

pac connector update `
  --api-definition-file ./apiDefinition.json `
  --environment 00000000-0000-0000-0000-000000000000

Optionale Parameter für die Aktualisierung des Connectors

--api-definition-file -df

Dateiname und Pfad zum Lesen der OpenApiDefinition-Konnektordatei

--api-properties-file -pf

Dateiname und Pfad zum Lesen der Eigenschaftendatei der Konnektor-API

--connector-id -id

Die ID des Konnektors

Hinweis: Die Connector-ID muss eine gültige GUID sein.

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--icon-file -if

Der Dateiname und der Pfad zur .png-Datei einschließlich des Symbols.

--script-file -sf

Der Dateiname und Pfad zu einer .csx-Skriptdatei

--settings-file

Der Dateiname und der Pfad zur Einstellungsdatei für den Konnektor.

--solution-unique-name -sol

Der eindeutige Name der Lösung, zu der der Konnektor hinzugefügt werden soll

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht