Was ist die Microsoft Power Platform CLI?

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:

• Lebenszyklus der Umgebung
• Authentifizierung
• Microsoft Dataverse-Umgebungen
• Lösungspakete
• Power Pages
• Codekomponenten
• und mehr…

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.

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

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

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 (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.

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:

Siehe auch

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