หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
จัดการวิธีที่คุณรับรองความถูกต้องในบริการต่าง ๆ
เชื่อมต่อกับผู้เช่าของคุณ
ใช้ คําสั่งสร้างการรับรองความถูกต้อง 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
ตัวเลือก: อินสแตนซ์บนระบบคลาวด์ที่จะรับรองความถูกต้อง
ใช้หนึ่งในค่าเหล่านี้:
PublicUsGovUsGovHighUsGovDodChina
--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 ของสภาพแวดล้อม
- อัปเดตโปรไฟล์การรับรองความถูกต้องด้วยรหัสสภาพแวดล้อม
อัปเดตโปรไฟล์การรับรองความถูกต้องด้วย 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