Kongsi melalui

pac auth

Urus cara anda mengesahkan kepada pelbagai perkhidmatan

Berhubung dengan penyewa anda

Gunakan arahanpac auth create untuk menyambung ke penyewa anda. Berjalan pac auth create mencipta profil pengesahan pada mesin anda. Anda boleh mempunyai berbilang profil pengesahan yang tersedia. Mempunyai berbilang profil pengesahan adalah menarik apabila anda bekerja dengan berbilang penyewa. Sebagai contoh, apabila syarikat anda menggunakan berbilang penyewa (untuk pembangunan, pengeluaran dan ujian) atau apabila anda seorang perunding yang bekerja untuk berbilang pelanggan.

Perintah ini pac auth create mempunyai beberapa parameter berguna:

  • Parameter ini --environment membolehkan anda menyambung secara automatik ke persekitaran yang betul. Jika anda meninggalkan --environment parameter, anda disambungkan ke persekitaran lalai, tetapi dengan --environment parameter ditambah padanya, anda boleh menyambung ke persekitaran lain. Anda boleh menggunakan ID persekitaran, url, nama unik atau nama separa sebagai nilai.

  • Dalam persekitaran yang anda tidak mempunyai keupayaan untuk menggunakan pengalaman interaktif, menambah --deviceCode parameter memastikan anda masih boleh menyambung. Sebagai contoh, dalam GitHub Codespaces, parameter secara --deviceCode automatik ditambah apabila anda menjalankan pac auth create.

Contoh

Untuk menyambung ke persekitaran HR-Dev , anda boleh menggunakan contoh berikut:

pac auth create --environment "HR-Dev"

Tukar kepada profil pengesahan lain

Apabila anda mempunyai berbilang profil pengesahan, anda boleh bertukar dengan mudah menggunakan pac auth list arahan dan.pac auth select

Perintah menyenaraikan pac auth list semua profil pengesahan pada mesin anda. Perintah memilih pac auth select arahan yang berbeza.

pac auth list Sebagai contoh

Untuk menyenaraikan semua profil pengesahan, gunakan contoh berikut:

pac auth list

Menjalankan arahan pac auth list mengembalikan semua profil pengesahan:

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

Pilih profil pengesahan yang berbeza menggunakan nilai indeks.

pac auth select --index 2

Perintah

Perintah Description
pac auth clear Kosongkan semua profil pengesahan yang disimpan pada komputer ini
pac auth create Cipta dan simpan profil pengesahan pada komputer ini
pac auth delete Padamkan profil pengesahan tertentu
pac auth list Senaraikan profil pengesahan yang disimpan pada komputer ini
pac auth name Namakan atau namakan semula profil pengesahan sedia ada
pac auth select Pilih profil pengesahan yang harus aktif
pac auth update Kemas kini nama atau persekitaran sasaran profil pengesahan sedia ada
pac auth who Paparkan maklumat tentang profil pengesahan yang dipilih pada masa ini

pac auth clear

Kosongkan semua profil pengesahan yang disimpan pada komputer ini

pac auth create

Cipta dan simpan profil pengesahan pada komputer ini

Contoh

Contoh berikut menunjukkan penggunaan pac auth create arahan.

Cipta Asas

Contoh ini menggesa anda untuk mendapatkan kelayakan dan menyambung kepada penyewa yang dimiliki oleh kelayakan.

pac auth create

Nota

Apabila menjalankan Power Platform CLI dalam Codespaces, operasi ini mencetuskan log masuk kod peranti.

Persekitaran Mencipta

Contoh ini menggesa anda untuk kelayakan dan menyambung ke persekitaran Power Platform dengan ID persekitaran yang anda tentukan.

pac auth create --environment < Your environment ID >

Tip

Untuk mencari ID persekitaran: Buka pusat pentadbiran Power Platform dan pilih Persekitaran yang anda mahu sambungkan. Dalam bahagian Butiran , cari ID Persekitaran

Bernama Cipta

Contoh ini mengesahkan dengan penyewa anda dan memberikannya nama MyOrg.

pac auth create --name MyOrg

Dinamakan Cipta dengan Prinsipal Perkhidmatan

Contoh ini mengesahkan dengan penyewa anda, memberikannya nama MyOrg-SPN dan menggunakan prinsipal perkhidmatan untuk berbuat demikian. Jangan lupa untuk menambahkan prinsipal perkhidmatan ke persekitaran anda.

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

Azure Identity

Apabila berjalan dalam persekitaran yang menyokong Azure Identity (seperti Azure Cloud Shell, Azure VM dengan Identiti Terurus atau Kod Visual Studio dengan sambungan Akaun Azure), anda boleh menggunakan --managedIdentity bendera untuk mengesahkan menggunakan Azure Identity. PAC CLI menggunakan Kelayakan Azure Lalai yang merupakan rantaian kelayakan yang diprakonfigurasikan dan berpendirian.

Kelayakan Azure lalai direka bentuk untuk menyokong banyak persekitaran, bersama-sama dengan aliran pengesahan dan alatan pembangun yang paling biasa. Anda boleh menyesuaikan tingkah laku dengan mengesetkan pembolehubah persekitaran seperti yang diterangkan dalam dokumentasi Kelayakan Azure Lalai. Contohnya, untuk mengesahkan menggunakan identiti terurus yang diperuntukkan pengguna, setkan AZURE_CLIENT_ID pembolehubah persekitaran kepada ID klien identiti terurus yang diperuntukkan pengguna. Lihat butiran lanjut dalam Tetapkan pembolehubah persekitaran aplikasi.

Parameter Pilihan untuk auth create

--applicationId -id

Pilihan: ID aplikasi untuk disahkan.

--azureDevOpsFederated -adof

(Pratonton) Gunakan Persekutuan Azure DevOps untuk pengesahan Prinsipal Perkhidmatan; memerlukan hujah --tenant dan --applicationId

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--certificateDiskPath -cdp

Pilihan: Laluan cakera sijil untuk disahkan

--certificatePassword -cp

Pilihan: Kata laluan sijil untuk disahkan

--clientSecret -cs

Pilihan: Rahsia klien untuk disahkan

--cloud -ci

Pilihan: Tika awan untuk disahkan

Gunakan salah satu daripada nilai ini:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Gunakan aliran Kod Peranti Microsoft Entra ID untuk daftar masuk interaktif.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--environment -env

Persekitaran lalai (ID, url, nama unik atau nama separa).

--githubFederated -ghf

(Pratonton) Gunakan Persekutuan GitHub untuk pengesahan Prinsipal Perkhidmatan; memerlukan hujah --tenant dan --applicationId

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--managedIdentity -mi

Gunakan identiti Azure lalai.

Parameter ini tidak memerlukan nilai. Ia adalah suis.

--name -n

Nama yang anda mahu berikan kepada profil pengesahan ini (maksimum 30 aksara).

Nota: Panjang nama hendaklah antara 1 dan 30

--password -p

Pilihan: Kata laluan untuk disahkan

--tenant -t

ID penyewa jika menggunakan ID aplikasi/rahsia pelanggan atau ID aplikasi/sijil pelanggan.

--url -u

Ditamatkan: Gunakan --environment sebaliknya.

--username -un

Pilihan: Nama pengguna untuk disahkan; menunjukkan dialog Microsoft Entra ID jika tidak ditentukan.

Ucapan

Untuk cloud parameter, nilai untuk digunakan memetakan kepada akronim atau nama biasa yang lain ini:

  • GCC = UsGov
  • GCC Tinggi = UsGovHigh
  • DoD = UsGovDod

Isu Pengesahan WSL2

Apabila menggunakan Subsistem Windows untuk Linux versi 2 (WSL2), anda mungkin mempunyai isu pengesahan seperti Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools apabila tiada penyemak imbas lalai ditetapkan dalam persekitaran WSL2 anda.

Untuk mengatasi isu ini, anda boleh menggunakan pengesahan kod peranti dengan menambahkan --deviceCode bendera pada arahan anda auth create : pac auth create --environment {env-id} --deviceCode. Anda perlu memasukkan kod dalam penyemak imbas di luar WSL2 untuk melengkapkan proses pengesahan.

pac auth delete

Padamkan profil pengesahan tertentu

Contoh

pac auth delete --index 2

Parameter Pilihan untuk auth delete

--index -i

Indeks profil yang akan dipadamkan

Nota: Nilai mestilah integer dengan nilai minimum 1.

--name -n

Nama profil yang akan aktif

Nota: Panjang nama hendaklah antara 1 dan 30

pac auth list

Senaraikan profil pengesahan yang disimpan pada komputer ini

pac auth name

Namakan atau namakan semula profil pengesahan sedia ada

Contoh

Contoh berikut menunjukkan cara menamakan semula profil pengesahan. Dalam kes ini, profil dengan indeks 1 akan dinamakan semula kepada 'Contoso Dev'.

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

Parameter yang diperlukan untuk auth name

--index -i

Indeks profil yang akan dinamakan/dinamakan semula

Nota: Nilai mestilah integer dengan nilai minimum 1.

--name -n

Nama yang anda mahu berikan kepada profil pengesahan ini (maksimum 30 aksara).

Nota: Panjang nama hendaklah antara 1 dan 30

pac auth select

Pilih profil pengesahan yang harus aktif

Contoh

pac auth select --index 2

Parameter Pilihan untuk auth select

--index -i

Indeks profil untuk aktif.

Nota: Nilai mestilah integer dengan nilai minimum 1.

--name -n

Nama profil yang akan aktif

Nota: Panjang nama hendaklah antara 1 dan 30

pac auth update

Kemas kini nama atau persekitaran sasaran profil pengesahan sedia ada

Contoh

Contoh berikut menunjukkan penggunaan pac auth update arahan.

Kemas kini profil pengesahan dengan URL persekitaran

Contoh ini menunjukkan cara mengemas kini profil pengesahan dengan indeks 1 dengan nama Contoso Dev dan URL https://contosodev.crm.dynamics.compersekitaran .

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

Kemas kini profil pengesahan dengan ID persekitaran

Contoh ini menunjukkan cara mengemas kini profil pengesahan dengan indeks 1 dengan ID 00000000-0000-0000-0000-000000000000persekitaran .

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

Parameter yang diperlukan untuk auth update

--index -i

Indeks profil yang akan dinamakan/dinamakan semula

Nota: Nilai mestilah integer dengan nilai minimum 1.

Parameter Pilihan untuk auth update

--environment -env

Persekitaran lalai (ID, url, nama unik atau nama separa).

--name -n

Nama yang anda mahu berikan kepada profil pengesahan ini (maksimum 30 aksara).

pac auth who

Paparkan maklumat tentang profil pengesahan yang dipilih pada masa ini

Lihat juga

Kumpulan Perintah CLI Microsoft Power Platform
Gambaran keseluruhan CLI Microsoft Power Platform

  • Last updated on