Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
Spravujte spôsob 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
--environmentvá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í--environmentparametra 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
--deviceCodezaistíte, že sa stále môžete pripojiť. V priestoroch--deviceCodekó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 token | Zobrazenie prístupového tokenu rozhrania API platformy Power pre aktuálne vybratý profil overenia |
| 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
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:
PublicUsGovUsGovHighUsGovDodChina
--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
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 token
Zobrazenie prístupového tokenu rozhrania API platformy Power pre aktuálne vybratý profil overenia
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 tiež
príkazové skupiny rozhrania Microsoft Power Platform CLI
prehľad rozhrania Microsoft Power Platform CLI