pac auth

Beheren hoe u zich verifieert bij verschillende services

Verbinding maken met uw tenant

Gebruik de pac auth create opdracht om verbinding te maken met uw tenant. Als u het programma uitvoert pac auth create , wordt er een verificatieprofiel op uw computer gemaakt. U kunt meerdere verificatieprofielen beschikbaar hebben. Het is interessant om meerdere verificatieprofielen te gebruiken wanneer u met meerdere tenants werkt. Als uw bedrijf bijvoorbeeld meerdere tenants gebruikt (voor ontwikkeling, productie en testen) of als u een consultant bent die voor meerdere klanten werkt.

De pac auth create opdracht heeft een aantal nuttige parameters:

• Met --environment de parameter kunt u automatisch verbinding maken met de juiste omgeving. Als u de --environment parameter weglaat, bent u verbonden met de standaardomgeving, maar met de --environment parameter die eraan is toegevoegd, kunt u verbinding maken met een andere. U kunt de omgevings-id, URL, unieke naam of gedeeltelijke naam als waarde gebruiken.

• In omgevingen waar u geen interactieve ervaring kunt gebruiken, zorgt het toevoegen van de --deviceCode parameter ervoor dat u nog steeds verbinding kunt maken. In GitHub Codespaces wordt de --deviceCode parameter bijvoorbeeld automatisch toegevoegd wanneer u deze uitvoert pac auth create.

Example

Als u verbinding wilt maken met de HR-Dev omgeving, kunt u het volgende voorbeeld gebruiken:

pac auth create --environment "HR-Dev"

Overschakelen naar een ander verificatieprofiel

Wanneer u meerdere verificatieprofielen hebt, kunt u eenvoudig overschakelen met behulp van de pac auth list en pac auth select opdrachten.

Met de pac auth list opdracht worden alle verificatieprofielen op uw computer weergegeven. De pac auth select opdracht selecteert een andere opdracht.

pac auth list Voorbeeld

Als u alle verificatieprofielen wilt weergeven, gebruikt u het volgende voorbeeld:

pac auth list

Als u de pac auth list opdracht uitvoert, worden alle verificatieprofielen geretourneerd:

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

Selecteer een ander verificatieprofiel met behulp van de indexwaarde.

pac auth select --index 2

Commands

pac auth clear

Alle verificatieprofielen wissen die zijn opgeslagen op deze computer

pac auth create

Verificatieprofielen maken en opslaan op deze computer

Voorbeelden

In de volgende voorbeelden ziet u het gebruik van de pac auth create opdracht.

• Basis maken
• Omgeving maken
• Benoemd maken
• Benoemd maken met service-principal
• Azure Identity

Basis maken

In dit voorbeeld wordt u gevraagd om referenties en maakt u verbinding met de tenant waartoe de referenties behoren.

pac auth create

Omgeving maken

In dit voorbeeld wordt u gevraagd om referenties en maakt u verbinding met de Power Platform-omgeving met de omgevings-id die u opgeeft.

pac auth create --environment < Your environment ID >

Benoemd maken

In dit voorbeeld wordt geverifieerd bij uw tenant en krijgt deze de naam MyOrg.

pac auth create --name MyOrg

Benoemd maken met service-principal

Dit voorbeeld wordt geverifieerd met uw tenant, geeft deze de naam MyOrg-SPN en gebruikt hiervoor een service-principal. Vergeet niet om de service-principal toe te voegen aan uw omgeving.

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

Azure Identity

Wanneer u wordt uitgevoerd in een omgeving die Ondersteuning biedt voor Azure Identity (zoals Azure Cloud Shell, Azure VM met beheerde identiteit of Visual Studio Code met azure-accountextensie), kunt u de --managedIdentity vlag gebruiken om te verifiëren met behulp van de Azure-identiteit. PAC CLI maakt gebruik van de standaard Azure-referentie . Dit is een vooraf geconfigureerde, vooraf geconfigureerde keten van referenties.

Standaard Azure Credential is ontworpen ter ondersteuning van veel omgevingen, samen met de meest voorkomende verificatiestromen en ontwikkelhulpprogramma's. U kunt het gedrag aanpassen door omgevingsvariabelen in te stellen, zoals beschreven in de documentatie over standaardReferenties voor Azure. Als u bijvoorbeeld wilt verifiëren met behulp van een door de gebruiker toegewezen beheerde identiteit, stelt u de AZURE_CLIENT_ID omgevingsvariabele in op de client-id van de door de gebruiker toegewezen beheerde identiteit. Zie meer informatie in de omgevingsvariabelen van de app instellen.

Optionele parameters voor auth create

--applicationId -id

Optioneel: de toepassings-id waarmee moet worden geverifieerd.

--azureDevOpsFederated -adof

(Preview) Azure DevOps Federation gebruiken voor verificatie van service-principals; vereist --tenant- en --applicationId-argumenten

Voor deze parameter is geen waarde vereist. Het is een switch.

--certificateDiskPath -cdp

Optioneel: het pad naar de certificaatschijf voor verificatie met

--certificatePassword -cp

Optioneel: het certificaatwachtwoord waarmee moet worden geverifieerd

--clientSecret -cs

Optioneel: het clientgeheim waarmee moet worden geverifieerd

--cloud -ci

Optioneel: het cloudexemplaren voor verificatie met

Gebruik een van deze waarden:

• Public
• UsGov
• UsGovHigh
• UsGovDod
• China

--deviceCode -dc

Gebruik de Microsoft Entra ID Device Code-stroom voor interactieve aanmelding.

Voor deze parameter is geen waarde vereist. Het is een switch.

--environment -env

Standaardomgeving (id, URL, unieke naam of gedeeltelijke naam).

--githubFederated -ghf

(Preview) GitHub Federation gebruiken voor verificatie van service-principal; vereist --tenant- en --applicationId-argumenten

Voor deze parameter is geen waarde vereist. Het is een switch.

--managedIdentity -mi

Gebruik de standaard Azure-identiteit.

Voor deze parameter is geen waarde vereist. Het is een switch.

--name -n

De naam die u aan dit verificatieprofiel wilt geven (maximaal 30 tekens).

Opmerking: De lengte van de naam moet tussen 1 en 30 zijn

--password -p

Optioneel: het wachtwoord waarmee moet worden geverifieerd

--tenant -t

Tenant-id als u toepassings-id/clientgeheim of toepassings-id/clientcertificaat gebruikt.

--url -u

Afgeschaft: gebruik --environment in plaats daarvan.

--username -un

Optioneel: de gebruikersnaam waarmee moet worden geverifieerd; toont een Microsoft Entra ID-dialoogvenster als dit niet is opgegeven.

Opmerkingen

Voor de cloud parameter worden de waarden die moeten worden gebruikt voor deze andere algemene acroniemen of namen:

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

WSL2-verificatieproblemen

Wanneer u windows-subsysteem voor Linux versie 2 (WSL2) gebruikt, hebt u mogelijk verificatieproblemen, zoals Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools wanneer er geen standaardbrowser is ingesteld in uw WSL2-omgeving.

U kunt dit probleem omzeilen door verificatie van apparaatcode te gebruiken door de --deviceCode vlag toe te voegen aan uw auth create opdracht: pac auth create --environment {env-id} --deviceCode. U moet een code invoeren in een browser buiten WSL2 om het verificatieproces te voltooien.

pac auth delete

Een bepaald verificatieprofiel verwijderen

Example

pac auth delete --index 2

Optionele parameters voor auth delete

--index -i

De index van het profiel dat moet worden verwijderd

Opmerking: De waarde moet een geheel getal met een minimumwaarde van 1 zijn.

--name -n

De naam van het profiel dat actief moet zijn

Opmerking: De lengte van de naam moet tussen 1 en 30 zijn

pac auth list

De verificatieprofielen weergeven die zijn opgeslagen op deze computer

pac auth name

Een bestaand verificatieprofiel een naam geven of de naam ervan wijzigen

Example

In het volgende voorbeeld ziet u hoe u de naam van een verificatieprofiel wijzigt. In dit geval wordt de naam van het profiel met index 1 gewijzigd in Contoso Dev.

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

Vereiste parameters voor auth name

--index -i

De index van het profiel dat moet worden benoemd/hernoemd

Opmerking: De waarde moet een geheel getal met een minimumwaarde van 1 zijn.

--name -n

De naam die u aan dit verificatieprofiel wilt geven (maximaal 30 tekens).

Opmerking: De lengte van de naam moet tussen 1 en 30 zijn

pac auth select

Selecteren welk verificatieprofiel actief moet zijn

Example

pac auth select --index 2

Optionele parameters voor auth select

--index -i

De index van het profiel dat actief moet zijn.

Opmerking: De waarde moet een geheel getal met een minimumwaarde van 1 zijn.

--name -n

De naam van het profiel dat actief moet zijn

Opmerking: De lengte van de naam moet tussen 1 en 30 zijn

pac auth update

Naam of doelomgeving van een bestaand verificatieprofiel bijwerken

Voorbeelden

In de volgende voorbeelden ziet u het gebruik van de pac auth update opdracht.

• Verificatieprofiel bijwerken met omgevings-URL
• Verificatieprofiel bijwerken met omgevings-id

Verificatieprofiel bijwerken met omgevings-URL

In dit voorbeeld ziet u hoe u het verificatieprofiel bijwerkt met index 1 met de naam Contoso Dev en de omgevings-URL https://contosodev.crm.dynamics.com.

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

Verificatieprofiel bijwerken met omgevings-id

In dit voorbeeld ziet u hoe u het verificatieprofiel bijwerkt met index 1 met de omgevings-id 00000000-0000-0000-0000-000000000000.

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

Vereiste parameters voor auth update

--index -i

De index van het profiel dat moet worden benoemd/hernoemd

Opmerking: De waarde moet een geheel getal met een minimumwaarde van 1 zijn.

Optionele parameters voor auth update

--environment -env

Standaardomgeving (id, URL, unieke naam of gedeeltelijke naam).

--name -n

De naam die u aan dit verificatieprofiel wilt geven (maximaal 30 tekens).

pac auth who

Informatie weergeven over het geselecteerde verificatieprofiel

Zie ook

Microsoft Power Platform CLI-opdrachtgroepen
Overzicht van Microsoft Power Platform CLI