pac auth

Spravovanie overenia v rôznych službách

Pripojenie k nájomníkovi

pac auth create Pripojte sa k nájomníkovi pomocou príkazu . Spustením pac auth create sa vytvorí overovací profil vo vašom počítači. Môžete mať k dispozícii viacero overovacích profilov. Viaceré overovacie profily sú zaujímavé pri práci s viacerými nájomníkmi. Ak napríklad vaša spoločnosť používa viacero nájomníkov (na vývoj, produkciu a testovanie) alebo ak ste konzultant, ktorý pracuje pre viacerých zákazníkov.

Príkaz pac auth create má niekoľko užitočných parametrov:

• Parameter --environment vám umožňuje automaticky sa pripojiť k správnemu prostrediu. Ak parameter vynecháte --environment , pripojíte sa k predvolenému prostrediu, ale po pridaní --environment parametra sa môžete pripojiť k inmu. Ako hodnotu môžete použiť ID prostredia, URL adresu, jedinečný názov alebo čiastočný názov.

• V prostrediach, v ktorých nemáte možnosť používať interaktívne prostredie, pridaním parametra --deviceCode zaistíte, že sa stále môžete pripojiť. V priestoroch --deviceCode kódu služby GitHub sa napríklad pri spustení pac auth createparametra automaticky pridá .

Príklad

Na pripojenie k prostrediu HR-Dev môžete použiť nasledujúci príklad:

pac auth create --environment "HR-Dev"

Prepnutie na iný profil overovania

Ak máte viacero profilov overovania, môžete jednoducho prepnúť pomocou pac auth list príkazov a pac auth select .

Príkaz pac auth list obsahuje zoznam všetkých profilov overenia v počítači. Príkaz pac auth select vyberie iný príkaz.

pac auth list Príklad

Ak chcete zobraziť zoznam všetkých overovacích profilov, použite nasledujúci príklad:

pac auth list

Spustením pac auth list príkazu sa vrátia všetky profily overenia:

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

Vyberte iný profil overenia pomocou hodnoty indexu.

pac auth select --index 2

Príkazy

Príkaz	Description
pac auth clear	Vymažte všetky profily overovania uložené v tomto počítači
pac auth create	Vytvorenie a uloženie overovacích profilov v tomto počítači
pac auth delete	Odstránenie konkrétneho profilu overovania
pac auth list	Zobrazenie zoznamu overovacích profilov uložených v tomto počítači
pac auth name	Názov alebo premenovanie existujúceho profilu overovania
pac auth select	Vyberte, ktorý profil overenia by mal byť aktívny
pac auth update	Aktualizácia názvu alebo cieľového prostredia existujúceho profilu overovania
pac auth who	Zobrazenie informácií o aktuálne vybratom profile overenia

pac auth clear

Vymažte všetky profily overovania uložené v tomto počítači

pac auth create

Vytvorenie a uloženie overovacích profilov v tomto počítači

Príklady

Nasledujúce príklady zobrazujú použitie pac auth create príkazu.

• Základné vytvorenie
• Vytvorenie prostredia
• Pomenované vytvorenie
• Pomenované vytvoriť pomocou objektu služby
• Identita Azure

Základné vytvorenie

V tomto príklade sa zobrazí výzva na zadanie prihlasovacích údajov a pripojenie k nájomníkovi, ku ktorému poverenia patria.

pac auth create

Poznámka

Pri spustení nástroja Power Platform CLI v priestoroch codespace sa pri tejto operácii spustí prihlásenie kódu zariadenia.

Vytvorenie prostredia

V tomto príklade sa zobrazí výzva na zadanie poverení a pripojenie k prostrediu Power Platformy so zadaným ID prostredia.

pac auth create --environment < Your environment ID >

Prepitné

Vyhľadanie ID prostredia: Otvorte Centrum spravovania Power Platformy a vyberte prostredie , ku ktorému sa chcete pripojiť. V časti Podrobnosti vyhľadajte ID prostredia.

Pomenované vytvorenie

V tomto príklade sa overí váš nájomník a primenú sa v ňom názov MyOrg.

pac auth create --name MyOrg

Pomenované vytvoriť pomocou objektu služby

V tomto príklade sa vykoná overenie pomocou nájomníka, pomenuje MyOrg-SPN ho a použije na to objekt služby. Nezabudnite pridať objekt služby do svojho prostredia.

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

Identita Azure

Pri spúšťaní v prostredí, ktoré podporuje identitu Azure (napríklad Azure Cloud Shell, Azure VM so spravovanou identitou alebo Visual Studio Code s rozšírením konta Azure), môžete použiť --managedIdentity príznak na overenie pomocou identity Azure. PAC CLI používa predvolené prihlasovacie údaje azure , čo je opinionated, vopred nakonfigurovaný reťazec prihlasovacích údajov.

Predvolené prihlasovacie údaje služby Azure sú navrhnuté tak, aby podporovali mnoho prostredí spolu s najbežnejšími postupmi overovania a vývojárskymi nástrojmi. Správanie môžete prispôsobiť nastavením premenných prostredia, ako je popísané v dokumentácii k predvoleným prihlasovacím údajom Azure. Ak chcete napríklad overiť pomocou používateľom priradenej spravovanej identity, nastavte AZURE_CLIENT_ID premennú prostredia na ID klienta spravovanej identity priradenej používateľom. Ďalšie podrobnosti nájdete v téme Nastavenie premenných prostredia aplikácie.

Voliteľné parametre pre auth create

--applicationId -id

Voliteľné: ID aplikácie, pomocou ktoré sa má overiť.

--azureDevOpsFederated -adof

(Ukážka) Použite Azure DevOps Federation for Service Principal Auth; vyžaduje argumenty --tenant a --applicationId

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--certificateDiskPath -cdp

Voliteľné: Cesta k disku s certifikátom na overenie pomocou

--certificatePassword -cp

Voliteľné: Heslo certifikátu na overenie pomocou

--clientSecret -cs

Voliteľné: Tajný kľúč klienta na overenie pomocou

--cloud -ci

Voliteľné: Cloudová inštancia na overenie pomocou

Použite jednu z týchto hodnôt:

• Public
• UsGov
• UsGovHigh
• UsGovDod
• China

--deviceCode -dc

Interaktívne prihlásenie môžete použiť pomocou toku kódu zariadenia Microsoft Entra ID.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--environment -env

Predvolené prostredie (ID, URL adresa, jedinečný názov alebo čiastočný názov).

--githubFederated -ghf

(Ukážka) Používanie GitHub Federation for Service Principal Auth; vyžaduje argumenty --tenant a --applicationId

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--managedIdentity -mi

Použite predvolenú identitu Azure.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--name -n

Názov, ktorý chcete dať tomuto profilu overenia (maximálne 30 znakov).

Poznámka: Dĺžka názvu by mala byť v rozsahu od 1 do 30

--password -p

Voliteľné: Heslo na overenie pomocou

--tenant -t

ID nájomníka, ak sa používa ID aplikácie/tajný kľúč klienta alebo ID aplikácie/certifikát klienta.

--url -u

Zastarané: Namiesto toho použite funkciu --environment .

--username -un

Voliteľné: Meno používateľa, ktoré sa má overiť. zobrazí sa dialógové okno Microsoft Entra ID, ak nie je zadané.

Poznámky

V prípade parametra cloud hodnoty, ktoré sa majú použiť priraďujú k týmto iným bežným akronymom alebo názvom:

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

Problémy s overovaním pomocou WSL2

Pri používaní subsystému Windows pre Linux verzie 2 (WSL2) sa môžu vyskytovať problémy s overovaním, napríklad Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools ak v prostredí WSL2 nie je nastavený predvolený prehliadač.

Ak chcete tento problém obísť, môžete použiť overenie kódu zariadenia pridaním príznaku --deviceCode do auth create príkazu: pac auth create --environment {env-id} --deviceCode. Na dokončenie procesu overovania je potrebné zadať kód v prehliadači mimo WSL2.

pac auth delete

Odstránenie konkrétneho profilu overovania

Príklad

pac auth delete --index 2

Voliteľné parametre pre auth delete

--index -i

Index profilu, ktorý sa má odstrániť

Poznámka: Hodnota musí byť celé číslo s minimálnou hodnotou 1.

--name -n

Názov profilu, ktorý má byť aktívny

Poznámka: Dĺžka názvu by mala byť v rozsahu od 1 do 30

pac auth list

Zobrazenie zoznamu overovacích profilov uložených v tomto počítači

pac auth name

Názov alebo premenovanie existujúceho profilu overovania

Príklad

Nasledujúci príklad ukazuje, ako premenovať overový profil. V tomto prípade bude profil s indexom 1 premenovaný na Contoso Dev.

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

Povinné parametre pre auth name

--index -i

Index profilu, ktorý sa má pomenovať alebo premenovať

Poznámka: Hodnota musí byť celé číslo s minimálnou hodnotou 1.

--name -n

Názov, ktorý chcete dať tomuto profilu overenia (maximálne 30 znakov).

Poznámka: Dĺžka názvu by mala byť v rozsahu od 1 do 30

pac auth select

Vyberte, ktorý profil overenia by mal byť aktívny

Príklad

pac auth select --index 2

Voliteľné parametre pre auth select

--index -i

Index profilu, ktorý má byť aktívny.

Poznámka: Hodnota musí byť celé číslo s minimálnou hodnotou 1.

--name -n

Názov profilu, ktorý má byť aktívny

Poznámka: Dĺžka názvu by mala byť v rozsahu od 1 do 30

pac auth update

Aktualizácia názvu alebo cieľového prostredia existujúceho profilu overovania

Príklady

Nasledujúce príklady zobrazujú použitie pac auth update príkazu.

• Aktualizácia overeného profilu pomocou URL adresy prostredia
• Aktualizovať profil overenia pomocou ID prostredia

Aktualizácia overeného profilu pomocou URL adresy prostredia

Tento príklad znázorňuje, ako aktualizovať profil overenia indexom 1 názvom Contoso Dev a URL adresou https://contosodev.crm.dynamics.comprostredia .

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

Aktualizovať profil overenia pomocou ID prostredia

Tento príklad znázorňuje, ako aktualizovať overový profil indexom 1 pomocou ID 00000000-0000-0000-0000-000000000000prostredia .

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

Povinné parametre pre auth update

--index -i

Index profilu, ktorý sa má pomenovať alebo premenovať

Poznámka: Hodnota musí byť celé číslo s minimálnou hodnotou 1.

Voliteľné parametre pre auth update

--environment -env

Predvolené prostredie (ID, URL adresa, jedinečný názov alebo čiastočný názov).

--name -n

Názov, ktorý chcete dať tomuto profilu overenia (maximálne 30 znakov).

pac auth who

Zobrazenie informácií o aktuálne vybratom profile overenia

Pozrite si tiež

Microsoft Power Platform CLI Command Groups
Prehľad rozhrania Microsoft Power Platform CLI