Partajați prin

pac auth

Gestionați modul în care vă autentificați la diverse servicii

Conectați-vă la entitatea găzduită

pac auth create Utilizați comanda pentru a vă conecta la entitatea găzduită. Rularea pac auth create creează un profil de autentificare pe computer. Puteți avea disponibile mai multe profiluri de autentificare. Existența mai multor profiluri de autentificare este interesantă atunci când lucrați cu mai multe entități găzduite. De exemplu, atunci când firma dvs. utilizează mai multe entități găzduite (pentru dezvoltare, producție și testare) sau când sunteți consultant care funcționează pentru mai mulți clienți.

Comanda pac auth create are câțiva parametri utili:

  • Parametrul --environment vă permite să vă conectați automat la mediul potrivit. Dacă omiteți --environment parametrul, sunteți conectat la mediul implicit, dar cu --environment parametrul adăugat la acesta, vă puteți conecta la altul. Puteți utiliza ID-ul de mediu, URL-ul, numele unic sau numele parțial ca valoare.

  • În mediile în care nu aveți capacitatea de a utiliza o experiență interactivă, adăugarea parametrului --deviceCode se asigură că vă puteți conecta în continuare. De exemplu, în GitHub Codespaces, --deviceCode parametrul se adaugă automat atunci când rulați pac auth create.

Exemplu

Pentru a vă conecta la HR-Dev mediu, puteți utiliza următorul exemplu:

pac auth create --environment "HR-Dev"

Comutarea la alt profil de autentificare

Atunci când aveți mai multe profiluri de autentificare, puteți comuta cu ușurință utilizând comenzile pac auth list și pac auth select .

Comanda pac auth list listează toate profilurile de autentificare de pe computer. Comanda pac auth select selectează o altă comandă.

pac auth list Exemplu

Pentru a lista toate profilurile de autentificare, utilizați următorul exemplu:

pac auth list

Rularea comenzii pac auth list returnează toate profilurile de autentificare:

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

Selectați un alt profil de autentificare utilizând valoarea indexului.

pac auth select --index 2

Comenzi

Comanda Descriere
pac auth clear Goliți toate profilurile de autentificare stocate pe acest computer
pac auth create Crearea și stocarea profilurilor de autentificare pe acest computer
pac auth delete Ștergerea unui anumit profil de autentificare
pac auth list Se listează profilurile de autentificare stocate pe acest computer
pac auth name Denumirea sau redenumirea unui profil de autentificare existent
pac auth select Selectați ce profil de autentificare ar trebui să fie activ
pac auth update Actualizarea numelui sau a mediului țintă al unui profil de autentificare existent
pac auth who Afișare informații despre profilul de autentificare selectat în prezent

pac auth clear

Goliți toate profilurile de autentificare stocate pe acest computer

pac auth create

Crearea și stocarea profilurilor de autentificare pe acest computer

Exemple

Următoarele exemple arată utilizarea comenzii pac auth create .

Creare de bază

Acest exemplu vă solicită acreditările și se conectează la entitatea găzduită de care aparțin acreditările.

pac auth create

Notă

Atunci când rulați Power Platform CLI în spații de cod, această operațiune declanșează conectarea la un cod de dispozitiv.

Creare mediu

Acest exemplu vă solicită acreditările și se conectează la mediul Power Platform cu ID-ul de mediu specificat.

pac auth create --environment < Your environment ID >

Sfat

Pentru a găsi un ID de mediu: deschideți Centrul de administrare Power Platform și selectați Mediul la care doriți să vă conectați. În secțiunea Detalii , căutați ID-ul de mediu

Creare denumită

Acest exemplu se autentifică cu entitatea găzduită și îi dă numele MyOrg.

pac auth create --name MyOrg

Denumit Create with Service Principal

Acest exemplu se autentifică cu entitatea găzduită, îi dă numele MyOrg-SPN și utilizează un cont principal de serviciu pentru a face acest lucru. Nu uitați să adăugați contul principal de serviciu la mediul dvs.

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

Identitate Azure

Atunci când rulați într-un mediu care acceptă identitatea Azure (cum ar fi Azure Cloud Shell, Azure VM cu identitate gestionată sau Visual Studio Code cu extensia de cont Azure), puteți utiliza semnalizarea --managedIdentity pentru a vă autentifica utilizând Azure Identity. PAC CLI utilizează acreditările Azure implicite , care este un lanț de acreditări preconfigurat, preconfigurat.

Acreditările Azure implicite sunt proiectate să accepte multe medii, împreună cu cele mai comune fluxuri de autentificare și instrumente pentru dezvoltatori. Puteți particulariza comportamentul prin setarea variabilelor de mediu așa cum este descris în documentația de acreditări Azure implicită. De exemplu, pentru a autentifica utilizând o identitate gestionată atribuită de utilizator, setați AZURE_CLIENT_ID variabila de mediu la ID-ul de client al identității gestionate atribuite de utilizator. Vedeți mai multe detalii în Setarea variabilelor de mediu ale aplicației.

Parametri opționali pentru auth create

--applicationId -id

Opțional: ID-ul aplicației cu care să se autentifice.

--azureDevOpsFederated -adof

(Previzualizare) Utilizați Azure DevOps Federation for Service Principal Authenticationth; necesită argumente --tenant și --applicationId

Acest parametru nu necesită nicio valoare. Este un comutator.

--certificateDiskPath -cdp

Opțional: Calea discului certificatului cu care să se autentifice

--certificatePassword -cp

Opțional: Parola certificatului pentru autentificare cu

--clientSecret -cs

Opțional: Secretul clientului cu care se autentifică

--cloud -ci

Opțional: Instanța cloud cu care să se autentifice

Utilizați una dintre aceste valori:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Utilizați fluxul de cod de dispozitiv Microsoft Entra ID pentru conectare interactivă.

Acest parametru nu necesită nicio valoare. Este un comutator.

--environment -env

Mediu implicit (ID, URL, nume unic sau nume parțial).

--githubFederated -ghf

(Previzualizare) Utilizați Federalizarea GitHub pentru autentificarea principală a serviciului; necesită argumente --tenant și --applicationId

Acest parametru nu necesită nicio valoare. Este un comutator.

--managedIdentity -mi

Utilizați identitatea Azure implicită.

Acest parametru nu necesită nicio valoare. Este un comutator.

--name -n

Numele pe care doriți să-l dați acestui profil de autentificare (maximum 30 de caractere).

Notă: lungimea numelui trebuie să fie între 1 și 30

--password -p

Opțional: Parola pentru autentificare cu

--tenant -t

ID-ul entității găzduite dacă utilizați ID-ul aplicației/secretul clientului sau certificatul ID/client al aplicației.

--url -u

Perimat: Se utilizează --environment în schimb.

--username -un

Opțional: numele de utilizator cu care să se autentifice; afișează o casetă de dialog Microsoft Entra ID dacă nu este specificată.

Remarci

cloud Pentru parametru, valorile de utilizat maparea la aceste alte acronime sau nume comune:

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

Probleme de autentificare WSL2

Atunci când utilizați subsistemul Windows pentru Linux versiunea 2 (WSL2), este posibil să aveți probleme de autentificare, cum Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools ar fi atunci când nu există niciun browser implicit setat în mediul WSL2.

Pentru a rezolva această problemă, puteți utiliza autentificarea prin cod de dispozitiv adăugând semnalizarea --deviceCode la comanda dvs. auth create : pac auth create --environment {env-id} --deviceCode. Va trebui să introduceți un cod într-un browser în afara WSL2 pentru a finaliza procesul de autentificare.

pac auth delete

Ștergerea unui anumit profil de autentificare

Exemplu

pac auth delete --index 2

Parametri opționali pentru auth delete

--index -i

Indexul profilului de șters

Notă: Valoarea trebuie să fie un număr întreg cu valoarea minimă 1.

--name -n

Numele profilului care va fi activ

Notă: lungimea numelui trebuie să fie între 1 și 30

pac auth list

Se listează profilurile de autentificare stocate pe acest computer

pac auth name

Denumirea sau redenumirea unui profil de autentificare existent

Exemplu

Următorul exemplu vă arată cum să redenumiți un profil de autentificare. În acest caz, profilul cu indexul 1 va fi redenumit "Contoso Dev".

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

Parametri obligatorii pentru auth name

--index -i

Indexul profilului de denumit/redenumit

Notă: Valoarea trebuie să fie un număr întreg cu valoarea minimă 1.

--name -n

Numele pe care doriți să-l dați acestui profil de autentificare (maximum 30 de caractere).

Notă: lungimea numelui trebuie să fie între 1 și 30

pac auth select

Selectați ce profil de autentificare ar trebui să fie activ

Exemplu

pac auth select --index 2

Parametri opționali pentru auth select

--index -i

Indexul profilului care va fi activ.

Notă: Valoarea trebuie să fie un număr întreg cu valoarea minimă 1.

--name -n

Numele profilului care va fi activ

Notă: lungimea numelui trebuie să fie între 1 și 30

pac auth update

Actualizarea numelui sau a mediului țintă al unui profil de autentificare existent

Exemple

Următoarele exemple arată utilizarea comenzii pac auth update .

Actualizați profilul de autentificare cu URL-ul de mediu

Acest exemplu vă arată cum să actualizați profilul de autentificare cu indexul 1 cu numele Contoso Dev și URL-ul https://contosodev.crm.dynamics.comde mediu .

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

Actualizați profilul de autentificare cu ID-ul de mediu

Acest exemplu vă arată cum să actualizați profilul de autentificare cu indexul 1 cu ID-ul 00000000-0000-0000-0000-000000000000de mediu .

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

Parametri obligatorii pentru auth update

--index -i

Indexul profilului de denumit/redenumit

Notă: Valoarea trebuie să fie un număr întreg cu valoarea minimă 1.

Parametri opționali pentru auth update

--environment -env

Mediu implicit (ID, URL, nume unic sau nume parțial).

--name -n

Numele pe care doriți să-l dați acestui profil de autentificare (maximum 30 de caractere).

pac auth who

Afișare informații despre profilul de autentificare selectat în prezent

Vezi și

Grupuri de comenzi CLI Microsoft Power Platform
Prezentare generală Microsoft Power Platform CLI

  • Last updated on