Споделяне чрез

pac auth

Управление на начина, по който удостоверявате за различни услуги

Свързване с вашия клиент

Използвайте командата,pac auth create за да се свържете с вашия клиент. Изпълняването pac auth create създава профил за удостоверяване на вашия компютър. Можете да имате няколко налични профила за удостоверяване. Наличието на няколко профила за удостоверяване е интересно, когато работите с множество клиенти. Например когато фирмата ви използва няколко клиента (за разработване, производство и тестване) или когато сте консултант, който работи за множество клиенти.

Командата pac auth create има няколко полезни параметъра:

  • Параметърът --environment ви позволява да се свържете автоматично с правилната среда. Ако изпуснете параметъра --environment , сте свързани към средата по подразбиране, но с добавения --environment към него параметър можете да се свържете с друга. Можете да използвате като стойност ИД на средата, URL адрес, уникално име или частично име.

  • В среди, в които нямате възможност да използвате интерактивна среда за работа, добавянето на параметъра --deviceCode гарантира, че все още можете да се свържете. Например в GitHub Codespaces параметърът --deviceCode автоматично се добавя, когато стартирате pac auth create.

Пример

За да HR-Dev се свържете със средата, можете да използвате следния пример:

pac auth create --environment "HR-Dev"

Превключване към друг профил за удостоверяване

Когато имате няколко профила за удостоверяване, можете лесно да превключвате с помощта на командите pac auth list и pac auth select .

Командата pac auth list изброява всички профили за удостоверяване на вашия компютър. Командата pac auth select избира друга команда.

pac auth list Пример

За да изброите всички профили за удостоверяване, използвайте следния пример:

pac auth list

Изпълнението на командата pac auth list връща всички профили за удостоверяване:

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

Изберете друг профил за удостоверяване, като използвате стойността на индекса.

pac auth select --index 2

Команди

Command Описание
pac auth clear Изчистване на всички профили за удостоверяване, съхранени на този компютър
pac auth create Създаване и съхраняване на профили за удостоверяване на този компютър
pac auth delete Изтриване на определен профил за удостоверяване
pac auth list Списък на профилите за удостоверяване, съхранени на този компютър
pac auth name Именуване или преименуване на съществуващ профил за удостоверяване
pac auth select Изберете кой профил за удостоверяване трябва да бъде активен
pac auth update Актуализиране на име или целева среда на съществуващ профил за удостоверяване
pac auth who Показване на информация за текущо избрания профил за удостоверяване

pac auth clear

Изчистване на всички профили за удостоверяване, съхранени на този компютър

pac auth create

Създаване и съхраняване на профили за удостоверяване на този компютър

Примери

Следващите примери показват използването на командата pac auth create .

Основно създаване

Този пример ви подканва за идентификационни данни и се свързва с клиента, към който принадлежат идентификационните данни.

pac auth create

Бележка

Когато се изпълнява CLI на Power Platform в codespaces, тази операция активира влизане в кода на устройството.

Създаване на среда

Този пример ви подканва за идентификационни данни и се свързва към средата на Power Platform с ИД на средата, който зададете.

pac auth create --environment < Your environment ID >

Бакшиш

За да намерите ИД на среда: Отворете центъра за администриране на Платформата Power и изберете средата , към която искате да се свържете. В секцията По-подробно потърсете ИД на средата

Наименувано създаване

Този пример се удостоверява с вашия клиент и му дава името MyOrg.

pac auth create --name MyOrg

Наименувано създаване с главен субект на услуга

Този пример се удостоверява с вашия клиент, дава му името MyOrg-SPN и за целта използва главен субект на услуга. Не забравяйте да добавите главен субект на услуга към вашата среда.

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

Самоличност на Azure

Когато се изпълнява в среда, която поддържа самоличност на Azure (като например Azure Cloud Shell, Azure VM с управлявана самоличност или Visual Studio код с разширение на акаунт в Azure), можете да използвате флага --managedIdentity за удостоверяване чрез самоличността на Azure. PAC CLI използва идентификационните данни на Azure по подразбиране , които са предварително конфигурирана верига от идентификационни данни по подразбиране.

Идентификационните данни на Azure по подразбиране са предназначени да поддържат много среди, както и най-често срещаните потоци на удостоверяване и инструменти за разработчици. Можете да персонализирате поведението, като зададете променливи на средата, както е описано в документацията по подразбиране за идентификационни данни на Azure. Например за удостоверяване с помощта на присвоена от потребителя управлявана самоличност задайте променливата на AZURE_CLIENT_ID средата на клиентския ИД на присвоената от потребителя управлявана самоличност. Вижте повече подробности в Задаване на променливите на средата на приложението.

Незадължителни параметри за auth create

--applicationId -id

По желание: ИД на приложението, с което да се удостоверите.

--azureDevOpsFederated -adof

(Предварителен преглед) Използване на федериране на Azure DevOps за главен удостоверяване на услуга; изисква аргументи --клиент и --applicationId

Този параметър не изисква стойност. Това е превключвател.

--certificateDiskPath -cdp

По желание: Пътят на диска със сертификата за удостоверяване с

--certificatePassword -cp

По желание: Паролата за сертификат, с която да се удостоверите

--clientSecret -cs

По желание: Тайната на клиента за удостоверяване с

--cloud -ci

По желание: Екземплярът на облака, с който да се удостоверите

Използвайте една от следните стойности:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Използвайте потока с код на устройство microsoft Entra ID за интерактивно влизане.

Този параметър не изисква стойност. Това е превключвател.

--environment -env

Среда по подразбиране (ИД, URL адрес, уникално име или частично име).

--githubFederated -ghf

(Предварителен преглед) Използване на федериране в GitHub за главен удостоверяване на услуга; изисква аргументи --клиент и --applicationId

Този параметър не изисква стойност. Това е превключвател.

--managedIdentity -mi

Използване на самоличност по подразбиране за Azure.

Този параметър не изисква стойност. Това е превключвател.

--name -n

Името, което искате да дадете на този профил за удостоверяване (най-много 30 знака).

Забележка: Дължината на името трябва да е между 1 и 30

--password -p

По желание: Паролата за удостоверяване с

--tenant -t

ИД на клиент, ако се използва ИД на приложение/клиентски тайна или ИД на приложение/сертификат на клиент.

--url -u

Отхвърлен: Вместо това използвайте --environment .

--username -un

По желание: Потребителското име, с което да се удостоверите; показва диалогов прозорец microsoft Entra ID, ако не е зададен.

Забележки

За параметъра cloud стойностите за използване на съпоставяне с тези други често срещани съкращения или имена:

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

Проблеми с WSL2 удостоверяването

Когато използвате подсистемата на Windows за Linux версия 2 (WSL2), може да имате проблеми с удостоверяването, като Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools например когато няма зададен браузър по подразбиране във вашата WSL2 среда.

За да заобиколите този проблем, можете да използвате удостоверяване на код на устройство, като добавите флага --deviceCode към командата: auth createpac auth create --environment {env-id} --deviceCode. Ще трябва да въведете код в браузър извън WSL2, за да завършите процеса на удостоверяване.

pac auth delete

Изтриване на определен профил за удостоверяване

Пример

pac auth delete --index 2

Незадължителни параметри за auth delete

--index -i

Индексът на профила, който трябва да бъде изтрит

Забележка: Стойността трябва да бъде цяло число с минимална стойност 1.

--name -n

Името на профила, който трябва да бъде активен

Забележка: Дължината на името трябва да е между 1 и 30

pac auth list

Списък на профилите за удостоверяване, съхранени на този компютър

pac auth name

Именуване или преименуване на съществуващ профил за удостоверяване

Пример

Следващият пример показва как да преименувате профил за удостоверяване. В този случай профилът с индекс 1 ще бъде преименуван на "Contoso Dev".

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

Задължителни параметри за auth name

--index -i

Индексът на профила, който ще бъде наименуван/преименуван

Забележка: Стойността трябва да бъде цяло число с минимална стойност 1.

--name -n

Името, което искате да дадете на този профил за удостоверяване (най-много 30 знака).

Забележка: Дължината на името трябва да е между 1 и 30

pac auth select

Изберете кой профил за удостоверяване трябва да бъде активен

Пример

pac auth select --index 2

Незадължителни параметри за auth select

--index -i

Индексът на профила, който трябва да бъде активен.

Забележка: Стойността трябва да бъде цяло число с минимална стойност 1.

--name -n

Името на профила, който трябва да бъде активен

Забележка: Дължината на името трябва да е между 1 и 30

pac auth update

Актуализиране на име или целева среда на съществуващ профил за удостоверяване

Примери

Следващите примери показват използването на командата pac auth update .

Актуализиране на профил за удостоверяване с URL адрес на средата

Този пример показва как да актуализирате профила за удостоверяване с индекс 1 с името Contoso Dev и URL адреса https://contosodev.crm.dynamics.comна средата .

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

Актуализиране на профил за удостоверяване с ИД на средата

Този пример показва как да актуализирате профила за удостоверяване с индекс 1 с ИД 00000000-0000-0000-0000-000000000000на средата .

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

Задължителни параметри за auth update

--index -i

Индексът на профила, който ще бъде наименуван/преименуван

Забележка: Стойността трябва да бъде цяло число с минимална стойност 1.

Незадължителни параметри за auth update

--environment -env

Среда по подразбиране (ИД, URL адрес, уникално име или частично име).

--name -n

Името, което искате да дадете на този профил за удостоверяване (най-много 30 знака).

pac auth who

Показване на информация за текущо избрания профил за удостоверяване

Вижте също

CLI командни групи на Microsoft Power Platform
Общ преглед на CLI за Microsoft Power Platform

  • Last updated on