Compartir por

pac auth

Xestiona como te autenticas a varios servizos.

Conecta co teu inquilino

Usa o pac auth create comando para conectar co teu inquilino. A execución pac auth create crea un perfil de autenticación na máquina. Pode ter varios perfís de autenticación dispoñibles. Ter varios perfís de autenticación é interesante cando traballas con varios inquilinos. Por exemplo, cando a túa empresa usa varios inquilinos (para desenvolvemento, produción e probas) ou cando es un consultor que traballa para varios clientes.

O pac auth create comando ten un par de parámetros útiles:

  • O --environment parámetro permítelle conectarse automaticamente ao ambiente adecuado. Se omites o --environment parámetro, estás conectado ao entorno predeterminado, pero co --environment parámetro engadido a el, podes conectarte a outro diferente. Pode usar o ID do ambiente, a url, o nome único ou o nome parcial como valor.

  • En ambientes onde non tes a capacidade de usar unha experiencia interactiva, engadir o --deviceCode parámetro asegura que aínda podes conectarte. Por exemplo, en GitHub Codespaces, o --deviceCode parámetro engádese automaticamente cando executas pac auth create.

Exemplo

Para conectarse ao HR-Dev entorno, podes usar o seguinte exemplo:

pac auth create --environment "HR-Dev"

Cambiar a outro perfil de autenticación

Cando tes varios perfís de autenticación, podes cambiar facilmente usando os pac auth list comandos e.pac auth select

O pac auth list comando lista todos os perfís de autenticación do equipo. O pac auth select comando selecciona un comando diferente.

pac auth list Exemplo

Para listar todos os perfís de autenticación, use o seguinte exemplo:

pac auth list

Ao executar o pac auth list comando devolve todos os perfís de autenticación:

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

Seleccione un perfil de autenticación diferente usando o valor do índice.

pac auth select --index 2

Comandos

Comando Descripción
pac auth clear Limpar todos os perfís de autenticación almacenados neste ordenador
pac auth create Crear e almacenar perfís de autenticación neste ordenador
pac auth delete Eliminar un perfil de autenticación específico
pac auth list Listar os perfís de autenticación almacenados neste ordenador
pac auth name Nomear ou renomear un perfil de autenticación existente
pac auth select Selecciona o perfil de autenticación que debe estar activo
pac auth update Actualizar o nome ou o entorno de destino dun perfil de autenticación existente
pac auth who Mostrar información sobre o perfil de autenticación seleccionado actualmente

pac auth clear

Limpar todos os perfís de autenticación almacenados neste ordenador

pac auth create

Crear e almacenar perfís de autenticación neste ordenador

Exemplos

Os seguintes exemplos mostran o uso do pac auth create comando.

Creación básica

Este exemplo pídeche credenciais e conecta co inquilino ao que pertencen esas credenciais.

pac auth create

Nota

Ao executar a CLI de Power Platform en Codespaces, esta operación activa un inicio de sesión por código de dispositivo.

Creación de contorna

Este exemplo solicita credenciais e conéctase co entorno Power Platform co ID do entorno que especifiques.

pac auth create --environment < Your environment ID >

Suxestión

Para atopar un ID de entorno: Abre o centro de administración de Power Platform e selecciona o Entorno ao que queres conectarte. Na sección Detalles , busque o ID do ambiente

Crear con nome

Este exemplo autentica co seu inquilino e dálle o nome MyOrg.

pac auth create --name MyOrg

Creación con principal de servizo

Este exemplo autentica co seu inquilino, dálle o nome MyOrg-SPN e usa unha entidade de servizo para facelo. Non esquezas engadir o principal de servizo ao teu entorno.

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

Azure Identity

Cando se executa nun entorno que soporta Azure Identity (como Azure Cloud Shell, Azure VM con Identidade Xestiona, ou Visual Studio Code coa extensión Azure Account), podes usar a --managedIdentity bandeira para autenticar usando Azure Identity. PAC CLI usa a credencial predeterminada de Azure , que é unha cadea de credenciais preconfiguradas e con opinión.

A credencial predeterminada de Azure está deseñada para soportar moitos entornos, xunto cos fluxos de autenticación máis comúns e as ferramentas para desenvolvedores. Podes personalizar o comportamento configurando variables de ambiente como se describe na documentación predeterminada de credenciais de Azure. Por exemplo, para autenticar usando unha identidade xestionada asignada polo usuario, establece a AZURE_CLIENT_ID variable de ambiente ao ID do cliente da identidade xestionada asignada polo usuario. Vexa máis detalles en Configurar as variables de entorno da aplicación.

Parámetros opcionais para auth create

--applicationId -id

Opcional: O ID da aplicación coa que autenticarse.

--azureDevOpsFederated -adof

(Vista previa) Use Azure DevOps Federation for Service Principal Auth; require os argumentos --tenant e --applicationId

Este parámetro non precisa de valor. É un cambio.

--certificateDiskPath -cdp

Opcional: A ruta do disco do certificado coa que autenticarse

--certificatePassword -cp

Opcional: O contrasinal do certificado para autenticarse

--clientSecret -cs

Opcional: O segredo do cliente co que autenticarse

--cloud -ci

Opcional: A instancia na nube coa que autenticarse

Utiliza un destes valores:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Use o fluxo de código de dispositivo de Microsoft Entra ID para iniciar sesión interactivo.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Contorna predeterminada (ID, url, nome único ou nome parcial).

--githubFederated -ghf

(Vista previa) Use a federación de GitHub para a autenticación do principal de servizo; require os argumentos --tenant e --applicationId

Este parámetro non precisa de valor. É un cambio.

--managedIdentity -mi

Usa a identidade predeterminada de Azure.

Este parámetro non precisa de valor. É un cambio.

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

--password -p

Opcional: O contrasinal para autenticarse

--tenant -t

Identificador de inquilino se usa ID de aplicación/segredo de cliente ou ID de aplicación/certificado de cliente.

--url -u

Obsoleto: Usa no --environment seu lugar.

--username -un

Opcional: O nome de usuario co que autenticarse; Mostra un diálogo de ID de Microsoft Entra se non se especifica.

Comentarios

Para o cloud parámetro, os valores a usar mapean a estes outros acrónimos ou nomes comúns:

  • GCC = UsGov
  • GCC Alto = UsGovHigh
  • DoD = UsGovDod

Problemas de autenticación WSL2

Ao usar o subsistema de Windows para Linux versión 2 (WSL2), pode ter problemas de autenticación, como Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools cando non hai un navegador predeterminado establecido no seu entorno WSL2.

Para solucionar este problema, pode usar a autenticación do código do dispositivo engadindo a --deviceCode bandeira ao comando auth create : pac auth create --environment {env-id} --deviceCode. Terás que introducir un código nun navegador fóra de WSL2 para completar o proceso de autenticación.

pac auth delete

Eliminar un perfil de autenticación específico

Exemplo

pac auth delete --index 2

Parámetros opcionais para auth delete

--index -i

O índice do perfil a eliminar

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome do perfil a estar activo

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

pac auth list

Listar os perfís de autenticación almacenados neste ordenador

pac auth name

Nomear ou renomear un perfil de autenticación existente

Exemplo

No seguinte exemplo móstrase como cambiar o nome dun perfil de autenticación. Neste caso, o perfil co índice 1 será renomeado a "Contoso Dev".

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

Parámetros requiridos para auth name

--index -i

Índice do perfil a nomear/renomear

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

pac auth select

Selecciona o perfil de autenticación que debe estar activo

Exemplo

pac auth select --index 2

Parámetros opcionais para auth select

--index -i

O índice do perfil para estar activo.

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

--name -n

O nome do perfil a estar activo

Nota: A lonxitude do nome debe estar comprendida entre 1 e 30

pac auth update

Actualizar o nome ou o entorno de destino dun perfil de autenticación existente

Exemplos

Os seguintes exemplos mostran o uso do pac auth update comando.

Actualizar o perfil de autenticación coa URL do entorno

Este exemplo móstrase como actualizar o perfil de autenticación co índice 1 co nome Contoso Dev e o URL https://contosodev.crm.dynamics.comdo entorno.

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

Actualizar o perfil de autenticación co ID de ambiente

Este exemplo móstrase como actualizar o perfil de autenticación co índice 1 co ID 00000000-0000-0000-0000-000000000000de ambiente.

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

Parámetros requiridos para auth update

--index -i

Índice do perfil a nomear/renomear

Nota: O valor debe ser un número enteiro cun valor mínimo de 1.

Parámetros opcionais para auth update

--environment -env

Contorna predeterminada (ID, url, nome único ou nome parcial).

--name -n

O nome que desexa dar a este perfil de autenticación (máximo 30 caracteres).

pac auth who

Mostrar información sobre o perfil de autenticación seleccionado actualmente

Consulte tamén

Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform

  • Last updated on