مشاركة عبر

مصادقة pac

إدارة كيفية المصادقة على خدمات مختلفة

الاتصال بالمستأجر الخاص بك

استخدم الأمر pac auth create للاتصال بالمستأجر الخاص بك. يؤدي التشغيل 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 auth وأوامر تحديد pac auth .

يسرد 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 auth إنشاء ملفات تعريف المصادقة وتخزينها على هذا الكمبيوتر
حذف مصادقة pac حذف ملف تعريف مصادقة معين
قائمة pac auth سرد ملفات تعريف المصادقة المخزنة على هذا الكمبيوتر
اسم مصادقة pac تسمية ملف تعريف مصادقة موجود أو إعادة تسميته
تحديد pac auth حدد ملف تعريف المصادقة الذي يجب أن يكون نشطا
تحديث مصادقة pac تحديث الاسم أو البيئة المستهدفة لملف تعريف مصادقة موجود
pac auth الذي عرض معلومات حول ملف تعريف المصادقة المحدد حاليا

مسح مصادقة pac

مسح كافة ملفات تعريف المصادقة المخزنة على هذا الكمبيوتر

إنشاء pac auth

إنشاء ملفات تعريف المصادقة وتخزينها على هذا الكمبيوتر

الأمثلة

توضح الأمثلة التالية استخدام pac auth create الأمر .

إنشاء أساسي

يطالبك هذا المثال ببيانات الاعتماد ويتصل بالمستأجر الذي تنتمي إليه بيانات الاعتماد.

pac auth create

‏‫ملاحظة‬

عند تشغيل Power Platform CLI في Codespaces، تقوم هذه العملية بتشغيل تسجيل الدخول إلى رمز الجهاز.

إنشاء بيئة

يطالبك هذا المثال ببيانات الاعتماد ويتصل ببيئة Power Platform باستخدام معرف البيئة الذي تحدده.

pac auth create --environment < Your environment ID >

التلميح

للعثور على معرف بيئة: افتح مركز إدارة Power Platform وحدد البيئة التي تريد الاتصال بها. في قسم التفاصيل ، ابحث عن معرف البيئة

إنشاء مسمى

يصادق هذا المثال مع المستأجر الخاص بك ويعطيه الاسم 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 (مثل Azure Cloud Shell أو Azure VM مع الهوية المدارة أو Visual Studio Code مع ملحق حساب Azure)، يمكنك استخدام العلامة --managedIdentity للمصادقة باستخدام هوية Azure. يستخدم PAC CLI بيانات اعتماد Azure الافتراضية وهي سلسلة بيانات اعتماد تم تقييمها مسبقا.

تم تصميم بيانات اعتماد Azure الافتراضية لدعم العديد من البيئات، جنبا إلى جنب مع تدفقات المصادقة وأدوات المطور الأكثر شيوعا. يمكنك تخصيص السلوك عن طريق تعيين متغيرات البيئة كما هو موضح في وثائق بيانات اعتماد Azure الافتراضية. على سبيل المثال، للمصادقة باستخدام هوية مدارة معينة من قبل المستخدم، قم بتعيين AZURE_CLIENT_ID متغير البيئة إلى معرف العميل للهوية المدارة المعينة من قبل المستخدم. راجع المزيد من التفاصيل في تعيين متغيرات بيئة التطبيق.

معلمات اختيارية لإنشاء المصادقة

--applicationId -id

اختياري: معرف التطبيق للمصادقة عليه.

--azureDevOpsFederated -adof

(معاينة) استخدام اتحاد Azure DevOps لمصادقة كيان الخدمة؛ يتطلب وسيطات --tenant و--applicationId

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--certificateDiskPath -cdp

اختياري: مسار قرص الشهادة للمصادقة باستخدام

--certificatePassword -cp

اختياري: كلمة مرور الشهادة للمصادقة باستخدام

--clientSecret -cs

اختياري: سر العميل للمصادقة باستخدام

--cloud -ci

اختياري: مثيل السحابة للمصادقة باستخدام

استخدم إحدى هذه القيم:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

استخدم تدفق رمز جهاز معرف Microsoft Entra لتسجيل الدخول التفاعلي.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

البيئة الافتراضية (المعرف أو url أو الاسم الفريد أو الاسم الجزئي).

--githubFederated -ghf

(معاينة) استخدام GitHub Federation لمصادقة كيان الخدمة؛ يتطلب وسيطات --tenant و--applicationId

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--managedIdentity -mi

استخدم هوية Azure المدارة.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--name -n

الاسم الذي تريد منحه لملف تعريف المصادقة هذا (بحد أقصى 30 حرفا).

ملاحظة: يجب أن يتراوح طول الاسم بين 1 و30

--password -p

اختياري: كلمة المرور للمصادقة باستخدام

--tenant -t

معرف المستأجر في حالة استخدام معرف التطبيق/سر العميل أو معرف التطبيق/شهادة العميل.

--url -u

مهمل: استخدم --environment بدلا من ذلك.

--username -un

اختياري: اسم المستخدم للمصادقة باستخدام؛ يعرض مربع حوار Microsoft Entra ID إذا لم يتم تحديده.

ملاحظات

بالنسبة للمعلمة cloud ، القيم التي يجب استخدامها لتعيين هذه الاختصارات أو الأسماء الشائعة الأخرى:

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

مشكلات مصادقة WSL2

عند استخدام نظام Windows الفرعي للإصدار 2 من Linux (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 auth

سرد ملفات تعريف المصادقة المخزنة على هذا الكمبيوتر

اسم مصادقة pac

تسمية ملف تعريف مصادقة موجود أو إعادة تسميته

مثال

يوضح المثال التالي كيفية إعادة تسمية ملف تعريف المصادقة. في هذه الحالة، ستتم إعادة تسمية ملف التعريف مع الفهرس 1 إلى "Contoso Dev".

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

المعلمات المطلوبة لاسم المصادقة

--index -i

فهرس ملف التعريف المراد تسميته/إعادة تسميته

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 1 كحد أدنى.

--name -n

الاسم الذي تريد منحه لملف تعريف المصادقة هذا (بحد أقصى 30 حرفا).

ملاحظة: يجب أن يتراوح طول الاسم بين 1 و30

تحديد pac auth

حدد ملف تعريف المصادقة الذي يجب أن يكون نشطا

مثال

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 بمعرف 00000000-0000-0000-0000-000000000000البيئة .

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

المعلمات المطلوبة لتحديث المصادقة

--index -i

فهرس ملف التعريف المراد تسميته/إعادة تسميته

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 1 كحد أدنى.

معلمات اختيارية لتحديث المصادقة

--environment -env

البيئة الافتراضية (المعرف أو url أو الاسم الفريد أو الاسم الجزئي).

--name -n

الاسم الذي تريد منحه لملف تعريف المصادقة هذا (بحد أقصى 30 حرفا).

pac auth الذي

عرض معلومات حول ملف تعريف المصادقة المحدد حاليا

(راجع أيضًا )

مجموعات أوامر Microsoft Power Platform CLI
نظرة عامة على Microsoft Power Platform CLI

  • Last updated on