Was ist Microsoft Power Platform CLI?

Microsoft Power Platform CLI ist eine einfache zentrale Entwickler-CLI, mit der Entwickler und unabhängige Softwareanbieter (ISV) verschiedene Vorgänge in Microsoft Power Platform ausführen können, die sich beziehen auf:

• Umgebungslebenszyklus
• Authentifizierung
• Microsoft Dataverse-Umgebungen
• Lösungspakete
• Power Pages
• Codekomponenten
• und mehr…

Feedback geben

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

Microsoft Power Platform CLI installieren

Sie können die Power Platform CLI auf drei Arten installieren. Sie können mehrere Installationsmethoden auf demselben Computer verwenden.

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

Wie Sie bestimmen, ob die Power Platform CLI installiert ist, hängt vom Betriebssystem ab.

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

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.

/home/you/.dotnet/tools/pac

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

Öffnen Sie die Eingabeaufforderung (auf Microsoft Windows) oder eine Terminalsitzung (in Linux), geben Sie einpac, 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 Auth-Profile erstellen und verwenden.

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 als Berater für mehrere Kunden arbeiten.

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. In GitHub Codespaces wird beispielsweise 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 Tab-Vervollständigung in PowerShell aktivieren

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

Wenn Sie sie mithilfe der folgenden Anweisungen konfigurieren, können Sie einfach den Anfang eines Befehls eingeben und dann die TAB-TASTE verwenden, um die eingegebene 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 die Tabvervollständigung auch mit bash, zsh, fish und nushell verwenden. Verwenden Sie dotnet complete anstelle von pac complete.

Us-souveräne Cloudverfügbarkeit

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

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:

Siehe auch

Microsoft Power Platform CLI-Versionshinweise
Microsoft Power Platform CLI-Befehlsgruppen
Fehlerbehebung für Microsoft Power Platform CLI
Power Apps-Komponentenframework