تثبيت Microsoft Dynamics 365 for Outlook باستخدام موجه الأوامر

  • مقالة

 

تاريخ النشر: جمادى الأولى, 1438

ينطبق على: Dynamics 365 (online)، Dynamics 365 (on-premises)، Dynamics CRM 2016، Dynamics CRM Online

تثبيت Microsoft Dynamics 365 لـ Outlook عبارة عن إجراء من خطوتين. أولاً، يجب تشغيل الإعداد لتثبيت الملفات على الكمبيوتر. بعد ذلك، قم بتشغيل Microsoft Dynamics 365معالج التكوين لتكوين التطبيق وإكمال التثبيت.

هام

إذا كان هناك تعارض بين قيمة في ملف التكوين وقيمة في معلمات سطر الأوامر، فإن معلمة سطر الأوامر تكون لها الأسبقية.

في هذا الموضوع

الخطوة الأولى: ملفات التثبيت

الخطوة الثانية: تكوين Dynamics 365 for Outlook باستخدام ملف تكوين XML

أمثلة أوامر لتكوين Dynamics 365 for Outlook

عناصر ملف تكوين Dynamics 365 for Outlook

بيانات اعتماد المستخدم مطلوبة عندما تقوم بتشغيل "معالج التكوين"

نموذج Dynamics 365 for Outlook لملف تكوين Outlook XML للتكوين

الخطوة الأولى: ملفات التثبيت

ملاحظة

راجع تثبيت Dynamics 365 for Outlook للحصول على إرشادات التنزيل.

يعرض الأمر التالي الخيارات المتاحة لتشغيل إعداد Microsoft Dynamics CRM for Outlook في موجه الأوامر:

Setupclient.exe [/A] [/Q] [/X] [/L أو /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

أمثلة الأوامر لتثبيت Dynamics 365 for Outlook

للمستخدمين الذين يسافرون أو الذين لا يتصلون دائمًا بـ Microsoft Dynamics 365 Server، يوفر Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access الوصول إلى بيانات العملاء الخاصة بهم. لتثبيت Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access في الوضع الصامت:

Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"

لإلغاء تثبيت Microsoft Dynamics 365 for Microsoft Office Outlook with Offline Access في الوضع الصامت:

SetupClient /x /q

معلمات تثبيت Dynamics 365 for Outlook

المعلمة‬

الوصف

بلا

عند استخدامه بدون معلمات، يتم تشغيل Setupclient.exe مع جميع شاشات العرض.

installofflinecapability

يحدد ما إذا كان سيتم تثبيت إمكانية العمل دون اتصال. عند تضمين هذه المعلمة، يتم تثبيت المكونات وإمكانية العمل دون اتصال. إذا لم تقم بتحديد هذه المعلمة، فسيتم تثبيت العميل عبر الإنترنت فقط.

/targetdir <"drive:\path">

يحدد المجلد الذي سيتم تثبيت ملفات Dynamics 365 for Outlook به.

/A

يقوم بإنشاء تثبيت إداري لـ Dynamics 365 for Outlook من خلال إنشاء حزمة Windows Installer. تتيح هذه الحزمة للمستخدمين تشغيل الإعداد من مشاركة عبر شبكة أو تتيح للمستخدمين غير الإداريين تشغيل الإعداد الذي تم تشغيله من نهج مجموعة. يجب استخدام هذه المعلمة مع معلمة /targetdir التي يتم شرحها لاحقا. عند استخدام هذه المعلمة، لا يجب أن تكون القيمة /targetdir موجودة على الكمبيوتر المحلي. يمكن استخدام مشغل معيّن أو مشاركة عبر الشبكة، مثل \\share\mscrm_client_admin.

هام

إذا لم تقم بتحديد مجلد هدف باستخدام المعلمة /targetdir، فسيقوم الإعداد بتثبيت التثبيت الإداري على المجلد الافتراضي <drive:> Program Files\Microsoft Dynamics CRM.

على سبيل المثال، الأمر:

Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"

/Q

تثبيت الوضع الصامت. تتطلب هذه المعلمة ملف تكوين بتنسيق XML. تحتوي المعلمة /i على اسم ملف تكوين XML. لن تظهر أي مربعات حوار أو رسائل الخطأ على شاشة العرض. ولالتقاط معلومات رسالة الخطأ، قم تضمين معلمة ملف السجل (/L أو /LV).

/L [drive:][[path] logfilename.log]

يقوم بإنشاء ملف سجل التثبيت. يتعين عليك تحديد اسم ملف السجل ومكان وضعه، لكن لا يمكن أن يكون المسار نسبيا، مثل %appdata%\CRMLogs.

/LV [drive:][[path] logfilename.log]

يقوم بإنشاء ملف سجل مطوّل لنشاط التثبيت. يتعين عليك تحديد اسم ملف السجل ومكان وضعه، لكن لا يمكن أن يكون المسار نسبيا، مثل %appdata%\CRMLogs.

disableofflinecapability

عند تحديد هذه المعلمة، يتم تكوين Dynamics 365 for Outlook لإخفاء الزر "العمل دون اتصال" الموجود في التطبيق. يسمح هذا الزر للمستخدمين بالتبديل إلى Dynamics 365 for Outlook مع إمكانية العمل دون اتصال.

ignoreofflinequeue

عند تحديد هذه المعلمة، فلن يحاول الإعداد مزامنة العناصر التي يمكن أن تبقى في قائمة الانتظار دون اتصال أثناء عملية الترقية.

/X

يقوم بإزالة تثبيت Dynamics 365 for Outlook. وهذا أحد خيارات وضع الصيانة الذي يتوفر فقط عند تثبيت التطبيق مسبقاً.

نموذج Dynamics 365 for Outlook لملف تكوين Outlook XML للتثبيت

يقوم مثال ملف التكوين التالي بتثبيت Dynamics 365 for Outlook دون إمكانية الوصول دون اتصال إلى المجلد Program Files.

ملاحظة

يمكنك استخدام الملف نفسه الذي يتضمن عناصر التثبيت والتكوين. يتجاهل كل من الإعداد ومعالج التكوين العناصر التي ليست ذات صلة بالعملية.

<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>

الخطوة الثانية: تكوين Dynamics 365 for Outlook باستخدام ملف تكوين XML

بعد التثبيت، يجب تكوين Dynamics 365 for Outlook. يمكنك القيام بذلك عن طريق تشغيل Dynamics 365 for Outlookمعالج التكوين في موجه الأوامر. يتم تسمية ملف معالج التكوين باسم Microsoft.Crm.Application.Outlook.ConfigWizard.exe ووضعه في مجلد Client\ConfigWizard حيث يتم تثبيت Dynamics 365 for Outlook. يكون المجلد هو C:\Program Files\Microsoft Dynamics CRM بشكل افتراضي.

ملاحظة

يتم استخدام بيانات اعتماد المستخدم الذي سيقوم بتشغيل Dynamics 365 for Outlook للمصادقة إلى Microsoft Dynamics 365. وبالتالي، لتنفيذ تكوين صامت لـ Dynamics 365 for Outlook، يتعين عليك تشغيل معالج التكوين ضمن سياق المستخدم، مثل من خلال تشغيل ملف التصحيح الذي يقوم المستخدم باستدعائه أو إدخال لمرة واحدة في برنامج نصي لتسجيل الدخول. لمزيد من المعلومات، انظر بيانات اعتماد المستخدم مطلوبة عندما تقوم بتشغيل "معالج التكوين": لنشر Dynamics 365 for Outlook باستخدام نهج مجموعة Microsoft، راجع نشر Microsoft Dynamics 365 for Outlook عن طريق استخدام "نهج المجموعة".

إذا لم يتم تحديد مسار لملف التكوين، فسيبحث معالج التكوين عن ملف التكوين الافتراضي (default_client_config.xml) في مجلد ملف التعريف غير المتجول (%localappdata%\Microsoft\MSCRM\). إذا كان الملف غير موجود في مجلد ملف التعريف غير المتجول، فسيبحث معالج التكوين عن المجلد الذي تم تثبيت Dynamics 365 for Outlook فيه. يتم تثبيت Dynamics 365 for Outlook بشكل افتراضي في المجلد C:\Program Files\Microsoft Dynamics CRM.

إذا كان ملف التكوين يوجد في الموقع المتجول المستخدم من قبل التطبيقات الأخرى (AppData\Roaming\Microsoft\MSCRM\), فسيتم تجاهله.

أمثلة أوامر لتكوين Dynamics 365 for Outlook

يقوم الأمر التالي بتكوين Microsoft Dynamics 365 لبرنامج Outlook مع وصول دون اتصال باستخدام ملف باسم config_client.xml في الوضع الصامت، ويقوم بإخراج ملف سجل باسم clientinstall.log:

Microsoft.Crm.Application.Outlook.ConfigWizard.exe /Q /i c:\config_client.xml /xa /l c:\clientinstall.log

تتطلب معلمة تكوين الوضع الصامت /Q ملف تكوين بتنسيق XML. لن تظهر أي مربعات حوار أو رسائل الخطأ على شاشة العرض. ولالتقاط معلومات رسالة الخطأ، قم بتضمين معلمة ملف السجل (/L) أو التسجيل بشكل مطوّل (/LV).

هام

تكون بيانات اعتماد المستخدم الصحيحة التي تم تخزينها في مخزن Windows مطلوبة لتشغيل معالج التكوين في الوضع الصامت.مزيد من المعلومات: بيانات اعتماد المستخدم مطلوبة عندما تقوم بتشغيل "معالج التكوين"

تقوم معلمة سطر أوامر /i [المحرك:] [[المسار] configfilename.xml]] إعداد Microsoft Dynamics CRM for Outlook بالمعلومات المطلوبة. كما أنها نفس المعلومات التي تتطلبها كل شاشة تثبيت. يجب أن تكون عناصر XML باللغة الإنجليزية (الولايات المتحدة) أو بأحرف خاصة أو ممتدة لا يمكن استخدامها. لن يعمل ملف تكوين XML الذي قام بتطويع عناصر XML لغويا بشكل صحيح. فيما يلي شرح لكل عنصر XML وملف XML عينة.

تقوم المعلمة /xa ، عند استخدامها مع المعلمة /q، بإزالة جميع المؤسسات التي تم تكوينها لـ Dynamics 365 for Outlook.

يمكن استخدام المعلمة /R لمنع واجهة مستخدم معالج التكوين وعرض مربع حوار التقدم فقط. تتطلب هذه المعلمة ملف XMLالإعداد صالحًا مسمى Default_Client_Config.xml ويجب أن يكون موجودًا في مجلد المستخدم المحلي AppData أو مجلد تثبيت العميل.

عناصر ملف تكوين Dynamics 365 for Outlook

العنصر

الوصف

<Deployments> </Deployments>

يجب أن يكون ملف التكوين ملف XML صالح يستخدم <التوزيع> على أنه العنصر الجذر.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

تحدد نوع تثبيت Dynamics 365 for Outlook. سيؤدي تحديد true إلى تثبيت إمكانية Microsoft Dynamics 365 لبرنامج Outlook مع وصول دون اتصال.

<TargetDir>drive:\path</TargetDirectory>

يحدد المجلد الذي سيتم تثبيت ملفات Dynamics 365 for Outlook به.

<Deployment> </Deployment>

العنصر الأصل لجميع العناصر التالية.

<DiscoveryUrl>https://website:portnumber</DiscoveryUrl>

يحدد عنوان URL لـ Microsoft Dynamics 365خدمة ويب الاكتشاف.

ولتوزيع Microsoft Dynamics 365 Server محليا، يمكن أن يكون الربط المدعوم عبارة عن HTTPS أو HTTP. إذا كان خدمة ويب الاكتشاف يستخدم منفذا خلاف المنافذ الافتراضية 80 (HTTP) أو 443 (HTTPS)، فيتعين عليك تحديد رقم المنفذ. إذا كان هذا هو التوزيع الكامل لخادم Microsoft Dynamics 365 Server، يكون عنوان خدمة ويب الاكتشاف URLهو نفس عنوان تطبيق الويب، مثل http://crmserver .

وبالنسبة لـ Microsoft Dynamics 365 (على الإنترنت)، استخدم عنوان URL الكامل الخاص بالمؤسسة، مثل https://orgname.crm.dynamics.com، أو بناء على بيئتك عبر الإنترنت ومكانك، استخدم عنوان URL الخاص بخدمة الاكتشاف، في النموذج https://disco.crm.dynamics.com. للحصول على قائمة URLs، راجع MSDN: خدمة الاكتشاف.

<FederatedAuthentication>true/false</FederatedAuthentication>

يحدد ما إذا كانت بيانات الاعتماد المتحدة (Azure Active Directory) مستخدمة للمصادقة في معالج التكوين. إذا قمت بتحديد false، فيمكنك استخدام بيانات اعتماد مثل user@contoso.onmicrosoft.com.

<Organizations> </Organizations>

هذا هو العنصر الأصل لعنصر <المؤسسة> التالي.

<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization>

تقوم بتعيين اسم المؤسسة التي سيتصل العميل بها.

FriendlyName. تقوم بتعين اسم عرض آخر مختلف عن اسم المؤسسة في Outlook.

IsPrimary. تقوم بتحدد المؤسسة التي سيتم تكوينها كمؤسسة المزامنة في Dynamics 365 for Outlook.

ملاحظة

OrganizationName حساس لحالة الأحرف.

<CEIPNotification>true/false</CEIPNotification>

يحدد ما إذا كان Dynamics 365 for Outlook سيعرض شعار الإعلام "أريد الانضمام إلى برنامج تحسين المنتجات وفقًا لاستخدام العملاء". الإعداد الافتراضي هو true ويتم عرض شعار الإعلام. إذا قمت بتحديد false، فلا يظهر اشعار الإعلام في Dynamics 365 for Outlook.مزيد من المعلومات: برنامج تحسين المنتجات وفقًا لاستخدام العملاء من Microsoft

بيانات اعتماد المستخدم مطلوبة عندما تقوم بتشغيل "معالج التكوين"

يتطلب معالج التكوين بيانات اعتماد المستخدم. وخلال التكوين الصامت، من خلال استخدام /Q مع ملف Microsoft.Crm.Application.Outlook.ConfigWizard.exe سيقوم معالج التكوين بالبحث عن بيانات اعتماد المستخدم في مخزن Windows. إذا كان معالج التكوين لا يمكنه العثور على بيانات الاعتماد أو لم تكن بيانات الاعتماد بالتنسيق المطلوب فلن يتم إكمال التكوين وسيتم تسجيل خطأ في ملف سجل التكوين. لاحظ أن معالج التكوين لا يدعم إضافة مستخدم UPN أو كلمة مرور في ملف تكوين XML. لمزيد من المعلومات حول كيفية إضافة بيانات اعتماد المستخدم من برنامج نصي لأحد الأوامر إلى مخزن Windows، راجع نشر المدونة التكوين الصامت لعميل CRM for Outlook في بيئة CRM 2011 تم تمكين المطالبات فيها. لمزيد من المعلومات حول مخزن Windows وإدارة بيانات الاعتماد، راجع ما المقصود بإدارة بيانات الاعتماد

نموذج Dynamics 365 for Outlook لملف تكوين Outlook XML للتكوين

يقوم مثال ملف التكوين التالي بتكوين Dynamics 365 for Outlook للاتصال بمؤسسة أساسية باسم Contoso ومؤسسة أخرى باسم AdventureWorksCycle على Microsoft Dynamics 365 Server باسم crmserver.

ملاحظة

يمكنك استخدام الملف نفسه الذي يتضمن عناصر التثبيت والتكوين. سيتجاهل كل من الإعداد ومعالج التكوين العناصر التي ليست ذات صلة بالعملية.

ملف Default_Client_Config.xml مثال

<Deployments>
<Deployment>
<DiscoveryUrl>http://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>

ملاحظة

يحدد المثال السابق مؤسستين مختلفتين أخريين لدى المستخدم حق الوصول إليهما وتكوين Dynamics 365 for Outlook لعدم عرض الشعار الإعلام "أريد الانضمام إلى برنامج تحسين المنتجات وفقا لاستخدام العملاء". لا يمكن أن تحتوي القيمة الموجودة في عنصر Organization على أحرف خاصة أو مسافات. في Dynamics 365 (محلي)، يمكنك العثور على الاسم الفريد للمؤسسة عن طريق تشغيل أمر Get-CrmOrganization Windows PowerShell cmdlet أو الانتقال إلى الإعدادات > التخصيصات‬ > موارد المطورين وضمن معلومات مرجع المثيل‬ نسخ الاسم الفريد.

تكوين Dynamics 365 for Outlook باستخدام برنامج نصي

  1. قم بكتابة برنامج نصي يقوم تلقائياً بتحديث إعدادات التكوين لمستخدمي Dynamics 365 for Outlook. يمكنك استخدام بنود مثل التالية لتنفيذ إجراءات التكوين الأساسي، استناداً إلى ملف تكوين جديد مخزن على الكمبيوتر والمشار إليه بـ <servername>.

    في البرنامج النصي التالي، تتم الكتابة فوق ملف تكوين العميل الافتراضي، وتتم إزالة المؤسسات التي تم تكوينها سابقا، وتتم إضافة بيانات اعتماد المستخدم إلى مخزن Windows ويتم تثبيت المؤسسة الجديدة.

    copy /y \\<servername>\share\Default_Client_Config.xml "c:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"
"C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /xa
cmdkey /generic:Microsoft_CRM_https://disco.crm.dynamics.com/ /user:user@contoso.com /password{password_goes_here}
"C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /i 
"C:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"

    تلميح

    قم بتشغيل البرنامج النصي الخاص بك كبرنامج نصي لتسجيل الدخول أو قم بفرض تشغيل البرنامج النصي في وقت محدد، مثلا باستخدام إدارة تكوين Microsoft System Center 2012.

    في البرنامج النصي، قد تريد أيضا تضمين منطق الكشف الذي يحدد ما إذا كان جهاز الكمبيوتر العميل قد تم تكوينه بالفعل أم لا. إذا كان قد تم تكوينه، فيمكنك إنهاء البرنامج النصي دون اتخاذ أي إجراء.

    ملف Default_Client_Config.xml مثال

    <Deployment>
<DiscoveryUrl>http://CrmDiscoveryUrl</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Organization1</Organization>
</Organizations>
</Deployment>

  2. قم بتشغيل البرنامج النصي على كل كمبيوتر عميل في المؤسسة التي تم تغيير خادمها. يمكنك تشغيل البرنامج النصي بطرق مختلفة، بما في ذلك علامة التبويب ملف التعريف الخاصة بمربع حوار خصائص المستخدم في Active Directory Users and Computers (ADUC)، أو من خلال كائنات نهج المجموعة (GPO).

انظر أيضا

تثبيت Dynamics 365 for Outlook
إعداد Dynamics 365 for Outlook
Install Microsoft Dynamics CRM Server by using a command prompt
Dynamics 365 for Outlook

© 2017 Microsoft. جميع الحقوق محفوظة. حقوق النشر