Condividi tramite

pac auth

Gestire la modalità di autenticazione a vari servizi

Connettersi al tenant

Usare il comando pac auth create per connettersi al tenant. L'esecuzione pac auth create crea un profilo di autenticazione nel computer. È possibile avere più profili di autenticazione disponibili. Avere più profili di autenticazione è interessante quando si lavora con più tenant. Ad esempio, quando l'azienda usa più tenant (per sviluppo, produzione e test) o quando si è un consulente che lavora per più clienti.

Il pac auth create comando ha un paio di parametri utili:

  • Il --environment parametro consente di connettersi automaticamente all'ambiente corretto. Se si omette il --environment parametro , si è connessi all'ambiente predefinito, ma con il --environment parametro aggiunto, è possibile connettersi a un ambiente diverso. È possibile usare l'ID ambiente, l'URL, il nome univoco o il nome parziale come valore.

  • Negli ambienti in cui non si ha la possibilità di usare un'esperienza interattiva, l'aggiunta del --deviceCode parametro assicura che sia comunque possibile connettersi. Ad esempio, in GitHub Codespaces il --deviceCode parametro viene aggiunto automaticamente quando si esegue pac auth create.

Example

Per connettersi all'ambiente HR-Dev , è possibile usare l'esempio seguente:

pac auth create --environment "HR-Dev"

Passare a un altro profilo di autenticazione

Quando si dispone di più profili di autenticazione, è possibile passare facilmente usando l'elenco di autenticazione pac e i comandi pac auth select .

Il pac auth list comando elenca tutti i profili di autenticazione nel computer. Il pac auth select comando seleziona un comando diverso.

pac auth list Esempio

Per elencare tutti i profili di autenticazione, usare l'esempio seguente:

pac auth list

L'esecuzione del pac auth list comando restituisce tutti i profili di autenticazione:

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

Selezionare un profilo di autenticazione diverso usando il valore di indice.

pac auth select --index 2

Commands

Command Description
pac auth clear Cancellare tutti i profili di autenticazione archiviati nel computer
pac auth create Creare e archiviare i profili di autenticazione in questo computer
pac auth delete Eliminare un profilo di autenticazione specifico
pac auth list Elencare i profili di autenticazione archiviati in questo computer
pac auth name Assegnare un nome o rinominare un profilo di autenticazione esistente
pac auth select Selezionare il profilo di autenticazione che deve essere attivo
pac auth update Aggiornare il nome o l'ambiente di destinazione di un profilo di autenticazione esistente
pac auth who Visualizzare le informazioni sul profilo di autenticazione attualmente selezionato

pac auth clear

Cancellare tutti i profili di autenticazione archiviati nel computer

pac auth create

Creare e archiviare i profili di autenticazione in questo computer

Esempi

Negli esempi seguenti viene illustrato l'uso del pac auth create comando .

Creazione di base

Questo esempio richiederà le credenziali e si connetterà al tenant a cui appartengono le credenziali.

pac auth create

Annotazioni

Quando si esegue l'interfaccia della riga di comando di Power Platform in Codespaces, verrà attivato un account di accesso al codice del dispositivo.

Creazione dell'ambiente

Questo esempio richiederà le credenziali e si connetterà all'ambiente Power Platform con l'ID ambiente specificato.

pac auth create --environment < Your environment ID >

Suggerimento

Per trovare un ID ambiente:

  1. Aprire l'interfaccia di amministrazione di Power Platform e selezionare l'ambiente a cui connettersi. Nella sezione Details (Dettagli) cercare Environment ID (ID ambiente)

Creazione denominata

In questo esempio viene eseguita l'autenticazione con il tenant e viene assegnato il nome MyOrg.

pac auth create --name MyOrg

Denominata Create with Service Principal (Creazione denominata con entità servizio)

Questo esempio esegue l'autenticazione con il tenant, assegna il nome MyOrg-SPN e usa un'entità servizio a tale scopo. Non dimenticare di aggiungere l'entità servizio all'ambiente.

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

Parametri facoltativi per la creazione dell'autenticazione

--applicationId -id

Facoltativo: ID applicazione con cui eseguire l'autenticazione.

--azureDevOpsFederated -adof

(Anteprima) Usare la federazione di Azure DevOps per l'autenticazione dell'entità servizio; richiede gli argomenti --tenant e --applicationId

Questo parametro non richiede alcun valore. È un cambio.

--certificateDiskPath -cdp

Facoltativo: percorso del disco certificato con cui eseguire l'autenticazione

--certificatePassword -cp

Facoltativo: password del certificato con cui eseguire l'autenticazione

--clientSecret -cs

Facoltativo: segreto client con cui eseguire l'autenticazione

--cloud -ci

Facoltativo: istanza cloud con cui eseguire l'autenticazione

Usare uno di questi valori:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Usare il flusso del codice del dispositivo Microsoft Entra ID per l'accesso interattivo.

Questo parametro non richiede alcun valore. È un cambio.

--environment -env

Ambiente predefinito (ID, URL, nome univoco o nome parziale).

--githubFederated -ghf

(Anteprima) Usare GitHub Federation per l'autenticazione dell'entità servizio; richiede gli argomenti --tenant e --applicationId

Questo parametro non richiede alcun valore. È un cambio.

--managedIdentity -mi

Usare l'identità gestita di Azure.

Questo parametro non richiede alcun valore. È un cambio.

--name -n

Nome da assegnare a questo profilo di autenticazione (massimo 30 caratteri).

Nota: la lunghezza del nome deve essere compresa tra 1 e 30

--password -p

Facoltativo: password con cui eseguire l'autenticazione

--tenant -t

ID tenant se si usa l'ID applicazione/segreto client o l'ID applicazione/certificato client.

--url -u

Deprecato: usare --environment invece.

--username -un

Facoltativo: nome utente con cui eseguire l'autenticazione; visualizza una finestra di dialogo Microsoft Entra ID se non specificata.

Osservazioni:

Per il cloud parametro, i valori da usare vengono mappati a questi altri acronimi o nomi comuni:

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

Problemi di autenticazione di WSL2

Quando si usa sottosistema Windows per Linux versione 2 (WSL2), potrebbero verificarsi problemi di autenticazione, Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools ad esempio quando non è presente alcun browser predefinito impostato nell'ambiente WSL2.

Per risolvere questo problema, è possibile usare l'autenticazione del codice del dispositivo aggiungendo il --deviceCode flag al auth create comando : pac auth create --environment {env-id} --deviceCode. Per completare il processo di autenticazione, è necessario immettere un codice in un browser esterno a WSL2.

pac auth delete

Eliminare un profilo di autenticazione specifico

Example

pac auth delete --index 2

Parametri facoltativi per l'eliminazione dell'autenticazione

--index -i

Indice del profilo da eliminare

Nota: il valore deve essere un numero intero con valore minimo pari a 1.

--name -n

Nome del profilo da attivare

Nota: la lunghezza del nome deve essere compresa tra 1 e 30

pac auth list

Elencare i profili di autenticazione archiviati in questo computer

pac auth name

Assegnare un nome o rinominare un profilo di autenticazione esistente

Example

L'esempio seguente illustra come rinominare un profilo di autenticazione. In questo caso, il profilo con indice 1 verrà rinominato in "Contoso Dev".

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

Parametri obbligatori per il nome dell'autenticazione

--index -i

Indice del profilo da denominare/rinominare

Nota: il valore deve essere un numero intero con valore minimo pari a 1.

--name -n

Nome da assegnare a questo profilo di autenticazione (massimo 30 caratteri).

Nota: la lunghezza del nome deve essere compresa tra 1 e 30

pac auth select

Selezionare il profilo di autenticazione che deve essere attivo

Example

pac auth select --index 2

Parametri facoltativi per la selezione dell'autenticazione

--index -i

Indice del profilo da attivare.

Nota: il valore deve essere un numero intero con valore minimo pari a 1.

--name -n

Nome del profilo da attivare

Nota: la lunghezza del nome deve essere compresa tra 1 e 30

pac auth update

Aggiornare il nome o l'ambiente di destinazione di un profilo di autenticazione esistente

Esempi

Gli esempi seguenti illustrano l'uso del comando pac auth update.

Aggiornare il profilo di autenticazione con l'URL dell'ambiente

Questo esempio illustra come aggiornare il profilo di autenticazione con indice 1 con il nome Contoso Dev e l'URL https://contosodev.crm.dynamics.comdell'ambiente .

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

Aggiornare il profilo di autenticazione con l'ID ambiente

Questo esempio illustra come aggiornare il profilo di autenticazione con indice 1 con l'ID 00000000-0000-0000-0000-000000000000ambiente .

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

Parametri obbligatori per l'aggiornamento dell'autenticazione

--index -i

Indice del profilo da denominare/rinominare

Nota: il valore deve essere un numero intero con valore minimo pari a 1.

Parametri facoltativi per l'aggiornamento dell'autenticazione

--environment -env

Ambiente predefinito (ID, URL, nome univoco o nome parziale).

--name -n

Nome da assegnare a questo profilo di autenticazione (massimo 30 caratteri).

pac auth who

Visualizzare le informazioni sul profilo di autenticazione attualmente selezionato

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform

  • Last updated on