Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
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:
--environmentParametrin avulla voit muodostaa automaattisesti yhteyden oikeaan ympäristöön. Jos poistat parametrin--environment, olet yhteydessä oletusympäristöön, mutta--environmentsiihen 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
--deviceCodelisääminen varmistaa, että voit silti muodostaa yhteyden. Esimerkiksi GitHub Codespacesissa parametri lisätään automaattisesti,--deviceCodekun suoritat kohteenpac 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:
PublicUsGovUsGovHighUsGovDodChina
--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
- Todennusprofiilin päivittäminen ympäristötunnuksella
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