Kopīgot, izmantojot

pac auth

Autentifikācijas pārvaldība dažādos pakalpojumos

Savienojuma izveide ar nomnieku

Izmantojiet komandu,pac auth create lai izveidotu savienojumu ar nomnieku. Palaižot pac auth create datorā tiek izveidots autentifikācijas profils. Var būt pieejami vairāki autentifikācijas profili. Vairāki autentifikācijas profili ir interesanti, ja strādājat ar vairākiem nomniekiem. Piemēram, ja jūsu uzņēmums izmanto vairākus nomniekus (izstrādei, ražošanai un testēšanai) vai ja esat konsultants, kas strādā vairākiem klientiem.

Komandai pac auth create ir pāris noderīgi parametri:

  • Šis --environment parametrs ļauj automātiski izveidot savienojumu ar pareizo vidi. Ja izlaižat parametru --environment , tiek izveidots savienojums ar noklusējuma vidi, bet, pievienojot tam pievienoto parametru --environment , varat izveidot savienojumu ar citu vidi. Kā vērtību var izmantot vides ID, URL, unikālo nosaukumu vai daļēju nosaukumu.

  • Vidēs, kurās nav iespējas izmantot interaktīvu pieredzi, parametra --deviceCode pievienošana nodrošina, ka joprojām varat izveidot savienojumu. Piemēram, GitHub kodu telpās parametrs --deviceCode tiek automātiski pievienots, palaižot pac auth create.

Piemērs

Lai izveidotu savienojumu ar HR-Dev vidi, varat izmantot šādu piemēru:

pac auth create --environment "HR-Dev"

Pārslēgšanās uz citu autentifikācijas profilu

Ja jums ir vairāki autentifikācijas profili, varat viegli pārslēgties, pac auth list izmantojot komandas un pac auth select .

Komanda pac auth list uzskaita visus autentifikācijas profilus jūsu datorā. Komanda pac auth select atlasa citu komandu.

pac auth list Piemērs

Lai uzskaitītu visus autentifikācijas profilus, izmantojiet šādu piemēru:

pac auth list

Palaižot komandu, pac auth list tiek atgriezti visi autentifikācijas profili:

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

Atlasiet citu autentifikācijas profilu, izmantojot indeksa vērtību.

pac auth select --index 2

Komandas

Komanda Apraksts
pac auth clear Notīrīt visus šajā datorā saglabātos autentifikācijas profilus
pac auth create Autentifikācijas profilu izveide un glabāšana šajā datorā
pac auth delete Konkrēta autentifikācijas profila dzēšana
pac auth list Šajā datorā saglabāto autentifikācijas profilu uzskaitījums
pac auth name Esoša autentifikācijas profila nosaukums vai pārdēvēšana
pac auth select Atlasīt, kuram autentifikācijas profilam jābūt aktīvam
pac auth update Esoša autentifikācijas profila nosaukuma vai mērķa vides atjaunināšana
pac auth who Parādīt informāciju par pašreiz atlasīto autentifikācijas profilu

pac auth clear

Notīrīt visus šajā datorā saglabātos autentifikācijas profilus

pac auth create

Autentifikācijas profilu izveide un glabāšana šajā datorā

Piemēri

Tālāk sniegtajos piemēros ir parādīta pac auth create komandas izmantošana.

Pamata izveide

Šajā piemērā tiek prasīts ievadīt akreditācijas datus un izveidots savienojums ar nomnieku, kuram pieder akreditācijas dati.

pac auth create

Piezīmes

Palaižot Power Platform CLI kodu telpās, šī darbība aktivizē ierīces koda pieteikšanos.

Vides izveide

Šajā piemērā tiek prasīts ievadīt akreditācijas datus un izveidots savienojums ar Power Platform vidi ar jūsu norādīto vides ID.

pac auth create --environment < Your environment ID >

Padoms

Lai atrastu vides ID: Atveriet Power Platform administrēšanas centru un atlasiet vidi , ar kuru vēlaties izveidot savienojumu. Sadaļā Detalizēta informācija meklējiet Vides ID

Izveidots ar nosaukumu

Šajā piemērā autentificējas nomnieks un tam tiek piešķirts nosaukums MyOrg.

pac auth create --name MyOrg

Nosaukts Izveidot ar pakalpojuma galveno

Šajā piemērā autentificējas ar nomnieku, piešķir tam nosaukumu MyOrg-SPN un izmanto pakalpojuma principālu. Neaizmirstiet pievienot pakalpojuma galveno vērtību savai videi.

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

Azure identitāte

Darbojoties vidē, kas atbalsta Azure identitāti (piemēram, Azure mākoņa čaula, Azure VM ar pārvaldīto identitāti vai Visual Studio kods ar Azure konta paplašinājumu), varat izmantot karodziņu, --managedIdentity lai autentificētos, izmantojot Azure identitāti. PAC CLI izmanto noklusējuma Azure akreditācijas datus , kas ir viedokļa, iepriekš konfigurēta akreditācijas datu ķēde.

Noklusējuma Azure akreditācijas dati ir paredzēti, lai atbalstītu daudzas vides, kā arī visbiežāk izmantotās autentifikācijas plūsmas un izstrādātāju rīkus. Darbību var pielāgot, iestatot vides mainīgos, kā aprakstīts noklusējuma Azure akreditācijas datu dokumentācijā. Piemēram, lai autentificētos, izmantojot lietotāja piešķirto pārvaldīto identitāti, iestatiet AZURE_CLIENT_ID vides mainīgo uz lietotāja piešķirtās pārvaldītās identitātes klienta ID. Plašāku informāciju skatiet sadaļā Programmas vides mainīgo iestatīšana.

Neobligātie parametri auth create

--applicationId -id

Neobligāti: lietojumprogrammas ID, ar kuru jāautentificējas.

--azureDevOpsFederated -adof

(Priekšskatījums) Izmantojiet Azure DevOps federāciju pakalpojuma galvenās autentifikācijai; prasa argumentus --tenant un --applicationId

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--certificateDiskPath -cdp

Neobligāti: sertifikāta diska ceļš, ar kuru autentificēties

--certificatePassword -cp

Neobligāti: sertifikāta parole, ar kuru autentificēties

--clientSecret -cs

Neobligāti: klienta noslēpums, ar kuru autentificēties

--cloud -ci

Neobligāti: mākoņa instance, ar kuru autentificēties

Izmantojiet vienu no šīm vērtībām:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Izmantojiet Microsoft Entra ID ierīces koda plūsmu interaktīvai pierakstīšanai.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--environment -env

Noklusējuma vide (ID, URL, unikāls nosaukums vai daļējs nosaukums).

--githubFederated -ghf

(Priekšskatījums) Izmantojiet GitHub federāciju pakalpojuma galvenā autentifikācijai; prasa argumentus --tenant un --applicationId

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--managedIdentity -mi

Izmantojiet noklusējuma Azure identitāti.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--name -n

Nosaukums, ko vēlaties piešķirt šim autentifikācijas profilam (ne vairāk kā 30 rakstzīmes).

Piezīme: Nosaukuma garumam jābūt no 1 līdz 30

--password -p

Neobligāti: parole, ar kuru autentificēties

--tenant -t

Nomnieka ID, ja izmantojat lietojumprogrammas ID/klienta noslēpumu vai lietojumprogrammas ID/klienta sertifikātu.

--url -u

Novecojis: izmantojiet --environment tā vietā.

--username -un

Neobligāti: lietotājvārds, ar kuru jāautentificējas; parāda Microsoft Entra ID dialoglodziņu, ja tas nav norādīts.

Piezīmes

Parametram cloud izmantojamās vērtības tiek kartētas uz šiem citiem izplatītajiem akronīmiem vai nosaukumiem:

  • GCC = UsGov
  • GCC augsts = UsGovHigh
  • DoD = UsGovDod

WSL2 autentifikācijas problēmas

Izmantojot Windows apakšsistēmu Linux 2. versiju (WSL2), var rasties autentifikācijas problēmas, piemēram Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools , ja WSL2 vidē nav iestatīta noklusējuma pārlūkprogramma.

Lai novērstu šo problēmu, varat izmantot ierīces koda autentifikāciju, pievienojot savai --deviceCode komandai karodziņuauth create: pac auth create --environment {env-id} --deviceCode. Lai pabeigtu autentifikācijas procesu, pārlūkprogrammā ārpus WSL2 ir jāievada kods.

pac auth delete

Konkrēta autentifikācijas profila dzēšana

Piemērs

pac auth delete --index 2

Neobligātie parametri auth delete

--index -i

Dzēšamā profila indekss

Piezīme: Vērtībai jābūt veselam skaitlim ar minimālo vērtību 1.

--name -n

Aktīvā profila nosaukums

Piezīme: Nosaukuma garumam jābūt no 1 līdz 30

pac auth list

Šajā datorā saglabāto autentifikācijas profilu uzskaitījums

pac auth name

Esoša autentifikācijas profila nosaukums vai pārdēvēšana

Piemērs

Šajā piemērā ir parādīts, kā pārdēvēt autentifikācijas profilu. Šādā gadījumā profils ar indeksu 1 tiks pārdēvēts par Contoso Dev.

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

Nepieciešamie parametri auth name

--index -i

Profila indekss, kas tiks nosaukts/pārdēvēts

Piezīme: Vērtībai jābūt veselam skaitlim ar minimālo vērtību 1.

--name -n

Nosaukums, ko vēlaties piešķirt šim autentifikācijas profilam (ne vairāk kā 30 rakstzīmes).

Piezīme: Nosaukuma garumam jābūt no 1 līdz 30

pac auth select

Atlasīt, kuram autentifikācijas profilam jābūt aktīvam

Piemērs

pac auth select --index 2

Neobligātie parametri auth select

--index -i

Aktīvā profila indekss.

Piezīme: Vērtībai jābūt veselam skaitlim ar minimālo vērtību 1.

--name -n

Aktīvā profila nosaukums

Piezīme: Nosaukuma garumam jābūt no 1 līdz 30

pac auth update

Esoša autentifikācijas profila nosaukuma vai mērķa vides atjaunināšana

Piemēri

Tālāk sniegtajos piemēros ir parādīta pac auth update komandas izmantošana.

Atjaunināt autentifikācijas profilu ar vides URL

Šajā piemērā parādīts, kā atjaunināt autentifikācijas profilu ar indeksu 1 ar nosaukumu Contoso Dev un vides URL https://contosodev.crm.dynamics.com.

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

Autentifikācijas profila atjaunināšana ar vides ID

Šajā piemērā parādīts, kā atjaunināt autentifikācijas profilu ar indeksu 1 ar vides ID 00000000-0000-0000-0000-000000000000.

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

Nepieciešamie parametri auth update

--index -i

Profila indekss, kas tiks nosaukts/pārdēvēts

Piezīme: Vērtībai jābūt veselam skaitlim ar minimālo vērtību 1.

Neobligātie parametri auth update

--environment -env

Noklusējuma vide (ID, URL, unikāls nosaukums vai daļējs nosaukums).

--name -n

Nosaukums, ko vēlaties piešķirt šim autentifikācijas profilam (ne vairāk kā 30 rakstzīmes).

pac auth who

Parādīt informāciju par pašreiz atlasīto autentifikācijas profilu

Skatīt arī

Microsoft Power Platform CLI komandu grupas
Microsoft Power Platform CLI pārskats

  • Last updated on