Delen via

pac-verificatie

Beheren hoe u zich verifieert bij verschillende services

Verbinding maken met uw tenant

Gebruik de opdracht pac auth create 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-verificatielijst en pac-verificatieselectieopdrachten .

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

Command Description
pac-verificatie wissen Alle verificatieprofielen wissen die zijn opgeslagen op deze computer
pac-verificatie maken Verificatieprofielen maken en opslaan op deze computer
pac-verificatie verwijderen Een bepaald verificatieprofiel verwijderen
pac-verificatielijst De verificatieprofielen weergeven die zijn opgeslagen op deze computer
pac-verificatienaam Een bestaand verificatieprofiel een naam geven of de naam ervan wijzigen
pac-verificatie selecteren Selecteren welk verificatieprofiel actief moet zijn
pac-verificatie-update Naam of doelomgeving van een bestaand verificatieprofiel bijwerken
pac-verificatie wie Informatie weergeven over het geselecteerde verificatieprofiel

pac-verificatie wissen

Alle verificatieprofielen wissen die zijn opgeslagen op deze computer

pac-verificatie maken

Verificatieprofielen maken en opslaan op deze computer

Voorbeelden

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

Basis maken

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

pac auth create

Opmerking

Wanneer u Power Platform CLI uitvoert in Codespaces, wordt met deze bewerking een aanmelding met apparaatcode geactiveerd.

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 >

Aanbeveling

Ga naar een omgevings-id: Open het Power Platform-beheercentrum en selecteer de omgeving waarmee u verbinding wilt maken. Zoek in de sectie Details naar omgevings-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 verificatie maken

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

Azure Managed Identity gebruiken.

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-verificatie verwijderen

Een bepaald verificatieprofiel verwijderen

Example

pac auth delete --index 2

Optionele parameters voor het verwijderen van verificatie

--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-verificatielijst

De verificatieprofielen weergeven die zijn opgeslagen op deze computer

pac-verificatienaam

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 verificatienaam

--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-verificatie selecteren

Selecteren welk verificatieprofiel actief moet zijn

Example

pac auth select --index 2

Optionele parameters voor verificatie selecteren

--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-verificatie-update

Naam of doelomgeving van een bestaand verificatieprofiel bijwerken

Voorbeelden

In de volgende voorbeelden ziet u het gebruik van de pac-verificatie-updateopdracht.

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 verificatie-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 verificatie-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-verificatie wie

Informatie weergeven over het geselecteerde verificatieprofiel

Zie ook

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

  • Last updated on