Del via

pac auth

Administrer, hvordan du godkender til forskellige tjenester

Opret forbindelse til din lejer

Brug kommandoen pac auth create til at oprette forbindelse til din lejer. Når du kører , pac auth create oprettes der en godkendelsesprofil på computeren. Du kan have flere tilgængelige godkendelsesprofiler. Det er interessant at have flere godkendelsesprofiler, når du arbejder med flere lejere. Når din virksomhed f.eks. bruger flere lejere (til udvikling, produktion og test), eller når du er konsulent, der arbejder for flere kunder.

Kommandoen pac auth create har et par nyttige parametre:

  • Parameteren --environment giver dig mulighed for automatisk at oprette forbindelse til det rigtige miljø. Hvis du udelader --environment parameteren, har du forbindelse til standardmiljøet, men når --environment parameteren er føjet til den, kan du oprette forbindelse til en anden. Du kan bruge miljø-id'et, URL-adressen, det entydige navn eller det delvise navn som værdi.

  • I miljøer, hvor du ikke har mulighed for at bruge en interaktiv oplevelse, sikrer tilføjelse af --deviceCode parameteren, at du stadig kan oprette forbindelse. I GitHub Codespaces tilføjes parameteren f.eks. automatisk, --deviceCode når du kører pac auth create.

Eksempel

Hvis du vil oprette forbindelse til HR-Dev miljøet, kan du bruge følgende eksempel:

pac auth create --environment "HR-Dev"

Skift til en anden godkendelsesprofil

Når du har flere godkendelsesprofiler, kan du nemt skifte ved hjælp af pac auth list og pac auth select-kommandoer .

Kommandoen pac auth list viser alle godkendelsesprofiler på computeren. Kommandoen pac auth select vælger en anden kommando.

pac auth list Eksempel

Hvis du vil have vist alle godkendelsesprofiler, skal du bruge følgende eksempel:

pac auth list

Hvis du kører kommandoen, pac auth list returneres alle godkendelsesprofiler:

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

Vælg en anden godkendelsesprofil ved hjælp af indeksværdien.

pac auth select --index 2

Kommandoer

Kommando Beskrivelse
pac auth clear Ryd alle godkendelsesprofiler, der er gemt på denne computer
pac auth create Opret og gem godkendelsesprofiler på denne computer
pac auth delete Slet en bestemt godkendelsesprofil
pac auth-liste Vis de godkendelsesprofiler, der er gemt på denne computer
navn på pac auth Navngiv eller omdøb en eksisterende godkendelsesprofil
pac auth select Vælg, hvilken godkendelsesprofil der skal være aktiv
pac auth-opdatering Opdater navn eller destinationsmiljø for en eksisterende godkendelsesprofil
pac auth hvem Vis oplysninger om den aktuelt valgte godkendelsesprofil

pac auth clear

Ryd alle godkendelsesprofiler, der er gemt på denne computer

pac auth create

Opret og gem godkendelsesprofiler på denne computer

Eksempler

Følgende eksempler viser brugen af pac auth create kommandoen.

Grundlæggende oprettelse

I dette eksempel bliver du bedt om at angive legitimationsoplysninger og oprette forbindelse til den lejer, som legitimationsoplysningerne tilhører.

pac auth create

Notat

Når du kører Power Platform-kommandolinjegrænsefladen i Codespaces, udløser det et enhedskodelogon.

Opret miljø

I dette eksempel bliver du bedt om at angive legitimationsoplysninger og oprette forbindelse til Power Platform-miljøet med det miljø-id, du angiver.

pac auth create --environment < Your environment ID >

Tips

Sådan finder du et miljø-id:

  1. Åbn Power Platform Administration , og vælg det miljø , du vil oprette forbindelse til. I afsnittet Detaljer skal du søge efter miljø-id

Navngivet opret

Dette eksempel godkendes med din lejer og giver det navnet MyOrg.

pac auth create --name MyOrg

Navngivet Opret med tjenesteprincipal

Dette eksempel godkendes med din lejer, giver det navnet MyOrg-SPN og bruger en tjenesteprincipal til at gøre det. Glem ikke at føje tjenesteprincipalen til dit miljø.

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

Valgfrie parametre for oprettelse af godkendelse

--applicationId -id

Valgfrit: Det program-id, der skal godkendes med.

--azureDevOpsFederated -adof

(eksempelvisning) Brug Azure DevOps Federation for Service Principal Auth; kræver argumenterne --tenant og --applicationId

Denne parameter kræver ingen værdi. Det er en kontakt.

--certificateDiskPath -cdp

Valgfrit: Stien til certifikatdisken, der skal godkendes med

--certificatePassword -cp

Valgfrit: Den adgangskode til certifikatet, der skal godkendes med

--clientSecret -cs

Valgfrit: Den klienthemmelighed, der skal godkendes med

--cloud -ci

Valgfrit: Den cloudforekomst, der skal godkendes med

Brug en af disse værdier:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Brug microsoft entra-id-flowet Enhedskode til interaktiv logon.

Denne parameter kræver ingen værdi. Det er en kontakt.

--environment -env

Standardmiljø (id, URL-adresse, entydigt navn eller delvist navn).

--githubFederated -ghf

(eksempelvisning) Brug GitHub Federation for Service Principal Auth; kræver argumenterne --tenant og --applicationId

Denne parameter kræver ingen værdi. Det er en kontakt.

--managedIdentity -mi

Brug Azure Managed Identity.

Denne parameter kræver ingen værdi. Det er en kontakt.

--name -n

Det navn, du vil give til denne godkendelsesprofil (højst 30 tegn).

Bemærk! Navnets længde skal være mellem 1 og 30

--password -p

Valgfrit: Den adgangskode, der skal godkendes med

--tenant -t

Lejer-id, hvis du bruger program-id/klienthemmelighed eller program-id/klientcertifikat.

--url -u

Frarådes: Brug --environment i stedet.

--username -un

Valgfrit: Det brugernavn, der skal godkendes med; viser dialogboksen Microsoft Entra ID, hvis den ikke er angivet.

Bemærkninger

cloud For parameteren knyttes de værdier, der skal bruges, til disse andre almindelige akronymer eller navne:

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

Problemer med WSL2-godkendelse

Når du bruger Windows-undersystemet til Linux version 2 (WSL2), kan du have godkendelsesproblemer, f.eks Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools . når der ikke er angivet nogen standardbrowser i dit WSL2-miljø.

Du kan løse problemet ved at bruge enhedskodegodkendelse ved at føje flaget --deviceCode til kommandoen auth create : pac auth create --environment {env-id} --deviceCode. Du skal angive en kode i en browser uden for WSL2 for at fuldføre godkendelsesprocessen.

pac auth delete

Slet en bestemt godkendelsesprofil

Eksempel

pac auth delete --index 2

Valgfrie parametre for godkendelsessletning

--index -i

Indekset for den profil, der skal slettes

Bemærk! Værdien skal være et heltal med minimumværdien 1.

--name -n

Navnet på den profil, der skal være aktiv

Bemærk! Navnets længde skal være mellem 1 og 30

pac auth-liste

Vis de godkendelsesprofiler, der er gemt på denne computer

navn på pac auth

Navngiv eller omdøb en eksisterende godkendelsesprofil

Eksempel

I følgende eksempel kan du se, hvordan du omdøber en godkendelsesprofil. I dette tilfælde omdøbes profilen med indeks 1 til 'Contoso Dev'.

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

Obligatoriske parametre for godkendelsesnavn

--index -i

Indekset for den profil, der skal navngives/omdøbes

Bemærk! Værdien skal være et heltal med minimumværdien 1.

--name -n

Det navn, du vil give til denne godkendelsesprofil (højst 30 tegn).

Bemærk! Navnets længde skal være mellem 1 og 30

pac auth select

Vælg, hvilken godkendelsesprofil der skal være aktiv

Eksempel

pac auth select --index 2

Valgfrie parametre for godkendelsesvalg

--index -i

Indekset for den profil, der skal være aktiv.

Bemærk! Værdien skal være et heltal med minimumværdien 1.

--name -n

Navnet på den profil, der skal være aktiv

Bemærk! Navnets længde skal være mellem 1 og 30

pac auth-opdatering

Opdater navn eller destinationsmiljø for en eksisterende godkendelsesprofil

Eksempler

Følgende eksempler viser brugen af kommandoen pac auth update.

Opdater godkendelsesprofilen med URL-adressen til miljøet

I dette eksempel kan du se, hvordan du opdaterer godkendelsesprofilen med indeks 1 med navnet Contoso Dev og URL-adressen https://contosodev.crm.dynamics.comtil miljøet .

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

Opdater godkendelsesprofil med miljø-id

I dette eksempel kan du se, hvordan du opdaterer godkendelsesprofilen med indeks 1 med miljø-id'et 00000000-0000-0000-0000-000000000000.

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

Obligatoriske parametre for godkendelsesopdatering

--index -i

Indekset for den profil, der skal navngives/omdøbes

Bemærk! Værdien skal være et heltal med minimumværdien 1.

Valgfrie parametre for godkendelsesopdatering

--environment -env

Standardmiljø (id, URL-adresse, entydigt navn eller delvist navn).

--name -n

Det navn, du vil give til denne godkendelsesprofil (højst 30 tegn).

pac auth hvem

Vis oplysninger om den aktuelt valgte godkendelsesprofil

Se også

Kommandolinjekommandogrupper for Microsoft Power Platform
Oversigt over kommandolinjegrænsefladen til Microsoft Power Platform

  • Last updated on