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 РаT�

Барлық аутентификация профильдерін тізімдеу үшін келесі мысалды пайдаланыңыз:

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

Раа

Пәрмен	Сипаттама
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 орындау тәртібін көрсетеді.

• Негізгі жасау
• Ортаны құру
• Атауы Құру
• Қызмет жетекшісімен құру атауы
• Azure Identity

Негізгі жасау

Бұл мысал сізге тіркеу деректерін сұрайды және тіркеу деректері тиесілі жалға алушыға қосылады.

pac auth create

Ескертпе

Power Platform CLI-ді Codespaces-та іске қосқанда, бұл операция құрылғы кодына кіруді іске қосады.

Ортаны құру

Бұл мысал сізден тірек деректерін сұрайды және сіз көрсеткен орта идентификаторымен Power Platform ортасына қосылады.

pac auth create --environment < Your environment ID >

Шайпұл

Орта идентификаторын табу үшін: Power Platform әкімшілік орталығын ашып, қосылғыңыз келетін ортаны таңдаңыз. Мәліметтер бөлімінде Қоршаған орта идентификаторын іздеңіз

Атауы Құру

Бұл мысал сіздің жалға алушыңызбен аутентификацияланады және оған есім 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 Identity

Azure Identity қолдайтын ортада (мысалы, Azure Cloud Shell, Azure VM with Managed Identity немесе Visual Studio Code with Azure Account кеңейтімімен) жұмыс істегенде, сіз флаг арқылы Azure Identity арқылы аутентификация жасай --managedIdentity аласыз. PAC CLI Default Azure Credential-ін қолданады, ол алдын ала анықталған, пікірленген тіркелгі тізбегі.

Әдепкі Azure Credential көптеген орталарды, сондай-ақ ең кең таралған аутентификация ағындары мен әзірлеуші құралдарын қолдауға арналған. Әдепкі Azure Credential құжаттамасында сипатталған орта айнымалыларын орнату арқылы мінез-құлқты баптауға болады. Мысалы, пайдаланушы тағайындаған басқарылатын идентификацияны пайдаланып аутентификация жасау үшін, орта айнымалыны AZURE_CLIENT_ID пайдаланушы тағайындаған басқарылатын идентификацияның клиент идентификаторына орнатыңыз. Толығырақ ақпаратты Set the app environment айнымалыларынан қараңыз.

Қосымша параметрлер auth create

--applicationId -id

Қосымша: Аутентификацияға арналған қолданба идентификаторы.

--azureDevOpsFederated -adof

(Алдын ала қарау) Azure DevOps Federation Service Principal Auth үшін пайдалану; --tenant және --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 Федерациясын қызмет көрсету принципінің аутентификациясы үшін пайдаланыңыз; --tenant және --applicationId аргументтерін талап етеді

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--managedIdentity -mi

Әдепкі Azure идентификаторын қолданыңыз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--name -n

Осы аутентификация профиліне бергіңіз келетін атау (ең көп дегенде 30 таңба).

Ескертпе: Зат есімнің ұзындығы 1-ден 30-ға дейін болуы керек

--password -p

Қосымша: Аутентификация үшін құпия сөз

--tenant -t

Бағдарлама идентификаторы/клиент құпиясы немесе бағдарлама идентификаторы/клиент куәлігі пайдаланылса, клиент идентификаторы.

--url -u

Ескерту: Орнына пайдаланыңыз --environment .

--username -un

Қосымша: Аутентификациялау үшін пайдаланушы аты; Көрсетілмесе, Microsoft Entra идентификаторы диалогтық терезесін көрсетеді.

Ескертулер

Параметр үшін cloud осы басқа жалпы аббревиатураларға немесе атауларға сәйкес келетін мәндер:

• GCC = UsGov
• GCC жоғары = UsGovHigh
• Қорғаныс министрлігі = UsGovDod

WSL2 аутентификациясының ақаулары

Linux 2 нұсқасына арналған Windows қосалқы жүйесін (WSL2) пайдаланған кезде, WSL2 ортасында әдепкі шолғыш орнатылмаған кезде Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools аутентификация мәселелері туындауы мүмкін.

Бұл мәселені шешу үшін құрылғы кодын аутентификациясын пәрменге --deviceCode жалаушаны auth create қосу арқылы пайдалануға болады: pac 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-ші бөлім "ҚазТрансОйл" АҚ-ның "ҚазТрансОйл" АҚ-ға қайта қосылады.

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 мекенжайымен жаңарту
• Орта идентификаторымен аутентификация профилін жаңарту

Аутентификация профилін ортаның URL мекенжайымен жаңарту

Бұл мысалда аутентификация профилін атауы Contoso Dev және ортаның URL https://contosodev.crm.dynamics.comмекенжайы бар индекс 1 арқылы қалай жаңартуға болатындығы көрсетілген.

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

Орта идентификаторымен аутентификация профилін жаңарту

Бұл мысалда орта идентификаторы 00000000-0000-0000-0000-000000000000бар индекс 1 бар аутентификация профилін қалай жаңартуға болатындығы көрсетілген.

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

Таңдалған аутентификация профилі туралы мәліметті көрсету

Сонымен қатар қараңыз

Microsoft Power Platform CLI пәрмен топтары
Microsoft Power Platform CLI шолуына шолу