Jaa


pac auth

Eri palveluihin todennustavan hallinta

Muodosta yhteys vuokraajaan

Muodosta yhteys vuokraajaan komennollapac auth create . Suorittaminen pac auth create luo todennusprofiilin tietokoneestasi. Käytettävissäsi voi olla useita todennusprofiileja. Useiden todennusprofiilien käyttö on kiinnostavaa, kun työskentelet useiden vuokraajien kanssa. Esimerkiksi silloin, kun yrityksesi käyttää useita vuokraajia (kehityksessä, tuotannossa ja testauksessa) tai kun olet konsultti, joka työskentelee useille asiakkaille.

Komennolla pac auth create on pari hyödyllistä parametria:

  • --environment Parametrin avulla voit muodostaa automaattisesti yhteyden oikeaan ympäristöön. Jos poistat parametrin --environment , olet yhteydessä oletusympäristöön, mutta --environment siihen on lisätty parametri, voit muodostaa yhteyden toiseen. Voit käyttää arvona ympäristötunnusta, URL-osoitetta, yksilöllistä nimeä tai osittaista nimeä.

  • Ympäristöissä, joissa et voi käyttää vuorovaikutteista kokemusta, parametrin --deviceCode lisääminen varmistaa, että voit silti muodostaa yhteyden. Esimerkiksi GitHub Codespacesissa parametri lisätään automaattisesti, --deviceCode kun suoritat kohteen pac auth create.

Esimerkki:

Voit muodostaa yhteyden HR-Dev ympäristöön seuraavan esimerkin avulla:

pac auth create --environment "HR-Dev"

Toiseen todennusprofiiliin vaihtaminen

Kun sinulla on useita todennusprofiileja, voit helposti vaihtaa -komentojen ja - pac auth listpac auth select komentojen avulla.

Komennossa pac auth list luetellaan kaikki tietokoneessasi olevat todennusprofiilit. Komento pac auth select valitsee eri komennon.

pac auth list Esimerkki

Voit luetella kaikki todennusprofiilit seuraavalla esimerkillä:

pac auth list

Komennon suorittaminen pac auth list palauttaa kaikki todennusprofiilit:

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

Valitse eri todennusprofiili indeksiarvon avulla.

pac auth select --index 2

Komennot

Komento Kuvaus
pac auth clear Tyhjennä kaikki tähän tietokoneeseen tallennetut todennusprofiilit
pac auth create Todennusprofiilien luominen ja tallentaminen tähän tietokoneeseen
pac auth delete Tietyn todennusprofiilin poistaminen
pac auth list Luettele tähän tietokoneeseen tallennetut todennusprofiilit
pac auth name Olemassa olevan todennusprofiilin nimeäminen tai nimeäminen uudelleen
pac auth select Valitse, mikä todennusprofiilin tulee olla aktiivinen
pac auth update Olemassa olevan todennusprofiilin nimen tai kohdeympäristön päivittäminen
pac auth who Näytä valittua todennusprofiilia koskevat tiedot

pac auth clear

Tyhjennä kaikki tähän tietokoneeseen tallennetut todennusprofiilit

pac auth create

Todennusprofiilien luominen ja tallentaminen tähän tietokoneeseen

Esimerkit

Seuraavissa esimerkeissä näytetään komennon pac auth create käyttö.

Perusluonti

Tässä esimerkissä sinulta pyydetään tunnistetietoja ja muodostetaan yhteys vuokraajaan, johon tunnistetiedot kuuluvat.

pac auth create

Note

Kun Suoritat Power Platform CLI:tä Codespacesissa, tämä toiminto käynnistää laitekoodin kirjautumisen.

Ympäristön luominen

Tässä esimerkissä sinulta pyydetään tunnistetietoja ja muodostetaan yhteys Power Platform -ympäristöön määrittämälläsi ympäristötunnuksella.

pac auth create --environment < Your environment ID >

Vinkki

Ympäristötunnuksen etsiminen: Avaa Power Platform -hallintakeskus ja valitse ympäristö , johon haluat muodostaa yhteyden. Etsi Tiedot-osiostaYmpäristötunnus

Nimetty luonti

Tässä esimerkissä todennetaan vuokraajan kanssa ja sille annetaan nimi MyOrg.

pac auth create --name MyOrg

Nimetty Luo palvelun päänimen avulla

Tämä esimerkki todennetaan vuokraajan kanssa, sille annetaan nimi MyOrg-SPN ja siinä käytetään palvelun päänimeä. Muista lisätä palvelun päänimi ympäristöösi.

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

Azure Identity

Kun käytät Azure-käyttäjätietoa tukevassa ympäristössä (kuten Azure Cloud Shellissä, Azure-näennäiskoneessa, jossa on hallittu käyttäjätieto tai Visual Studio -koodi, jossa on Azure-tililaajennus), voit todentautua Azure-käyttäjätietojen avulla -merkinnän --managedIdentity avulla. PAC CLI käyttää Azure-oletustunnistetietoa , joka on mielipiteetön ja esimääritetty tunnistetietoketju.

Oletusarvoinen Azure-tunnistetieto on suunniteltu tukemaan monia ympäristöjä sekä yleisimpiä todentamistyönkulkuja ja kehittäjätyökaluja. Voit mukauttaa toimintaa määrittämällä ympäristömuuttujia Azuren oletusarvoisten tunnistetietojen ohjeissa kuvatulla tavalla. Jos haluat esimerkiksi todentaa käyttäjän määrittämien hallittujen käyttäjätietojen avulla, määritä AZURE_CLIENT_ID ympäristömuuttuja käyttäjän määrittämien hallittujen käyttäjätietojen asiakastunnukseen. Lisätietoja on kohdassa Määritä sovelluksen ympäristömuuttujat.

Valinnaiset parametrit parametrille auth create

--applicationId -id

Valinnainen: Sovellustunnus, jolla todennettava.

--azureDevOpsFederated -adof

(esikatselu) Käytä Azure DevOps -liittoutumista palvelun päänimelle Todennus; vaatii --tenant- ja --applicationId-argumentit

Tämä parametri ei vaadi arvoa. Se on valitsin.

--certificateDiskPath -cdp

Valinnainen: Varmennelevyn polku, jolla todennettavana on

--certificatePassword -cp

Valinnainen: Varmenteen salasana todentamiseen

--clientSecret -cs

Valinnainen: Asiakassalaisuus, jolla todennetaan

--cloud -ci

Valinnainen: Pilvipalveluesiintymä, jolla todennettavana on

Käytä jotain näistä arvoista:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Käytä vuorovaikutteiseen kirjautumisessa Microsoft Entra ID -laitekoodin työnkulkua.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--environment -env

Oletusympäristö (tunnus, URL-osoite, yksilöllinen nimi tai osittainen nimi).

--githubFederated -ghf

(esikatselu) Käytä GitHub-liittoutumista palvelun päänimen todennusta varten; vaatii --tenant- ja --applicationId-argumentit

Tämä parametri ei vaadi arvoa. Se on valitsin.

--managedIdentity -mi

Käytä azure-oletusarvoja käyttäjätietoja.

Tämä parametri ei vaadi arvoa. Se on valitsin.

--name -n

Nimi, jonka haluat antaa tälle todennusprofiilille (enintään 30 merkkiä).

Huomautus: Nimen pituuden on oltava välillä 1–30

--password -p

Valinnainen: Salasana, jolla todennettavana on

--tenant -t

Vuokraajatunnus, jos käytössä on sovellustunnus/asiakassalaisuus tai sovellustunnus/asiakasvarmenne.

--url -u

Vanhentunut: Käytä --environment sen sijaan.

--username -un

Valinnainen: Käyttäjänimi, jolla todennettavana on; näyttää Microsoft Entra ID -valintaikkunan, jos sitä ei ole määritetty.

Huomautukset

-parametrin cloud arvot, joita käytetään kartalla näihin muihin yleisiin lyhentimiin tai nimiin:

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

WSL2-todennusongelmat

Käytettäessä Windows-alijärjestelmää Linuxin versiossa 2 (WSL2) saattaa ilmetä todennusongelmia, kuten silloin, kun Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools WSL2-ympäristössäsi ei ole oletusselainta määritetty.

Voit kiertää tämän ongelman käyttämällä laitekoodin todentamista lisäämällä -merkinnän --deviceCode komentoosi auth create : pac auth create --environment {env-id} --deviceCode. Sinun on annettava koodi selaimeen WSL2:n ulkopuolella, jotta voit suorittaa todennusprosessin.

pac auth delete

Tietyn todennusprofiilin poistaminen

Esimerkki:

pac auth delete --index 2

Valinnaiset parametrit parametrille auth delete

--index -i

Poistettavan profiilin indeksi

Huomautus: arvon on oltava kokonaisluku, jonka pienin arvo on 1.

--name -n

Aktiivisena olevan profiilin nimi

Huomautus: Nimen pituuden on oltava välillä 1–30

pac auth list

Luettele tähän tietokoneeseen tallennetut todennusprofiilit

pac auth name

Olemassa olevan todennusprofiilin nimeäminen tai nimeäminen uudelleen

Esimerkki:

Seuraavassa esimerkissä näytetään, miten todennusprofiili nimetään uudelleen. Tässä tapauksessa indeksillä 1 oleva profiili nimetään uudelleen nimellä "Contoso Dev".

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

Pakolliset parametrit parametrille auth name

--index -i

Nimettävän/uudelleennimettävän profiilin indeksi

Huomautus: arvon on oltava kokonaisluku, jonka pienin arvo on 1.

--name -n

Nimi, jonka haluat antaa tälle todennusprofiilille (enintään 30 merkkiä).

Huomautus: Nimen pituuden on oltava välillä 1–30

pac auth select

Valitse, mikä todennusprofiilin tulee olla aktiivinen

Esimerkki:

pac auth select --index 2

Valinnaiset parametrit parametrille auth select

--index -i

Aktiivisena olevan profiilin indeksi.

Huomautus: arvon on oltava kokonaisluku, jonka pienin arvo on 1.

--name -n

Aktiivisena olevan profiilin nimi

Huomautus: Nimen pituuden on oltava välillä 1–30

pac auth update

Olemassa olevan todennusprofiilin nimen tai kohdeympäristön päivittäminen

Esimerkit

Seuraavissa esimerkeissä näytetään komennon pac auth update käyttö.

Todennusprofiilin päivittäminen ympäristön URL-osoitteella

Tässä esimerkissä näytetään, miten todennusprofiiliin päivitetään indeksillä 1 sen nimi Contoso Dev ja ympäristön URL-osoite https://contosodev.crm.dynamics.com.

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

Todennusprofiilin päivittäminen ympäristötunnuksella

Tässä esimerkissä näytetään, miten todennusprofiiliin päivitetään indeksillä 1 ympäristötunnuksella 00000000-0000-0000-0000-000000000000.

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

Pakolliset parametrit parametrille auth update

--index -i

Nimettävän/uudelleennimettävän profiilin indeksi

Huomautus: arvon on oltava kokonaisluku, jonka pienin arvo on 1.

Valinnaiset parametrit parametrille auth update

--environment -env

Oletusympäristö (tunnus, URL-osoite, yksilöllinen nimi tai osittainen nimi).

--name -n

Nimi, jonka haluat antaa tälle todennusprofiilille (enintään 30 merkkiä).

pac auth who

Näytä valittua todennusprofiilia koskevat tiedot

Katso myös

Microsoft Power Platformin komentoryhmät
Microsoft Power Platform CLI -komentorivikäyttöliittymän yleiskatsaus