แชร์ผ่าน


การรับรองความถูกต้อง pac

จัดการวิธีที่คุณรับรองความถูกต้องในบริการต่าง ๆ

เชื่อมต่อกับผู้เช่าของคุณ

ใช้ คําสั่งสร้างการรับรองความถูกต้อง pac เพื่อเชื่อมต่อกับผู้เช่าของคุณ การ 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 และคําสั่ง เลือกการรับรองความถูกต้อง pac ได้อย่างง่ายดาย

คําสั่ง 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

คำสั่ง

คำสั่ง คำอธิบาย
การรับรองความถูกต้อง pac ล้างโปรไฟล์การรับรองความถูกต้องทั้งหมดที่จัดเก็บบนคอมพิวเตอร์เครื่องนี้
สร้างการรับรองความถูกต้อง pac สร้างและจัดเก็บโปรไฟล์การรับรองความถูกต้องบนคอมพิวเตอร์เครื่องนี้
การลบการรับรองความถูกต้อง pac ลบโปรไฟล์การรับรองความถูกต้องเฉพาะ
รายการการรับรองความถูกต้อง pac แสดงรายการโปรไฟล์การรับรองความถูกต้องที่จัดเก็บบนคอมพิวเตอร์เครื่องนี้
ชื่อการรับรองความถูกต้อง pac ตั้งชื่อหรือเปลี่ยนชื่อโปรไฟล์การรับรองความถูกต้องที่มีอยู่
เลือกการรับรองความถูกต้อง pac เลือกโปรไฟล์การรับรองความถูกต้องที่ควรเปิดใช้งาน
ปรับปรุงการรับรองความถูกต้อง pac อัปเดตชื่อหรือสภาพแวดล้อมเป้าหมายของโปรไฟล์การรับรองความถูกต้องที่มีอยู่
การรับรองความถูกต้อง pac ใคร แสดงข้อมูลเกี่ยวกับโปรไฟล์การรับรองความถูกต้องที่เลือกในปัจจุบัน

การรับรองความถูกต้อง pac

ล้างโปรไฟล์การรับรองความถูกต้องทั้งหมดที่จัดเก็บบนคอมพิวเตอร์เครื่องนี้

สร้างการรับรองความถูกต้อง pac

สร้างและจัดเก็บโปรไฟล์การรับรองความถูกต้องบนคอมพิวเตอร์เครื่องนี้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงการใช้ pac auth create คําสั่ง

สร้างพื้นฐาน

ตัวอย่างนี้จะพร้อมท์คุณสําหรับข้อมูลประจําตัว และเชื่อมต่อกับผู้เช่าข้อมูลประจําตัว

pac auth create

Note

เมื่อเรียกใช้ Power Platform CLI ใน Codespace การดําเนินการนี้จะทริกเกอร์การเข้าสู่ระบบโค้ดอุปกรณ์

สร้างสภาพแวดล้อม

ตัวอย่างนี้จะพร้อมท์คุณสําหรับข้อมูลประจําตัวและเชื่อมต่อกับสภาพแวดล้อม Power Platform ด้วย ID สภาพแวดล้อมที่คุณระบุ

pac auth create --environment < Your environment ID >

เคล็ดลับ

หากต้องการค้นหารหัสสภาพแวดล้อม: เปิด ศูนย์การจัดการ Power Platform และเลือก สภาพแวดล้อม ที่คุณต้องการเชื่อมต่อ ในส่วน รายละเอียด ให้ค้นหา ID สภาพแวดล้อม

สร้างที่มีชื่อ

ตัวอย่างนี้จะรับรองความถูกต้องกับผู้เช่าของคุณ และตั้งชื่อ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 Identity (เช่น Azure Cloud Shell, Azure VM ด้วย Managed Identity หรือ Visual Studio Code กับส่วนขยายบัญชี Azure) คุณสามารถใช้ --managedIdentity ค่าสถานะเพื่อรับรองความถูกต้องโดยใช้ข้อมูลประจําตัวของ Azure ได้ PAC CLI ใช้ Default Azure Credential ซึ่งเป็นสายข้อมูลข้อมูลประจําตัวที่กําหนดค่าไว้ล่วงหน้าที่ได้แสดงไว้ล่วงหน้า

ค่าเริ่มต้น Azure Credential ถูกออกแบบมาเพื่อสนับสนุนหลายสภาพแวดล้อม พร้อมกับโฟลว์การรับรองความถูกต้องที่ใช้บ่อยที่สุดและเครื่องมือสําหรับนักพัฒนา คุณสามารถกําหนดลักษณะการทํางานโดยการตั้งค่าตัวแปรสภาพแวดล้อมตามที่อธิบายไว้ใน เอกสารประกอบข้อมูลประจําตัว Azure ค่าเริ่มต้น ตัวอย่างเช่น เมื่อต้องการรับรองความถูกต้องโดยใช้ข้อมูลประจําตัวที่จัดการโดยผู้ใช้ ให้ AZURE_CLIENT_ID ตั้งค่าตัวแปรสภาพแวดล้อมเป็น ID ไคลเอ็นต์ของข้อมูลประจําตัวที่จัดการโดยผู้ใช้ ดูรายละเอียดเพิ่มเติมใน ตั้งค่าตัวแปรสภาพแวดล้อมแอป

พารามิเตอร์ที่เลือกได้สําหรับการสร้างการรับรองความถูกต้อง

--applicationId -id

ตัวเลือก: ID แอปพลิเคชันเพื่อรับรองความถูกต้อง

--azureDevOpsFederated -adof

(ตัวอย่าง) ใช้ Azure DevOps Federation สําหรับการรับรองความถูกต้องของบริการหลัก จําเป็นต้องมี --ผู้เช่าและ --applicationId อาร์กิวเมนต์

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

--certificateDiskPath -cdp

ตัวเลือก: เส้นทางของดิสก์ใบรับรองเพื่อรับรองความถูกต้อง

--certificatePassword -cp

ตัวเลือก: รหัสผ่านใบรับรองเพื่อรับรองความถูกต้อง

--clientSecret -cs

ตัวเลือก: ข้อมูลลับไคลเอ็นต์เพื่อรับรองความถูกต้องด้วย

--cloud -ci

ตัวเลือก: อินสแตนซ์บนระบบคลาวด์ที่จะรับรองความถูกต้อง

ใช้หนึ่งในค่าเหล่านี้:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

ใช้โฟลว์รหัสอุปกรณ์ Microsoft Entra ID สําหรับการลงชื่อเข้าใช้แบบโต้ตอบ

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

--environment -env

สภาพแวดล้อมเริ่มต้น (ID, url, ชื่อที่ไม่ซ้ํา หรือชื่อบางส่วน)

--githubFederated -ghf

(ตัวอย่าง) ใช้ GitHub Federation สําหรับการรับรองความถูกต้องของบริการหลัก จําเป็นต้องมี --ผู้เช่าและ --applicationId อาร์กิวเมนต์

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

--managedIdentity -mi

ใช้ข้อมูลประจําตัวที่จัดการโดย Azure

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

--name -n

ชื่อที่คุณต้องการมอบให้กับโปรไฟล์การรับรองความถูกต้องนี้ (สูงสุด 30 อักขระ)

หมายเหตุ: ความยาวของชื่อควรอยู่ระหว่าง 1 ถึง 30

--password -p

ทางเลือก: รหัสผ่านเพื่อรับรองความถูกต้อง

--tenant -t

ID ผู้เช่าถ้าใช้ ID แอปพลิเคชัน/ข้อมูลลับของไคลเอ็นต์ หรือ ID แอปพลิเคชัน/ใบรับรองไคลเอ็นต์

--url -u

เลิกใช้: ใช้ --environment แทน

--username -un

ไม่บังคับ: ชื่อผู้ใช้เพื่อรับรองความถูกต้อง แสดงกล่องโต้ตอบ Microsoft Entra ID ถ้าไม่ได้ระบุ

หมายเหตุ

cloudสําหรับพารามิเตอร์ ค่าที่ใช้แมปไปยังคําย่อหรือชื่อทั่วไปอื่นๆ เหล่านี้:

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

ปัญหาการรับรองความถูกต้อง WSL2

เมื่อใช้ Windows Subsystem สําหรับ Linux เวอร์ชัน 2 (WSL2) คุณอาจมีปัญหาการรับรองความถูกต้องเช่น Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools เมื่อไม่มีการตั้งค่าเบราว์เซอร์เริ่มต้นในสภาพแวดล้อม WSL2 ของคุณ

ในการแก้ปัญหานี้ คุณสามารถใช้การรับรองความถูกต้องของรหัสอุปกรณ์โดยการเพิ่มค่า--deviceCodeสถานะไปยังคําสั่งของคุณauth create: pac auth create --environment {env-id} --deviceCode คุณจะต้องป้อนรหัสในเบราว์เซอร์ภายนอก WSL2 เพื่อเสร็จสิ้นกระบวนการรับรองความถูกต้อง

การลบการรับรองความถูกต้อง pac

ลบโปรไฟล์การรับรองความถูกต้องเฉพาะ

ตัวอย่าง

pac auth delete --index 2

พารามิเตอร์ที่เลือกได้สําหรับการลบการรับรองความถูกต้อง

--index -i

ดัชนีของโพรไฟล์ที่จะลบ

หมายเหตุ: ค่าต้องเป็นจํานวนเต็มที่มีค่าต่ําสุดเป็น 1

--name -n

ชื่อของโพรไฟล์ที่จะใช้งานอยู่

หมายเหตุ: ความยาวของชื่อควรอยู่ระหว่าง 1 ถึง 30

รายการการรับรองความถูกต้อง pac

แสดงรายการโปรไฟล์การรับรองความถูกต้องที่จัดเก็บบนคอมพิวเตอร์เครื่องนี้

ชื่อการรับรองความถูกต้อง pac

ตั้งชื่อหรือเปลี่ยนชื่อโปรไฟล์การรับรองความถูกต้องที่มีอยู่

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีการเปลี่ยนชื่อโปรไฟล์การรับรองความถูกต้อง ในกรณีนี้ โปรไฟล์ที่มีดัชนี 1 จะถูกเปลี่ยนชื่อเป็น 'Contoso Dev'

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

พารามิเตอร์ที่จําเป็นสําหรับชื่อการรับรองความถูกต้อง

--index -i

ดัชนีของโปรไฟล์ที่จะตั้งชื่อ/เปลี่ยนชื่อ

หมายเหตุ: ค่าต้องเป็นจํานวนเต็มที่มีค่าต่ําสุดเป็น 1

--name -n

ชื่อที่คุณต้องการมอบให้กับโปรไฟล์การรับรองความถูกต้องนี้ (สูงสุด 30 อักขระ)

หมายเหตุ: ความยาวของชื่อควรอยู่ระหว่าง 1 ถึง 30

เลือกการรับรองความถูกต้อง pac

เลือกโปรไฟล์การรับรองความถูกต้องที่ควรเปิดใช้งาน

ตัวอย่าง

pac auth select --index 2

พารามิเตอร์ที่เลือกได้สําหรับการเลือกการรับรองความถูกต้อง

--index -i

ดัชนีของโพรไฟล์ที่จะใช้งานอยู่

หมายเหตุ: ค่าต้องเป็นจํานวนเต็มที่มีค่าต่ําสุดเป็น 1

--name -n

ชื่อของโพรไฟล์ที่จะใช้งานอยู่

หมายเหตุ: ความยาวของชื่อควรอยู่ระหว่าง 1 ถึง 30

ปรับปรุงการรับรองความถูกต้อง pac

อัปเดตชื่อหรือสภาพแวดล้อมเป้าหมายของโปรไฟล์การรับรองความถูกต้องที่มีอยู่

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงการใช้คําสั่งปรับปรุง pac auth

อัปเดตโปรไฟล์การรับรองความถูกต้องด้วย 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 ด้วย ID 00000000-0000-0000-0000-000000000000สภาพแวดล้อม

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

พารามิเตอร์ที่จําเป็นสําหรับการอัปเดตการรับรองความถูกต้อง

--index -i

ดัชนีของโปรไฟล์ที่จะตั้งชื่อ/เปลี่ยนชื่อ

หมายเหตุ: ค่าต้องเป็นจํานวนเต็มที่มีค่าต่ําสุดเป็น 1

พารามิเตอร์ที่เลือกได้สําหรับการอัปเดตการรับรองความถูกต้อง

--environment -env

สภาพแวดล้อมเริ่มต้น (ID, url, ชื่อที่ไม่ซ้ํา หรือชื่อบางส่วน)

--name -n

ชื่อที่คุณต้องการมอบให้กับโปรไฟล์การรับรองความถูกต้องนี้ (สูงสุด 30 อักขระ)

การรับรองความถูกต้อง pac ใคร

แสดงข้อมูลเกี่ยวกับโปรไฟล์การรับรองความถูกต้องที่เลือกในปัจจุบัน

ดูเพิ่มเติม

กลุ่มคําสั่ง Microsoft Power Platform CLI
ภาพรวม Microsoft Power Platform CLI