Megosztás:

pac auth

A különböző szolgáltatások hitelesítésének kezelése

Csatlakozás a bérlőhöz

pac auth create A parancs használatával csatlakozzon a bérlőhöz. A futtatás pac auth create létrehoz egy hitelesítési profilt a számítógépen. Több hitelesítési profil is elérhető. Több hitelesítési profil használata akkor érdekes, ha több bérlővel dolgozik. Ha például a vállalat több bérlőt használ (fejlesztéshez, éles környezethez és teszteléshez), vagy ha Ön egy tanácsadó, aki több ügyfélnek dolgozik.

A pac auth create parancs néhány hasznos paraméterrel rendelkezik:

  • A --environment paraméter lehetővé teszi a megfelelő környezethez való automatikus csatlakozást. Ha kihagyja a --environment paramétert, az alapértelmezett környezethez csatlakozik, de a --environment hozzá hozzáadott paraméterrel csatlakozhat egy másikhoz. Értékként használhatja a környezeti azonosítót, az URL-címet, az egyedi nevet vagy a részleges nevet.

  • Azokban a környezetekben, ahol nem tud interaktív felületet használni, a --deviceCode paraméter hozzáadása biztosítja, hogy továbbra is csatlakozni tudjon. Például a GitHub Codespacesben a rendszer automatikusan hozzáadja a --deviceCode paramétert a futtatáskor pac auth create.

Example

A környezethez való HR-Dev csatlakozáshoz használja az alábbi példát:

pac auth create --environment "HR-Dev"

Váltás másik hitelesítési profilra

Ha több hitelesítési profillal rendelkezik, egyszerűen válthat a parancsok és pac auth select a pac auth list parancsok használatával.

A pac auth list parancs felsorolja a számítógépen található összes hitelesítési profilt. A pac auth select parancs egy másik parancsot jelöl ki.

pac auth list Példa

Az összes hitelesítési profil listázásához használja az alábbi példát:

pac auth list

A parancs futtatása az pac auth list összes hitelesítési profilt visszaadja:

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

Válasszon egy másik hitelesítési profilt az indexérték használatával.

pac auth select --index 2

Commands

Command Description
pac auth clear A számítógépen tárolt összes hitelesítési profil törlése
pac auth create Hitelesítési profilok létrehozása és tárolása ezen a számítógépen
pac auth delete Adott hitelesítési profil törlése
pac auth list A számítógépen tárolt hitelesítési profilok listázása
pac auth name Meglévő hitelesítési profil neve vagy átnevezése
pac auth select Válassza ki, hogy melyik hitelesítési profil legyen aktív
pac auth update Meglévő hitelesítési profil nevének vagy célkörnyezetének frissítése
pac auth who Az aktuálisan kiválasztott hitelesítési profil adatainak megjelenítése

pac auth clear

A számítógépen tárolt összes hitelesítési profil törlése

pac auth create

Hitelesítési profilok létrehozása és tárolása ezen a számítógépen

Példák

Az alábbi példák a parancs használatát pac auth create mutatják be.

Alapszintű létrehozás

Ez a példa kéri a hitelesítő adatokat, és csatlakozik ahhoz a bérlőhöz, amelyhez a hitelesítő adatok tartoznak.

pac auth create

Megjegyzés:

Amikor a Power Platform parancssori felületét a Codespacesben futtatja, ez a művelet aktivál egy eszközkód-bejelentkezést.

Környezet létrehozása

Ez a példa hitelesítő adatokat kér, és a megadott környezeti azonosítóval csatlakozik a Power Platform-környezethez.

pac auth create --environment < Your environment ID >

Jótanács

A környezetazonosító megkereséséhez nyissa meg a Power Platform felügyeleti központját , és válassza ki azt a környezetet , amelyhez csatlakozni szeretne. A Részletek szakaszban keresse meg a környezet azonosítóját

Névvel ellátott létrehozás

Ez a példa hitelesíti a bérlőt, és megadja neki a nevet MyOrg.

pac auth create --name MyOrg

Elnevezett létrehozás szolgáltatásnévvel

Ez a példa hitelesíti a bérlőt, megadja a nevet MyOrg-SPN , és ehhez egy egyszerű szolgáltatásnevet használ. Ne felejtse el hozzáadni a szolgáltatásnevet a környezetéhez.

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

Azure Identity

Ha olyan környezetben fut, amely támogatja az Azure Identity szolgáltatást (például az Azure Cloud Shellt, a felügyelt identitással rendelkező Azure-beli virtuális gépet vagy az Azure-fiókbővítménnyel rendelkező Visual Studio Code-ot), a --managedIdentity jelölő használatával hitelesítheti az Azure Identity-et. A PAC CLI az Alapértelmezett Azure Credentialt használja, amely egy véleményezett, előre konfigurált hitelesítőadat-lánc.

Az alapértelmezett Azure Credential számos környezetet támogat, a leggyakoribb hitelesítési folyamatokkal és fejlesztői eszközökkel együtt. A viselkedés testreszabásához állítsa be a környezeti változókat az Alapértelmezett Azure Credential dokumentációban leírtak szerint. Ha például felhasználó által hozzárendelt felügyelt identitással szeretne hitelesíteni, állítsa a AZURE_CLIENT_ID környezeti változót a felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítójára. További részleteket az alkalmazáskörnyezet változóinak beállítása című témakörben talál.

Választható paraméterek a következőhöz: auth create

--applicationId -id

Nem kötelező: A hitelesítéshez szükséges alkalmazásazonosító.

--azureDevOpsFederated -adof

(Előzetes verzió) Az Azure DevOps Federation for Service Principal Auth használata; --tenant és --applicationId argumentumokat igényel

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--certificateDiskPath -cdp

Nem kötelező: A tanúsítványlemez elérési útja a hitelesítéshez

--certificatePassword -cp

Nem kötelező: A hitelesítéshez szükséges tanúsítványjelszó

--clientSecret -cs

Nem kötelező: A hitelesítéshez szükséges ügyfélkulcs

--cloud -ci

Nem kötelező: A hitelesítéshez szükséges felhőpéldány

Használja az alábbi értékek egyikét:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Interaktív bejelentkezéshez használja a Microsoft Entra ID Device Code-folyamatot.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--environment -env

Alapértelmezett környezet (azonosító, URL-cím, egyedi név vagy részleges név).

--githubFederated -ghf

(Előzetes verzió) A GitHub Federation for Service Principal Auth használata; --tenant és --applicationId argumentumokat igényel

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--managedIdentity -mi

Alapértelmezett Azure-identitás használata.

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

--name -n

A hitelesítési profilnak adni kívánt név (legfeljebb 30 karakter).

Megjegyzés: A név hosszának 1 és 30 között kell lennie

--password -p

Nem kötelező: A hitelesítéshez szükséges jelszó

--tenant -t

Bérlőazonosító, ha alkalmazásazonosítót/ügyfélkulcsot vagy alkalmazásazonosítót/ügyféltanúsítványt használ.

--url -u

Elavult: Használja --environment helyette.

--username -un

Nem kötelező: A hitelesítéshez használt felhasználónév; Ha nincs megadva, megjelenik egy Microsoft Entra-azonosító párbeszédpanel.

Megjegyzések

cloud A paraméter esetében a leképezéshez használt értékek az alábbi gyakori mozaikszavakra vagy nevekre lesznek leképezve:

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

WSL2-hitelesítési problémák

A Linux 2-es verziójához készült Windows-alrendszer (WSL2) használatakor hitelesítési problémák merülhetnek fel, például Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools ha nincs alapértelmezett böngésző beállítva a WSL2-környezetben.

A probléma megoldásához használja az eszközkód-hitelesítést úgy, hogy hozzáadja a jelölőt a --deviceCodeauth create parancshoz: pac auth create --environment {env-id} --deviceCode. A hitelesítési folyamat befejezéséhez be kell írnia egy kódot a WSL2-n kívüli böngészőben.

pac auth delete

Adott hitelesítési profil törlése

Example

pac auth delete --index 2

Választható paraméterek a következőhöz: auth delete

--index -i

A törölni kívánt profil indexe

Megjegyzés: Az értéknek legalább 1 értékű egész számnak kell lennie.

--name -n

Az aktív profil neve

Megjegyzés: A név hosszának 1 és 30 között kell lennie

pac auth list

A számítógépen tárolt hitelesítési profilok listázása

pac auth name

Meglévő hitelesítési profil neve vagy átnevezése

Example

Az alábbi példa bemutatja, hogyan nevezhet át egy hitelesítési profilt. Ebben az esetben az 1. indexű profil átnevezve lesz a "Contoso Dev" névre.

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

Kötelező paraméterek a következőhöz: auth name

--index -i

Az elnevezendő/átnevezendő profil indexe

Megjegyzés: Az értéknek legalább 1 értékű egész számnak kell lennie.

--name -n

A hitelesítési profilnak adni kívánt név (legfeljebb 30 karakter).

Megjegyzés: A név hosszának 1 és 30 között kell lennie

pac auth select

Válassza ki, hogy melyik hitelesítési profil legyen aktív

Example

pac auth select --index 2

Választható paraméterek a következőhöz: auth select

--index -i

Az aktív profil indexe.

Megjegyzés: Az értéknek legalább 1 értékű egész számnak kell lennie.

--name -n

Az aktív profil neve

Megjegyzés: A név hosszának 1 és 30 között kell lennie

pac auth update

Meglévő hitelesítési profil nevének vagy célkörnyezetének frissítése

Példák

Az alábbi példák a parancs használatát pac auth update mutatják be.

Hitelesítési profil frissítése környezeti URL-címmel

Ez a példa bemutatja, hogyan frissítheti a hitelesítési profilt az 1. indexre a névvel Contoso Dev és a környezeti URL-címmel https://contosodev.crm.dynamics.com.

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

Hitelesítési profil frissítése környezeti azonosítóval

Ez a példa bemutatja, hogyan frissítheti a hitelesítési profilt az 1. indexre a környezeti azonosítóval 00000000-0000-0000-0000-000000000000.

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

Kötelező paraméterek a következőhöz: auth update

--index -i

Az elnevezendő/átnevezendő profil indexe

Megjegyzés: Az értéknek legalább 1 értékű egész számnak kell lennie.

Választható paraméterek a következőhöz: auth update

--environment -env

Alapértelmezett környezet (azonosító, URL-cím, egyedi név vagy részleges név).

--name -n

A hitelesítési profilnak adni kívánt név (legfeljebb 30 karakter).

pac auth who

Az aktuálisan kiválasztott hitelesítési profil adatainak megjelenítése

Lásd még

Microsoft Power Platform parancssori felület parancscsoportjai
A Microsoft Power Platform parancssori felületének áttekintése

  • Last updated on