pac auth

Erinevate teenuste autentimise haldamine

Rentnikuga ühenduse loomine

pac auth create Kasutage rentnikuga ühenduse loomiseks käsku. Töötamine pac auth create loob teie arvutis autentimisprofiili. Saadaval võib olla mitu autentimisprofiili. Kui töötate mitme rentnikuga, on mitme autentimisprofiili olemasolu huvitav. Näiteks kui teie ettevõte kasutab mitut rentnikku (arenduseks, tootmiseks ja testimiseks) või kui olete konsultant, kes töötab mitme kliendi jaoks.

Käsul pac auth create on paar kasulikku parameetrit.

• Parameeter --environment võimaldab teil automaatselt luua ühenduse õige keskkonnaga. Kui jätate --environment parameetri välja, olete ühendatud vaikekeskkonnaga, kuid sellele lisatud parameetriga --environment saate ühenduse luua mõne muu parameetriga. Väärtusena saate kasutada keskkonna ID-t, URL-i, kordumatut nime või osalist nime.

• Keskkondades, kus te ei saa interaktiivset kasutuskogemust kasutada, tagab parameetri lisamine --deviceCode ühenduse loomise. Näiteks GitHubi koodiruumides --deviceCode lisatakse parameeter käivitamisel pac auth createautomaatselt.

Näide

Keskkonnaga ühenduse loomiseks HR-Dev saate kasutada järgmist näidet.

pac auth create --environment "HR-Dev"

Mõne muu autentimisprofiili aktiveerimine

Kui teil on mitu autentimisprofiili, saate hõlpsasti käskude ja pac auth select käskude abil pac auth list vahetada.

Käsuga loetletakse pac auth list kõik teie arvutis olevad autentimisprofiilid. Käsk pac auth select valib mõne muu käsu.

pac auth list Näide

Kõigi autentimisprofiilide loetlemiseks kasutage järgmist näidet.

pac auth list

Käsu käitamine pac auth list tagastab kõik autentimisprofiilid:

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

Valige registriväärtuse abil mõni muu autentimisprofiil.

pac auth select --index 2

Käsud

Käsk	Kirjeldus
pac auth clear	Tühjenda kõik sellesse arvutisse salvestatud autentimisprofiilid
pac auth create	Selles arvutis autentimisprofiilide loomine ja talletamine
pac auth delete	Kindla autentimisprofiili kustutamine
pac auth list	Selles arvutis talletatud autentimisprofiilide loetlemine
pac auth name	Olemasolevale autentimisprofiilile nime panemine või olemasoleva autentimisprofiili ümbernimetamine
pac auth select	Aktiivse autentimisprofiili valimine
pac auth update	Olemasoleva autentimisprofiili nime või sihtkeskkonna värskendamine
pac auth who	Kuva teave praegu valitud autentimisprofiili kohta

pac auth clear

Tühjenda kõik sellesse arvutisse salvestatud autentimisprofiilid

pac auth create

Selles arvutis autentimisprofiilide loomine ja talletamine

Näited

Järgmised näited näitavad käsu kasutamist pac auth create .

• Põhiline loomine
• Keskkonna loomine
• Nimega loomine
• Nimega loo teenusesubjektiga
• Azure'i identiteet

Põhiline loomine

Selles näites küsitakse identimisteavet ja luuakse ühendus rentnikuga, kuhu identimisteave kuulub.

pac auth create

Märkus.

Power Platform CLI käivitamisel koodiruumides käivitab see toiming seadme koodi sisselogimise.

Keskkonna loomine

Selles näites küsitakse identimisteavet ja luuakse ühendus Power Platformi keskkonnaga teie määratud keskkonna ID-ga.

pac auth create --environment < Your environment ID >

Jootraha

Keskkonna ID leidmiseks avage Power Platformi halduskeskus ja valige Keskkond , millega soovite ühenduse luua. Otsige jaotises Üksikasjad üles keskkonna ID

Nimega loomine

Selles näites autenditakse teie rentnik ja selle nimi MyOrgon .

pac auth create --name MyOrg

Nimega loo teenusesubjektiga

See näide autendib teie rentnikuga, annab selle nime MyOrg-SPN ja kasutab selleks teenusesubjekti. Ärge unustage teenusesubjekti oma keskkonda lisada.

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

Azure'i identiteet

Kui töötate keskkonnas, mis toetab Azure Identity'i (nt Azure Cloud Shell, Azure VM koos hallatava identiteediga või Visual Studio kood Azure'i kontolaiendiga), saate seda lippu kasutada --managedIdentity Azure Identity'i abil autentimiseks. PAC CLI kasutab Azure'i vaikemandaati , mis on eelkonfigureeritud eelkonfigureeritud identimisteabe ahel.

Azure'i vaikemandaat on loodud toetama paljusid keskkondi koos levinumate autentimisvoogude ja arendusriistadega. Saate kohandada käitumist, määrates keskkonnamuutujad vastavalt Azure'i vaikemandaadi dokumentatsioonile. Näiteks kasutaja määratud hallatava identiteedi abil autentimiseks seadke AZURE_CLIENT_ID keskkonnamuutujaks kasutaja määratud hallatava identiteedi kliendi-ID. Lisateavet leiate teemast Rakenduse keskkonnamuutujate määramine.

Valikulised parameetrid: auth create

--applicationId -id

Valikuline: rakenduse ID, millega autentida.

--azureDevOpsFederated -adof

(Eelvaade) Azure DevOps Federationi kasutamine teenusesubjekti autentimiseks; nõuab argumente --rentnik ja --applicationId

See parameeter ei vaja väärtust. See on lüliti.

--certificateDiskPath -cdp

Valikuline: serdiketta tee, millega autentida

--certificatePassword -cp

Valikuline: serdiparool, millega autentida

--clientSecret -cs

Valikuline: kliendisaladus, millega autentida

--cloud -ci

Valikuline: pilveeksemplar, millega autentida

Kasutage ühte järgmistest väärtustest.

• Public
• UsGov
• UsGovHigh
• UsGovDod
• China

--deviceCode -dc

Kasutage interaktiivseks sisselogimiseks Microsoft Entra ID seadme koodivoogu.

See parameeter ei vaja väärtust. See on lüliti.

--environment -env

Vaikekeskkond (ID, URL, kordumatu nimi või osaline nimi).

--githubFederated -ghf

(Eelvaade) GitHubi föderatsiooni kasutamine teenusesubjekti autentimiseks; nõuab argumente --rentnik ja --applicationId

See parameeter ei vaja väärtust. See on lüliti.

--managedIdentity -mi

Kasuta Azure'i vaikeidentiteeti.

See parameeter ei vaja väärtust. See on lüliti.

--name -n

Nimi, mille soovite sellele autentimisprofiilile anda (kuni 30 märki).

Märkus. Nime pikkus peaks olema vahemikus 1–30

--password -p

Valikuline: parool, millega autentida

--tenant -t

Rentniku ID, kui kasutatakse rakenduse ID-ga/klientrakenduse saladust või rakenduse ID-ga /kliendi serti.

--url -u

Taunitud: kasutage --environment selle asemel.

--username -un

Valikuline: kasutajanimi, millega autentida; kuvab Microsoft Entra ID dialoogi, kui seda pole määratud.

Märkused

cloud Parameetri puhul väärtused, mida kasutada vastendamiseks teiste levinud akronüümide või nimedega:

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

WSL2 autentimisprobleemid

Kui kasutate Windowsi alamsüsteemi Linuxi versiooni 2 (WSL2), võib teil olla autentimisprobleeme, näiteks Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools kui WSL2 keskkonnas pole määratud vaikebrauserit.

Selle probleemi lahendamiseks saate kasutada seadmekoodi autentimist, lisades --deviceCode käsule auth create lipu: pac auth create --environment {env-id} --deviceCode. Autentimistoimingu lõpuleviimiseks peate sisestama koodi brauseris väljaspool WSL2-d.

pac auth delete

Kindla autentimisprofiili kustutamine

Näide

pac auth delete --index 2

Valikulised parameetrid: auth delete

--index -i

Kustutatava profiili indeks

Märkus. Väärtus peab olema täisarv, mille miinimumväärtus on 1.

--name -n

Aktiivse profiili nimi

Märkus. Nime pikkus peaks olema vahemikus 1–30

pac auth list

Selles arvutis talletatud autentimisprofiilide loetlemine

pac auth name

Olemasolevale autentimisprofiilile nime panemine või olemasoleva autentimisprofiili ümbernimetamine

Näide

Järgmises näites kirjeldatakse autentimisprofiili ümbernimetamist. Sel juhul nimetatakse registriga 1 profiil ümber profiiliks "Contoso Dev".

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

Nõutavad parameetrid: auth name

--index -i

Nimetatava/ümbernimetatava profiili indeks

Märkus. Väärtus peab olema täisarv, mille miinimumväärtus on 1.

--name -n

Nimi, mille soovite sellele autentimisprofiilile anda (kuni 30 märki).

Märkus. Nime pikkus peaks olema vahemikus 1–30

pac auth select

Aktiivse autentimisprofiili valimine

Näide

pac auth select --index 2

Valikulised parameetrid: auth select

--index -i

Aktiivse profiili indeks.

Märkus. Väärtus peab olema täisarv, mille miinimumväärtus on 1.

--name -n

Aktiivse profiili nimi

Märkus. Nime pikkus peaks olema vahemikus 1–30

pac auth update

Olemasoleva autentimisprofiili nime või sihtkeskkonna värskendamine

Näited

Järgmised näited näitavad käsu kasutamist pac auth update .

• Värskenda autentimisprofiil keskkonna URL-iga
• Värskenda autentimisprofiil keskkonna ID-ga

Värskenda autentimisprofiil keskkonna URL-iga

Selles näites kirjeldatakse autentimisprofiili värskendamist registriga 1 nime Contoso Dev ja keskkonna URL-iga https://contosodev.crm.dynamics.com.

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

Värskenda autentimisprofiil keskkonna ID-ga

Selles näites kirjeldatakse autentimisprofiili värskendamist registriga 1 keskkonna ID-ga 00000000-0000-0000-0000-000000000000.

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

Nõutavad parameetrid: auth update

--index -i

Nimetatava/ümbernimetatava profiili indeks

Märkus. Väärtus peab olema täisarv, mille miinimumväärtus on 1.

Valikulised parameetrid: auth update

--environment -env

Vaikekeskkond (ID, URL, kordumatu nimi või osaline nimi).

--name -n

Nimi, mille soovite sellele autentimisprofiilile anda (kuni 30 märki).

pac auth who

Kuva teave praegu valitud autentimisprofiili kohta

Vaata ka

Microsoft Power Platform CLI käsurühmad
Microsoft Power Platform CLI ülevaade