Bagikan melalui

pac auth

Mengelola cara Anda mengautentikasi ke berbagai layanan

Menyambungkan ke penyewa Anda

pac auth create Gunakan perintah untuk menyambungkan ke penyewa Anda. Menjalankan pac auth create membuat profil autentikasi di komputer Anda. Anda dapat memiliki beberapa profil autentikasi yang tersedia. Memiliki beberapa profil autentikasi menarik saat Anda bekerja dengan beberapa penyewa. Misalnya, ketika perusahaan Anda menggunakan beberapa penyewa (untuk pengembangan, produksi, dan pengujian) atau ketika Anda adalah konsultan yang bekerja untuk beberapa pelanggan.

Perintah pac auth create memiliki beberapa parameter yang bermanfaat:

  • Parameter memungkinkan --environment Anda untuk secara otomatis terhubung ke lingkungan yang tepat. Jika Anda menghilangkan --environment parameter, Anda tersambung ke lingkungan default, tetapi dengan --environment parameter yang ditambahkan ke parameter tersebut, Anda dapat terhubung ke yang berbeda. Anda dapat menggunakan ID lingkungan, url, nama unik, atau nama parsial sebagai nilai.

  • Di lingkungan di mana Anda tidak memiliki kemampuan untuk menggunakan pengalaman interaktif, menambahkan --deviceCode parameter memastikan Anda masih dapat terhubung. Misalnya, di GitHub Codespaces, --deviceCode parameter secara otomatis ditambahkan saat Anda menjalankan pac auth create.

Example

Untuk menyambungkan ke HR-Dev lingkungan, Anda dapat menggunakan contoh berikut:

pac auth create --environment "HR-Dev"

Beralih ke profil autentikasi lain

Saat Anda memiliki beberapa profil autentikasi, Anda dapat dengan mudah beralih menggunakan pac auth list perintah dan pac auth select .

Perintah mencantumkan pac auth list semua profil autentikasi di komputer Anda. Perintah pac auth select memilih perintah yang berbeda.

pac auth list Contoh

Untuk mencantumkan semua profil autentikasi, gunakan contoh berikut:

pac auth list

pac auth list Menjalankan perintah mengembalikan semua profil autentikasi:

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 autentikasi yang berbeda menggunakan nilai indeks.

pac auth select --index 2

Commands

Command Description
pac auth clear Bersihkan semua profil autentikasi yang tersimpan di komputer ini
pac auth create Buat dan simpan profil autentikasi pada komputer ini
pac auth delete Menghapus profil autentikasi tertentu
pac auth list Mencantumkan profil autentikasi yang disimpan di komputer ini
pac auth name Nama atau ganti nama profil autentikasi yang sudah ada
pac auth select Pilih profil autentikasi mana yang harus aktif
pac auth update Memperbarui nama atau lingkungan target profil autentikasi yang ada
pac auth who Tampilkan informasi tentang profil autentikasi yang saat ini dipilih

pac auth clear

Bersihkan semua profil autentikasi yang tersimpan di komputer ini

pac auth create

Buat dan simpan profil autentikasi pada komputer ini

Examples

Contoh berikut menunjukkan penggunaan pac auth create perintah.

Buat Dasar

Contoh ini meminta kredensial dan menyambungkan ke penyewa tempat kredensial berada.

pac auth create

Nota

Saat menjalankan CLI Power Platform di Codespace, operasi ini memicu login kode perangkat.

Buat Lingkungan

Contoh ini meminta kredensial dan menyambungkan ke lingkungan Power Platform dengan ID lingkungan yang Anda tentukan.

pac auth create --environment < Your environment ID >

Petunjuk / Saran

Untuk menemukan ID lingkungan: Buka pusat admin Power Platform dan pilih Lingkungan yang ingin Anda sambungkan. Di bagian Detail , cari ID Lingkungan

Buat Bernama

Contoh ini mengautentikasi dengan penyewa Anda dan memberinya nama MyOrg.

pac auth create --name MyOrg

Bernama Buat dengan Perwakilan Layanan

Contoh ini mengautentikasi dengan penyewa Anda, memberinya nama MyOrg-SPN dan menggunakan perwakilan layanan untuk melakukannya. Jangan lupa untuk menambahkan perwakilan layanan ke lingkungan Anda.

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

Identitas Azure

Saat berjalan di lingkungan yang mendukung Azure Identity (seperti Azure Cloud Shell, Azure VM dengan Identitas Terkelola, atau Visual Studio Code dengan ekstensi Akun Azure), Anda dapat menggunakan --managedIdentity bendera untuk mengautentikasi menggunakan Azure Identity. PAC CLI menggunakan Kredensial Azure Default yang merupakan rantai kredensial yang telah dikonfigurasi sebelumnya.

Azure Credential default dirancang untuk mendukung banyak lingkungan, bersama dengan alur autentikasi dan alat pengembang yang paling umum. Anda dapat menyesuaikan perilaku dengan mengatur variabel lingkungan seperti yang dijelaskan dalam dokumentasi Kredensial Azure Default. Misalnya, untuk mengautentikasi menggunakan identitas terkelola yang ditetapkan pengguna, atur AZURE_CLIENT_ID variabel lingkungan ke ID klien identitas terkelola yang ditetapkan pengguna. Lihat detail selengkapnya di Mengatur variabel lingkungan aplikasi.

Parameter Opsional untuk auth create

--applicationId -id

Opsional: ID aplikasi untuk diautentikasi.

--azureDevOpsFederated -adof

(Pratinjau) Gunakan Federasi Azure DevOps untuk Autentikasi Perwakilan Layanan; memerlukan argumen --tenant dan --applicationId

Parameter ini tidak memerlukan nilai. Ini saklar.

--certificateDiskPath -cdp

Opsional: Jalur disk sertifikat untuk diautentikasi dengan

--certificatePassword -cp

Opsional: Kata sandi sertifikat untuk diautentikasi dengan

--clientSecret -cs

Opsional: Rahasia klien untuk diautentikasi dengan

--cloud -ci

Opsional: Instans cloud untuk diautentikasi dengan

Gunakan salah satu nilai ini:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Gunakan alur Kode Perangkat ID Microsoft Entra untuk masuk interaktif.

Parameter ini tidak memerlukan nilai. Ini saklar.

--environment -env

Lingkungan default (ID, url, nama unik, atau nama parsial).

--githubFederated -ghf

(Pratinjau) Gunakan Federasi GitHub untuk Autentikasi Perwakilan Layanan; memerlukan argumen --tenant dan --applicationId

Parameter ini tidak memerlukan nilai. Ini saklar.

--managedIdentity -mi

Gunakan identitas Azure default.

Parameter ini tidak memerlukan nilai. Ini saklar.

--name -n

Nama yang ingin Anda berikan ke profil autentikasi ini (maksimum 30 karakter).

Catatan: Panjang nama harus antara 1 dan 30

--password -p

Opsional: Kata sandi untuk diautentikasi dengan

--tenant -t

ID Penyewa jika menggunakan ID aplikasi/rahasia klien atau ID aplikasi/sertifikat klien.

--url -u

Tidak digunakan lagi: Gunakan --environment sebagai gantinya.

--username -un

Opsional: Nama pengguna untuk diautentikasi dengan; memperlihatkan dialog ID Microsoft Entra jika tidak ditentukan.

Komentar

cloud Untuk parameter , nilai yang akan digunakan untuk menggunakan peta ke akronim atau nama umum lainnya ini:

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

Masalah Autentikasi WSL2

Saat menggunakan Subsistem Windows untuk Linux versi 2 (WSL2), Anda mungkin memiliki masalah autentikasi seperti Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools ketika tidak ada browser default yang diatur di lingkungan WSL2 Anda.

Untuk mengatasi masalah ini, Anda dapat menggunakan autentikasi kode perangkat dengan menambahkan --deviceCode bendera ke perintah Anda auth create : pac auth create --environment {env-id} --deviceCode. Anda harus memasukkan kode di browser di luar WSL2 untuk menyelesaikan proses autentikasi.

pac auth delete

Menghapus profil autentikasi tertentu

Example

pac auth delete --index 2

Parameter Opsional untuk auth delete

--index -i

Indeks profil yang akan dihapus

Catatan: Nilai harus berupa bilangan bulat dengan nilai minimum 1.

--name -n

Nama profil yang akan aktif

Catatan: Panjang nama harus antara 1 dan 30

pac auth list

Mencantumkan profil autentikasi yang disimpan di komputer ini

pac auth name

Nama atau ganti nama profil autentikasi yang sudah ada

Example

Contoh berikut menunjukkan cara mengganti nama profil autentikasi. Dalam hal ini, profil dengan indeks 1 akan diganti namanya menjadi 'Contoso Dev'.

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

Parameter yang Diperlukan untuk auth name

--index -i

Indeks profil yang akan diberi nama/diganti namanya

Catatan: Nilai harus berupa bilangan bulat dengan nilai minimum 1.

--name -n

Nama yang ingin Anda berikan ke profil autentikasi ini (maksimum 30 karakter).

Catatan: Panjang nama harus antara 1 dan 30

pac auth select

Pilih profil autentikasi mana yang harus aktif

Example

pac auth select --index 2

Parameter Opsional untuk auth select

--index -i

Indeks profil yang akan aktif.

Catatan: Nilai harus berupa bilangan bulat dengan nilai minimum 1.

--name -n

Nama profil yang akan aktif

Catatan: Panjang nama harus antara 1 dan 30

pac auth update

Memperbarui nama atau lingkungan target profil autentikasi yang ada

Examples

Contoh berikut menunjukkan penggunaan pac auth update perintah.

Memperbarui profil autentikasi dengan URL lingkungan

Contoh ini menunjukkan cara memperbarui profil autentikasi dengan indeks 1 dengan nama Contoso Dev dan URL https://contosodev.crm.dynamics.comlingkungan .

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

Memperbarui profil autentikasi dengan ID lingkungan

Contoh ini menunjukkan cara memperbarui profil autentikasi dengan indeks 1 dengan ID 00000000-0000-0000-0000-000000000000lingkungan .

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

Parameter yang Diperlukan untuk auth update

--index -i

Indeks profil yang akan diberi nama/diganti namanya

Catatan: Nilai harus berupa bilangan bulat dengan nilai minimum 1.

Parameter Opsional untuk auth update

--environment -env

Lingkungan default (ID, url, nama unik, atau nama parsial).

--name -n

Nama yang ingin Anda berikan ke profil autentikasi ini (maksimum 30 karakter).

pac auth who

Tampilkan informasi tentang profil autentikasi yang saat ini dipilih

Lihat juga

Grup Perintah CLI Microsoft Power Platform
Gambaran umum CLI Microsoft Power Platform

  • Last updated on