pac auth

Quản lý cách bạn xác thực với các dịch vụ khác nhau

Kết nối với đối tượng thuê của bạn

Sử dụng lệnh pac auth create để kết nối với đối tượng thuê của bạn. Việc chạy pac auth create sẽ tạo ra một cấu hình xác thực trên máy tính của bạn. Bạn có thể có nhiều hồ sơ xác thực sẵn dùng. Việc có nhiều hồ sơ xác thực rất thú vị khi bạn làm việc với nhiều đối tượng thuê. Ví dụ: khi công ty của bạn sử dụng nhiều đối tượng thuê (để phát triển, sản xuất và thử nghiệm) hoặc khi bạn là nhà tư vấn làm việc cho nhiều khách hàng.

Lệnh pac auth create này có một vài tham số hữu ích:

• Tham --environment số cho phép bạn tự động kết nối với môi trường phù hợp. Nếu bạn bỏ qua tham --environment số, bạn được kết nối với môi trường mặc định, --environment nhưng với tham số được thêm vào tham số, bạn có thể kết nối với một tham số khác. Bạn có thể sử dụng ID môi trường, url, tên duy nhất hoặc một phần tên làm giá trị.

• Trong các môi trường mà bạn không có khả năng sử dụng trải nghiệm tương tác, --deviceCode việc thêm tham số sẽ đảm bảo rằng bạn vẫn có thể kết nối. Ví dụ: trong Không gian mã GitHub, tham số sẽ --deviceCode tự động được thêm vào khi bạn chạy pac auth create.

Ví dụ:

Để kết nối với môi HR-Dev trường, bạn có thể sử dụng ví dụ sau đây:

pac auth create --environment "HR-Dev"

Chuyển sang hồ sơ xác thực khác

Khi bạn có nhiều cấu hình xác thực, bạn có thể dễ dàng chuyển đổi bằng pac auth list cách sử pac auth select dụng các lệnh và.

Lệnh này pac auth list liệt kê tất cả các cấu hình xác thực trên máy tính của bạn. Lệnh pac auth select sẽ chọn một lệnh khác.

pac auth list Ví dụ

Để liệt kê tất cả các cấu hình xác thực, hãy sử dụng ví dụ sau:

pac auth list

Chạy lệnh trả pac auth list về tất cả các cấu hình xác thực:

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

Chọn cấu hình xác thực khác sử dụng giá trị chỉ mục.

pac auth select --index 2

Lệnh

Lệnh	Mô tả
pac auth clear	Xóa tất cả hồ sơ xác thực được lưu trữ trên máy tính này
pac auth create	Tạo và lưu trữ hồ sơ xác thực trên máy tính này
pac auth delete	Xóa cấu hình xác thực cụ thể
pac auth list	Liệt kê hồ sơ xác thực được lưu trữ trên máy tính này
pac auth name	Đặt tên hoặc đổi tên hồ sơ xác thực hiện có
pac auth select	Chọn cấu hình xác thực sẽ hiện hoạt
pac auth update	Cập nhật tên hoặc môi trường đích của hồ sơ xác thực hiện có
pac auth who	Hiển thị thông tin về hồ sơ xác thực hiện được chọn

pac auth clear

Xóa tất cả hồ sơ xác thực được lưu trữ trên máy tính này

pac auth create

Tạo và lưu trữ hồ sơ xác thực trên máy tính này

Ví dụ

Các ví dụ sau đây cho thấy cách sử dụng pac auth create lệnh.

• Tạo Cơ bản
• Tạo Môi trường
• Tạo có Tên
• Tạo có Tên với Tên Dịch vụ Chính
• Danh tính Azure

Tạo Cơ bản

Ví dụ này nhắc bạn nhập thông tin xác thực và kết nối với đối tượng thuê chứa thông tin xác thực.

pac auth create

Lưu ý

Khi chạy POWER Platform CLI trong Codespaces, thao tác này sẽ kích hoạt đăng nhập mã thiết bị.

Tạo Môi trường

Ví dụ này nhắc bạn nhập thông tin xác thực và kết nối với môi trường Power Platform với ID môi trường mà bạn chỉ định.

pac auth create --environment < Your environment ID >

Tiền bo

Để tìm ID môi trường: Mở Trung tâm quản trị Nền tảng Nguồn và chọn Môi trường bạn muốn kết nối. Trong phần Chi tiết , hãy tìm ID Môi trường

Tạo có Tên

Ví dụ này xác thực với đối tượng thuê của bạn và đặt tên cho đối tượng thuê MyOrg.

pac auth create --name MyOrg

Tạo có Tên với Tên Dịch vụ Chính

Ví dụ này xác thực với đối tượng thuê của bạn, đặt tên cho đối tượng thuê MyOrg-SPN và sử dụng tên dịch vụ chính để thực hiện việc này. Đừng quên thêm tên dịch vụ chính vào môi trường của bạn.

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

Danh tính Azure

Khi chạy trong một môi trường hỗ trợ Azure Identity (như Azure Cloud Shell, Máy ảo Azure có Nhận dạng được Quản lý hoặc Mã Visual Studio có phần mở rộng Tài khoản Azure), --managedIdentity bạn có thể sử dụng cờ để xác thực bằng cách sử dụng Danh tính Azure. PAC CLI sử dụng Thông tin xác thực Azure Mặc định là chuỗi thông tin xác thực được định cấu hình sẵn, có ý kiến.

Thông tin xác thực Azure mặc định được thiết kế để hỗ trợ nhiều môi trường, cùng với các dòng xác thực và công cụ dành cho nhà phát triển phổ biến nhất. Bạn có thể tùy chỉnh hành vi bằng cách đặt biến môi trường như được mô tả trong tài liệu Chứng danh Azure Mặc định. Ví dụ: để xác thực bằng danh tính được quản lý do người dùng gán, AZURE_CLIENT_ID hãy đặt biến môi trường thành ID máy khách của nhận dạng được quản lý do người dùng gán. Xem thêm chi tiết trong mục Đặt biến môi trường ứng dụng.

Tham số Tùy chọn cho auth create

--applicationId -id

Tùy chọn: ID ứng dụng để xác thực.

--azureDevOpsFederated -adof

(Xem trước) Sử dụng Liên kết Azure DevOps cho Xác thực Chính của Dịch vụ; yêu cầu đối số --tenant và --applicationId

Tham số này không yêu cầu giá trị. Đó là công tắc.

--certificateDiskPath -cdp

Tùy chọn: Đường dẫn đĩa chứng chỉ để xác thực bằng

--certificatePassword -cp

Tùy chọn: Mật khẩu chứng chỉ để xác thực bằng

--clientSecret -cs

Tùy chọn: Bí mật của máy khách để xác thực với

--cloud -ci

Tùy chọn: Phiên bản đám mây để xác thực với

Sử dụng một trong các giá trị sau:

• Public
• UsGov
• UsGovHigh
• UsGovDod
• China

--deviceCode -dc

Sử dụng dòng Mã Thiết bị Microsoft Entra ID để đăng nhập tương tác.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--environment -env

Môi trường mặc định (ID, url, tên duy nhất hoặc một phần tên).

--githubFederated -ghf

(Xem trước) Sử dụng Liên đoàn GitHub cho Xác thực Chính của Dịch vụ; yêu cầu đối số --tenant và --applicationId

Tham số này không yêu cầu giá trị. Đó là công tắc.

--managedIdentity -mi

Sử dụng danh tính Azure mặc định.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--name -n

Tên bạn muốn đặt cho hồ sơ xác thực này (tối đa 30 ký tự).

Lưu ý: Độ dài của tên phải nằm trong khoảng từ 1 đến 30

--password -p

Tùy chọn: Mật khẩu để xác thực bằng

--tenant -t

ID đối tượng thuê nếu sử dụng id ứng dụng/bí mật máy khách hoặc id ứng dụng/chứng chỉ máy khách.

--url -u

Phản đối: Sử dụng để thay --environment thế.

--username -un

Tùy chọn: Tên người dùng để xác thực với; hiển thị hộp thoại Microsoft Entra ID nếu không được chỉ định.

Ghi chú

Đối với tham cloud số, các giá trị sử dụng ánh xạ tới các từ viết tắt hoặc tên phổ biến khác này:

• GCC = UsGov
• GCC Cao = UsGovHigh
• DoD = UsGovDod

Sự cố Xác thực WSL2

Khi sử dụng Hệ thống con Windows cho Linux phiên bản 2 (WSL2), Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools bạn có thể gặp sự cố xác thực, chẳng hạn như khi không có trình duyệt mặc định được đặt trong môi trường WSL2 của bạn.

Để khắc phục sự cố này, bạn có thể sử dụng xác thực mã thiết bị bằng cách thêm cờ --deviceCode vào lệnh auth create của mình: pac auth create --environment {env-id} --deviceCode. Bạn sẽ cần nhập mã vào trình duyệt bên ngoài WSL2 để hoàn tất quy trình xác thực.

pac auth delete

Xóa cấu hình xác thực cụ thể

Ví dụ:

pac auth delete --index 2

Tham số Tùy chọn cho auth delete

--index -i

Chỉ mục của hồ sơ cần xóa

Lưu ý: Giá trị phải là số nguyên với giá trị tối thiểu là 1.

--name -n

Tên của hồ sơ sẽ hiện hoạt

Lưu ý: Độ dài của tên phải nằm trong khoảng từ 1 đến 30

pac auth list

Liệt kê hồ sơ xác thực được lưu trữ trên máy tính này

pac auth name

Đặt tên hoặc đổi tên hồ sơ xác thực hiện có

Ví dụ:

Ví dụ sau đây cho thấy cách đổi tên hồ sơ xác thực. Trong trường hợp này, cấu hình với chỉ mục 1 sẽ được đổi tên thành 'Contoso Dev'.

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

Tham số Bắt buộc cho auth name

--index -i

Chỉ mục của hồ sơ cần đặt tên/đổi tên

Lưu ý: Giá trị phải là số nguyên với giá trị tối thiểu là 1.

--name -n

Tên bạn muốn đặt cho hồ sơ xác thực này (tối đa 30 ký tự).

Lưu ý: Độ dài của tên phải nằm trong khoảng từ 1 đến 30

pac auth select

Chọn cấu hình xác thực sẽ hiện hoạt

Ví dụ:

pac auth select --index 2

Tham số Tùy chọn cho auth select

--index -i

Chỉ mục của hồ sơ sẽ hiện hoạt.

Lưu ý: Giá trị phải là số nguyên với giá trị tối thiểu là 1.

--name -n

Tên của hồ sơ sẽ hiện hoạt

Lưu ý: Độ dài của tên phải nằm trong khoảng từ 1 đến 30

pac auth update

Cập nhật tên hoặc môi trường đích của hồ sơ xác thực hiện có

Ví dụ

Các ví dụ sau đây cho thấy cách sử dụng pac auth update lệnh.

• Cập nhật hồ sơ xác thực với URL môi trường
• Cập nhật hồ sơ xác thực với ID môi trường

Cập nhật hồ sơ xác thực với URL môi trường

Ví dụ này cho thấy cách cập nhật hồ sơ xác thực với chỉ mục 1 với tên Contoso Dev và URL môi trường https://contosodev.crm.dynamics.com.

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

Cập nhật hồ sơ xác thực với ID môi trường

Ví dụ này cho thấy cách cập nhật hồ sơ xác thực với chỉ mục 1 với ID môi trường 00000000-0000-0000-0000-000000000000.

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

Tham số Bắt buộc cho auth update

--index -i

Chỉ mục của hồ sơ cần đặt tên/đổi tên

Lưu ý: Giá trị phải là số nguyên với giá trị tối thiểu là 1.

Tham số Tùy chọn cho auth update

--environment -env

Môi trường mặc định (ID, url, tên duy nhất hoặc một phần tên).

--name -n

Tên bạn muốn đặt cho hồ sơ xác thực này (tối đa 30 ký tự).

pac auth who

Hiển thị thông tin về hồ sơ xác thực hiện được chọn

Xem thêm

Microsoft Power Platform CLI Command Groups
Tổng quan về MICROSOFT Power Platform CLI