Freigeben über

Was ist die Microsoft Power Platform CLI?

  • Artikel

Microsoft Power Platform CLI ist eine einfache zentrale Entwickler-CLI, mit der Entwickler und ISVs verschiedene Vorgänge in Microsoft Power Platform ausführen können, die sich auf Folgendes beziehen:

Feedback senden

Verwenden Sie github.com/microsoft/powerplatform-build-tools/discussions, um Feedback für PAC CLI anzuzeigen und zu übermitteln.

Microsoft Power Platform CLI installieren

Es gibt drei Möglichkeiten für die Installation der Power Platform CLI. Sie können mehrere Installationsmethoden auf demselben Computer verwenden.

Methode Unterstützung des Betriebssystems Beschreibung
Installieren Sie die Visual Studio Code-Erweiterung Windows, Linux, macOS Ermöglicht die Verwendung von Befehlen innerhalb eines PowerShell-Terminals innerhalb von Visual Studio Code unter Windows 10, Windows 11, Linux und macOS.

Wenn Sie NUR mit dieser Methode installieren, ist die PAC-CLI standardmäßig nur innerhalb eines Visual Studio Code-Terminals verfügbar, es sei denn, Sie aktivieren die PAC-CLI in der Eingabeaufforderung (CMD) und in PowerShell-Terminals für Windows
Mit dem .NET-Tool installieren Windows, Linux, macOS Ermöglicht die Verwendung von Befehlen innerhalb einer PowerShell-, CMD- oder Bash-Shell unter Windows 10, Windows 11, Linux und macOS.

Diese Installationsmethode ermöglicht nicht die Verwendung von pac-Daten oder bestimmten pac-Paket-Befehlen (bereitstellen und anzeigen), die nur für Windows verfügbar sind.
Installation mit Windows MSI Nur Windows Ermöglicht die Verwendung von Befehlen innerhalb eines PowerShell-Terminals in Visual Studio Code nur unter Windows. Sie können mit dieser Installationsmethode installierte Versionen verwalten.

Anmerkung

Die folgenden Befehle sind nur unter Windows verfügbar:

Um diese Befehle unter Windows zu verwenden, installieren Sie Power Platform CLI mit einer (oder beiden) dieser Installationsmethoden:

Diese Befehle sind unter Windows nicht verfügbar, wenn Sie nur mit .NET-Tool installieren.

Überprüfen, ob die Power Platform CLI bereits installiert ist

So ermitteln Sie, ob die Power Platform CLI installiert ist (je nach Betriebssystem).

  1. Öffnen Sie ein PowerShell-Terminal:

    • Wenn Sie NUR die Visual Studio Code-Erweiterung installiert haben, öffnen Sie ein Visual Studio Code-PowerShell-Terminalfenster.
    • Wenn Sie mit dem .NET-Tool installiert haben, öffnen Sie ein Visual Studio Code-PowerShell-Terminal ODER ein PowerShell-Terminal.

  2. Geben Sie Get-Command pac | Format-List in der Eingabeaufforderung ein und drücken Sie die Eingabetaste.

Die Ergebnisse sollten in etwa so aussehen:

Name            : pac.exe
CommandType     : Application
Definition      : C:\Users\you\.dotnet\tools\pac.exe
Extension       : .exe
Path            : C:\Users\you\.dotnet\tools\pac.exe
FileVersionInfo : File:             C:\Users\you\.dotnet\tools\pac.exe
                  InternalName:     pac.dll
                  OriginalFilename: pac.dll
                  FileVersion:      1.29.11
                  FileDescription:  Microsoft Power Platform CLI
                  Product:          Microsoft Power Platform©
                  ProductVersion:   1.29.11+g9e2b163
                  Debug:            False
                  Patched:          False
                  PreRelease:       False
                  PrivateBuild:     False
                  SpecialBuild:     False
                  Language:         Language Neutral

Wenn die Power Platform-CLI nicht installiert ist, erhalten Sie diese Fehlermeldung:

Get-Command: The term 'pac' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

Überprüfen, welche Version der Power Platform CLI installiert ist

Öffnen Sie die Eingabeaufforderung (unter Microsoft Windows) oder eine Terminalsitzung (unter Linux), geben Sie pac ein und drücken Sie die Eingabetaste.

Sie sollten etwa Folgendes sehen: Die Version steht in der zweiten Zeile.

Microsoft PowerPlatform CLI
Version: 1.30.3+g0f0e0b9

Authentifizierungsprofile verwalten

Die meisten PAC-CLI-Befehle erfordern einen authentifizierten Zugriff auf Ressourcen. Sie müssen Authentifizierungsprofile erstellen und verwenden.

Anmerkung

Mit der Visual Studio Code-Erweiterung können Sie Authentifizierungsprofile anzeigen und verwalten.

Mit Ihrem Mandanten verbinden

Verwenden Sie den Befehl pac auth create, um eine Verbindung zu Ihrem Mandanten herzustellen. Durch Ausführen von pac auth create wird ein Authentifizierungsprofil auf Ihrem Computer erstellt. Es können mehrere Authentifizierungsprofile verfügbar sein. Mehrere Authentifizierungsprofile sind interessant, wenn Sie mit mehreren Mandanten arbeiten. Zum Beispiel, wenn Ihr Unternehmen mehrere Mandanten nutzt (für Entwicklung, Produktion und Tests) oder wenn Sie beratend tätig sind, der für mehrere Kunden bzw. Kundinnen arbeitet.

Der Befehl pac auth create hat einige hilfreiche Parameter:

  • Mit dem Parameter --environment können Sie automatisch eine Verbindung zur richtigen Umgebung herstellen. Wenn Sie den Parameter --environment weglassen, werden Sie mit der Standardumgebung verbunden. Mit dem hinzugefügten Parameter --environment können Sie jedoch eine Verbindung zu einer anderen Umgebung herstellen. Als Wert können Sie die Umgebungs-ID, die URL, den eindeutigen Namen oder einen Teilnamen verwenden.

  • In Umgebungen, in denen Sie kein interaktiven Funktionen verwenden können, stellen Sie durch Hinzufügen des Parameters --deviceCode sicher, dass Sie trotzdem eine Verbindung herstellen können. Beispielsweise wird in GitHub Codespaces der Parameter --deviceCode automatisch hinzugefügt, wenn Sie pac auth create ausführen.

Beispiel

Um eine Verbindung zur HR-Dev-Umgebung herzustellen, können Sie das folgende Beispiel verwenden:

pac auth create --environment "HR-Dev"

Zu einem anderen Authentifizierungsprofil wechseln

Wenn Sie über mehrere Authentifizierungsprofile verfügen, können Sie mithilfe der Befehle pac auth list und pac auth select einfach wechseln.

Der Befehl pac auth list listet alle Authentifizierungsprofile auf Ihrem Computer auf. Der Befehl pac auth select wählt einen anderen Befehl aus.

pac auth list Beispiel

Sie können das folgende Beispiel verwenden, um alle Authentifizierungsprofile aufzulisten:

pac auth list

Wenn Sie den Befehl pac auth list ausführen, werden alle Authentifizierungsprofile zurückgegeben:

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

Wählen Sie anhand des Indexwerts ein anderes Authentifizierungsprofil aus.

pac auth select --index 2

Die Registerkartenverfollständigung in PowerShell aktivieren

Power Platform CLI verfügt über einen pac complete Befehl, der dem .NET CLI-Vervollständigungsbefehl ähnelt.

Bei der Konfiguration mithilfe der folgenden Anweisungen können Sie nur den Anfang eines Befehls eingeben und dann die Tabulatortaste verwenden, um die vorgenommene Eingabe abzuschließen.

Um die Registerkartenvervollständigung zu PowerShell für die PAC-CLI hinzuzufügen, erstellen oder bearbeiten Sie das in der Variablen $PROFILE gespeicherte Profil. Weitere Informationen finden Sie unter So erstellen Sie Ihr Profil und Profile und Ausführungsrichtlinien.

Fügen Sie Ihrem Profil den folgenden Code hinzu:

$scriptblock = {
    param($wordToComplete, $commandAst, $cursorPosition)

    &pac complete -s "$($commandAst.ToString())" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}

Register-ArgumentCompleter -Native -CommandName pac -ScriptBlock $scriptblock

Andere Shells

Sie können dies auch mit Bash, Zsh, Fish und Nushell verwenden. Verwenden Sie pac complete anstelle von dotnet complete

Verfügbarkeit der US Sovereign Cloud

Microsoft Power Platform CLI ist für die Verwendung in den Regionen GCC und GCC High (US Sovereign Cloud) verfügbar. Siehe --cloud Parameter für den Befehl pac auth create für Informationen zu unterstützten US Sovereign Cloudumgebungen.

Nächste Schritte,

Erfahren Sie mehr über die Befehle. Um die vollständige Liste der unterstützten Befehle zu erhalten, führen Sie den pac help-Befehl oder pac <subcommand> help aus, zum Beispiel: pac solution help.

Oder sehen Sie sich die Liste der Befehle in der Dokumentation an:

Microsoft Power Platform CLI-Befehlsgruppen

Siehe auch

Microsoft Power Platform CLI-Versionshinweise
Microsoft Power Platform CLI-Befehlsgruppen
Power Apps Komponenten-Framework