Comparteix via

pac auth

Gestionar la manera d'autenticar-se en diversos serveis

Connecta't amb l'inquilí

Fes servir l'ordrepac auth create per connectar amb el teu llogater. L'execució pac auth create crea un perfil d'autenticació a l'ordinador. Podeu tenir diversos perfils d'autenticació disponibles. Tenir diversos perfils d'autenticació és interessant quan treballeu amb diversos inquilins. Per exemple, quan la vostra empresa utilitza diversos inquilins (per al desenvolupament, la producció i les proves) o quan sou un consultor que treballa per a diversos clients.

L'ordre pac auth create té un parell de paràmetres útils:

  • El --environment paràmetre us permet connectar-vos automàticament a l'entorn adequat. Si ometeu el --environment paràmetre, esteu connectat a l'entorn per defecte, però amb el --environment paràmetre afegit, podeu connectar-vos a un altre. Podeu utilitzar l'identificador de l'entorn, l'adreça URL, el nom únic o el nom parcial com a valor.

  • En entorns on no teniu la capacitat d'utilitzar una experiència interactiva, afegir el --deviceCode paràmetre us assegura que encara us podeu connectar. Per exemple, a GitHub Codespaces, el paràmetre s'afegeix --deviceCode automàticament quan executeu pac auth create.

Exemple

Per connectar-vos a l'entorn HR-Dev , podeu utilitzar l'exemple següent:

pac auth create --environment "HR-Dev"

Canviar a un altre perfil d'autenticació

Quan tens múltiples perfils d'autenticació, pots canviar fàcilment utilitzant les pac auth list ordres and pac auth select .

L'ordre pac auth list enumera tots els perfils d'autenticació de l'ordinador. L'ordre pac auth select selecciona una ordre diferent.

pac auth list Exemple

Per enumerar tots els perfils d'autenticació, utilitzeu l'exemple següent:

pac auth list

L'execució de l'ordre pac auth list retorna tots els perfils d'autenticació:

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

Seleccioneu un perfil d'autenticació diferent mitjançant el valor de l'índex.

pac auth select --index 2

Comandes

Ordre Descripció
pac auth clear Esborra tots els perfils d'autenticació emmagatzemats en aquest ordinador
pac auth create Crear i emmagatzemar perfils d'autenticació en aquest ordinador
pac auth delete Suprimir un perfil d'autenticació concret
pac auth list Llista dels perfils d'autenticació emmagatzemats en aquest ordinador
pac auth name Anomenar o canviar el nom d'un perfil d'autenticació existent
pac auth select Seleccioneu quin perfil d'autenticació ha d'estar actiu
pac auth update Actualitzar el nom o l'entorn de destinació d'un perfil d'autenticació existent
pac auth who Visualitza informació sobre el perfil d'autenticació seleccionat actualment

pac auth clear

Esborra tots els perfils d'autenticació emmagatzemats en aquest ordinador

pac auth create

Crear i emmagatzemar perfils d'autenticació en aquest ordinador

Exemples

Els exemples següents mostren l'ús de l'ordre pac auth create .

Creació bàsica

Aquest exemple et demana credencials i connecta amb el llogater al qual pertanyen les credencials.

pac auth create

Nota

Quan s'executa la CLI de Power Platform en Codespaces, aquesta operació activa un inici de sessió per codi de dispositiu.

Creació d'entorns

Aquest exemple et demana credencials i es connecta a l'entorn de Power Platform amb l'ID d'entorn que especifiquis.

pac auth create --environment < Your environment ID >

Propina

Per trobar un ID d'entorn: Obre el centre d'administració de Power Platform i selecciona l'entorn al qual vols connectar-te. A la secció Detalls , cerqueu l'identificador de l'entorn

Creació amb nom

Aquest exemple s'autentica amb l'inquilí i li dóna el nom MyOrg.

pac auth create --name MyOrg

Creació amb nom amb entitat principal de servei

Aquest exemple s'autentica amb l'inquilí, li dóna el nom MyOrg-SPN i utilitza una entitat de servei per fer-ho. No oblideu afegir l'entitat de servei al vostre entorn.

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

Azure Identity

Quan s'executa en un entorn que suporta Azure Identity (com Azure Cloud Shell, Azure VM amb Managed Identity, o Visual Studio Code amb l'extensió Azure Account), pots utilitzar la --managedIdentity bandera per autenticar-te amb Azure Identity. PAC CLI utilitza la credencial Azure per defecte , que és una cadena de credencials preconfigurada i amb opinions d'opinació.

La credencial Azure per defecte està dissenyada per donar suport a molts entorns, juntament amb els fluxos d'autenticació més comuns i les eines per a desenvolupadors. Pots personalitzar el comportament establint variables d'entorn tal com es descriu a la documentació de credencials d'Azure per defecte. Per exemple, per autenticar-te utilitzant una identitat gestionada assignada per l'usuari, configura la variable d'entorn AZURE_CLIENT_ID a l'ID del client de la identitat gestionada assignada per l'usuari. Vegeu més detalls a les variables d'entorn Set the App.

Paràmetres opcionals per a auth create

--applicationId -id

Opcional: l'identificador de l'aplicació amb el qual s'ha d'autenticar.

--azureDevOpsFederated -adof

(Vista prèvia) Utilitzeu la federació de l'Azure DevOps per a l'autenticació del principal de servei; requereix els arguments --tenant i --applicationId

Aquest paràmetre no requereix cap valor. És un canvi.

--certificateDiskPath -cdp

Opcional: la ruta del disc del certificat amb la qual s'ha d'autenticar

--certificatePassword -cp

Opcional: la contrasenya del certificat amb la qual s'ha d'autenticar

--clientSecret -cs

Opcional: el secret del client amb el qual s'ha d'autenticar

--cloud -ci

Opcional: la instància del núvol amb la qual s'ha d'autenticar

Utilitzeu un d'aquests valors:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Utilitzeu el flux de codi de dispositiu de l'ID d'entrada del Microsoft per a l'inici de sessió interactiu.

Aquest paràmetre no requereix cap valor. És un canvi.

--environment -env

Entorn per defecte (ID, URL, nom únic o nom parcial).

--githubFederated -ghf

(Vista prèvia) Utilitzeu la federació de GitHub per a l'autenticació del principal de servei; requereix els arguments --tenant i --applicationId

Aquest paràmetre no requereix cap valor. És un canvi.

--managedIdentity -mi

Utilitza la identitat Azure per defecte.

Aquest paràmetre no requereix cap valor. És un canvi.

--name -n

El nom que voleu donar a aquest perfil d'autenticació (màxim 30 caràcters).

Nota: La longitud del nom ha d'estar entre 1 i 30

--password -p

Opcional: la contrasenya per autenticar-se

--tenant -t

Identificador d'inquilí si s'utilitza l'identificador d'aplicació/secret de client o l'identificador d'aplicació/certificat de client.

--url -u

Obsolet: utilitzeu-lo --environment en el seu lloc.

--username -un

Opcional: el nom d'usuari amb el qual s'ha d'autenticar; mostra un diàleg d'identificador del Microsoft Entra si no s'especifica.

Observacions

Per al cloud paràmetre, els valors que s'utilitzaran s'assignen a aquests altres acrònims o noms comuns:

  • GCC = UsGov
  • GCC Alt = UsGovHigh
  • DoD = UsGovDod

Problemes d'autenticació WSL2

Quan utilitzeu el subsistema de Windows per a Linux versió 2 (WSL2), és possible que tingueu problemes d'autenticació, com ara Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools quan no hi ha cap navegador predeterminat definit al vostre entorn WSL2.

Per solucionar aquest problema, podeu utilitzar l'autenticació de codi de dispositiu afegint l'indicador a l'ordre --deviceCodeauth create : pac auth create --environment {env-id} --deviceCode. Haureu d'introduir un codi en un navegador fora de WSL2 per completar el procés d'autenticació.

pac auth delete

Suprimir un perfil d'autenticació concret

Exemple

pac auth delete --index 2

Paràmetres opcionals per a auth delete

--index -i

L'índex del perfil que s'ha d'eliminar

Nota: El valor ha de ser un enter amb un valor mínim d'1.

--name -n

El nom del perfil que s'ha d'activar

Nota: La longitud del nom ha d'estar entre 1 i 30

pac auth list

Llista dels perfils d'autenticació emmagatzemats en aquest ordinador

pac auth name

Anomenar o canviar el nom d'un perfil d'autenticació existent

Exemple

L'exemple següent mostra com canviar el nom d'un perfil d'autenticació. En aquest cas, el perfil amb l'índex 1 canviarà el nom a "Contoso Dev".

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

Paràmetres requerits per a auth name

--index -i

L'índex del perfil que s'anomenarà o canviarà de nom

Nota: El valor ha de ser un enter amb un valor mínim d'1.

--name -n

El nom que voleu donar a aquest perfil d'autenticació (màxim 30 caràcters).

Nota: La longitud del nom ha d'estar entre 1 i 30

pac auth select

Seleccioneu quin perfil d'autenticació ha d'estar actiu

Exemple

pac auth select --index 2

Paràmetres opcionals per a auth select

--index -i

L'índex del perfil a estar actiu.

Nota: El valor ha de ser un enter amb un valor mínim d'1.

--name -n

El nom del perfil que s'ha d'activar

Nota: La longitud del nom ha d'estar entre 1 i 30

pac auth update

Actualitzar el nom o l'entorn de destinació d'un perfil d'autenticació existent

Exemples

Els exemples següents mostren l'ús de l'ordre pac auth update .

Actualitzar el perfil d'autenticació amb l'URL de l'entorn

En aquest exemple es mostra com actualitzar el perfil d'autenticació amb l'índex 1 amb el nom Contoso Dev i l'URL https://contosodev.crm.dynamics.comde l'entorn .

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

Actualitzar el perfil d'autenticació amb l'identificador d'entorn

En aquest exemple es mostra com actualitzar el perfil d'autenticació amb l'índex 1 amb l'identificador 00000000-0000-0000-0000-000000000000d'entorn.

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

Paràmetres requerits per a auth update

--index -i

L'índex del perfil que s'anomenarà o canviarà de nom

Nota: El valor ha de ser un enter amb un valor mínim d'1.

Paràmetres opcionals per a auth update

--environment -env

Entorn per defecte (ID, URL, nom únic o nom parcial).

--name -n

El nom que voleu donar a aquest perfil d'autenticació (màxim 30 caràcters).

pac auth who

Visualitza informació sobre el perfil d'autenticació seleccionat actualment

Consulteu també

Grups d'ordres de l'CLI del Microsoft Power Platform
Informació general de la CLI del Microsoft Power Platform

  • Last updated on