Teilen über

pac auth

  • Artikel

Authentifizierung für verschiedene Dienste 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

Befehle

Befehl Beschreibung
Pac-Authentifizierung löschen Alle auf diesem Computer gespeicherten Authentifizierungsprofile löschen
Pac-Authentifizierung erstellen Authentifizierungsprofile auf diesem Computer erstellen und speichern
Pac-Authentifizierung löschen Ein bestimmtes Authentifizierungsprofil löschen
Pac-Auth-Liste Auf diesem Computer gespeicherte Authentifizierungsprofile auflisten
Pac-Authentifizierungsname Vorhandenes Authentifizierungsprofil benennen oder umbenennen
Pac-Authentifizierung Auswählen Wählen Sie das Authentifizierungsprofil aus, das aktiv sein soll.
Pac-Authentifizierungsaktualisierung Name oder Zielumgebung eines vorhandenen Authentifizierungsprofils aktualisieren
Pac Auth wer Informationen zum aktuell ausgewählten Authentifizierungsprofil anzeigen

pac auth clear

Alle auf diesem Computer gespeicherten Authentifizierungsprofile löschen

pac auth create

Authentifizierungsprofile auf diesem Computer erstellen und speichern

Beispiele

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

Grundlegende Erstellung

In diesem Beispiel werden Sie zur Eingabe von Anmeldeinformationen aufgefordert und eine Verbindung zu dem Mandanten hergestellt, zu dem die Anmeldeinformationen gehören.

pac auth create

Anmerkung

Wenn Sie Power Platform CLI in Codespaces ausführen, wird dadurch eine Gerätecode-Anmeldung ausgelöst.

Umgebung erstellen

In diesem Beispiel werden Sie zur Eingabe von Anmeldeinformationen aufgefordert und eine Verbindung zur Power Platform-Umgebung mit der von Ihnen angegebenen Umgebungs-ID hergestellt.

pac auth create --environment < Your environment ID >

Tipp

Die ID der Umgebung finden:

  1. Öffnen Sie das Power Platform Admin Center und wählen Sie die Umgebung aus, mit der Sie eine Verbindung herstellen möchten. Suchen Sie im Abschnitt Details nach Umgebungs-ID

Mit Namen erstellen

In diesem Beispiel wird Ihr Mandant authentifiziert und ihm der Name MyOrg zugewiesen.

pac auth create --name MyOrg

Mit Namen erstellen mit Dienstprinzipal

In diesem Beispiel wird Ihr Mandant authentifiziert, ihm der Name MyOrg-SPN zugewiesen und hierfür ein Dienstprinzipal verwendet. Vergessen Sie nicht, den Dienstprinzipal zu Ihrer Umgebung hinzuzufügen.

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

Optionale Parameter für die Erstellung der Authentifizierung

--applicationId-id

Optional: Die Anwendungs-ID für die Authentifizierung

--azureDevOpsFederated-adof

(Vorschauversion) Verwenden Sie Azure DevOps-Verbund für Dienstprinzipal-Authentifizierung; erfordert die Argumente --tenant und --applicationId

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

--certificateDiskPath-cdp

Optional: der Pfad zum Zertifikat, mit dem authentifiziert werden soll

--certificatePassword-cp

Optional: das Zertifikatkennwort für die Authentifizierung

--clientSecret-cs

Optional: Der geheime Clientschlüssel für die Authentifizierung

--cloud-ci

Optional: Die Cloudinstanz für die Authentifizierung

Verwenden Sie einen dieser Werte:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode-dc

Verwenden Sie den Microsoft Entra-ID-Gerätecode-Flow für die interaktive Anmeldung.

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

--environment-env

Standardumgebung (ID, URL, eindeutiger Name oder teilweiser Name)

--githubFederated-ghf

(Vorschauversion) Verwenden Sie GitHub-Verbund für Dienstprinzipal-Authentifizierung; erfordert die Argumente --tenant und --applicationId

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

--kind-k

Veraltet: Dieser Parameter wird ignoriert.

--managedIdentity-mi

Eine Azure verwaltete Identität.

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

--name-n

Der Name, den Sie diesem Authentifizierungsprofil geben möchten (maximal 30 Zeichen)

Hinweis: Die Länge des Namens sollte zwischen 1 und 30 liegen

--password-p

Optional: das Kennwort für die Authentifizierung

--tenant-t

Mandanten-ID bei Verwendung von Anwendungs-ID/geheimer Clientschlüssel oder Anwendungs-ID/Clientzertifikat

--url-u

Veraltet: Verwenden Sie stattdessen --environment .

--username-un

Optional: Der Benutzername für die Authentifizierung; zeigt das Microsoft Entra-ID-Dialogfeld, falls nicht angegeben.

Anmerkungen

Für die cloud-Parameter werden die zu verwendenden Werte diesen anderen gebräuchlichen Akronymen oder Namen zugeordnet:

  • GCC = UsGov
  • GCC High = UsGovHigh
  • DoD = UsGovDod

pac auth delete

Ein bestimmtes Authentifizierungsprofil löschen

Beispiel

pac auth delete --index 2

Optionale Parameter für das Löschen der Authentifizierung

--index-i

Der Index des Profils, das gelöscht werden soll

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 1 sein.

--name-n

Der Name des Profils, das aktiv sein soll

Hinweis: Die Länge des Namens sollte zwischen 1 und 30 liegen

pac auth list

Auf diesem Computer gespeicherte Authentifizierungsprofile auflisten

pac auth name

Vorhandenes Authentifizierungsprofil benennen oder umbenennen

Beispiel

Das folgende Beispiel zeigt, wie Sie ein Authentifizierungsprofil umbenennen. In diesem Fall wird das Profil mit Index 1 in „Contoso Dev“ umbenannt.

pac auth name --index 1 --name "Contoso Dev"

Erforderliche Parameter für den Authentifizierungsnamen

--index-i

Der Index des Profils, das benannt/umbenannt werden soll

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 1 sein.

--name-n

Der Name, den Sie diesem Authentifizierungsprofil geben möchten (maximal 30 Zeichen)

Hinweis: Die Länge des Namens sollte zwischen 1 und 30 liegen

pac auth select

Wählen Sie das Authentifizierungsprofil aus, das aktiv sein soll.

Beispiel

pac auth select --index 2

Optionale Parameter für die Auswahl der Authentifizierung

--index-i

Der Index des Profils, das aktiv sein soll

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 1 sein.

--name-n

Der Name des Profils, das aktiv sein soll

Hinweis: Die Länge des Namens sollte zwischen 1 und 30 liegen

pac auth update

Name oder Zielumgebung eines vorhandenen Authentifizierungsprofils aktualisieren

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac auth Aktualisierungsbefehls.

Aktualisieren Sie das Authentifizierungsprofil mit der Umgebungs-URL

Dieses Beispiel zeigt, wie das Authentifizierungsprofil mit Index 1 mit dem Namen Contoso Dev und der Umgebungs-URL https://contosodev.crm.dynamics.com aktualisiert wird.

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

Aktualisieren Sie das Authentifizierungsprofil mit der Umgebungs-ID

Dieses Beispiel zeigt, wie das Authentifizierungsprofil mit Index 1 mit der Umgebungs-ID 00000000-0000-0000-0000-000000000000 aktualisiert wird.

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

Erforderliche Parameter für die Authentifizierungsaktualisierung

--index-i

Der Index des Profils, das benannt/umbenannt werden soll

Hinweis: Der Wert muss eine Ganzzahl mit einem Mindestwert von 1 sein.

Optionale Parameter für das Aktualisieren der Authentifizierung

--environment-env

Standardumgebung (ID, URL, eindeutiger Name oder teilweiser Name)

--name-n

Der Name, den Sie diesem Authentifizierungsprofil geben möchten (maximal 30 Zeichen)

pac auth who

Informationen zum aktuell ausgewählten Authentifizierungsprofil anzeigen

Siehe auch

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