Установка Microsoft Dynamics CRM для Outlook с помощью командной строки

 

Опубликовано: Июль 2016

Применимо к: Dynamics CRM 2015

Установка Microsoft Dynamics CRM для Outlook выполняется за два шага. Сначала нужно запустить программу установку для установки файлов на компьютер. Затем следует запустить Microsoft Dynamics CRMМастер настройки, чтобы настроить приложение и завершить установку.

Важно!

В случае конфликта между значением в файле конфигурации и значением в параметрах командной строки параметр командной строки имеет более высокий приоритет.

Содержание

Шаг 1. Установка файлов

Шаг 2. Настройка CRM для Outlook с помощью XML-файла конфигурации

Примеры команд для настройки CRM для Outlook

Элементы XML-файла конфигурации CRM для Outlook

При запуске мастера настройки необходимы учетные данные пользователя

Пример XML-файла конфигурации CRM для Outlook для настройки

Шаг 1. Установка файлов

Следующая команда показывает доступные варианты для запуска Установка Microsoft Dynamics CRM для Outlook в командной строке:

Setupclient.exe [/A] [/Q] [/X] [/L или /LV "[диск:][[ путь] имя_файла_журнала.log]"] [/targetdir "[диск:][ путь]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Примеры команд для установки CRM для Outlook

Для пользователей, которые находятся в поездке или не всегда подключены к Сервер Microsoft Dynamics CRM, Microsoft Dynamics CRM для Microsoft Office Outlook с доступом в автономном режиме предоставляет доступ к данным клиента. Чтобы установить Microsoft Dynamics CRM для Microsoft Office Outlook с доступом в автономном режиме в тихий режим, выполните следующие действия.

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

Чтобы удалить Microsoft Dynamics CRM для Microsoft Office Outlook с доступом в автономном режиме в тихом режиме, выполните следующие действия.

SetupClient /x /q

Параметры для установки CRM для Outlook

Параметр

Описание

нет

Используется без параметров, Setupclient.exe будет выполняться со всеми экранами просмотра.

installofflinecapability

Указывает, следует ли устанавливать возможность работы вне сети. При включении этого параметра устанавливаются режим работы вне сети и компоненты. Если этот параметр не указан, устанавливается только интерактивный клиент.

/targetdir <"drive:\path">

Определяет папку, в которую будут установлены файлы Dynamics CRM для Outlook.

/A

Создает административную установку Dynamics CRM для Outlook путем создания пакета установщика Windows. Этот пакет позволяет пользователям запускать Установка из общей сетевой папки или позволяет пользователям без прав администратора запускать Установка под управлением групповой политики. Этот параметр следует использовать вместе с параметром /targetdir, описанным выше. При использовании этого параметра папка /targetdir не обязательно должна располагаться на локальном компьютере. Можно использовать сопоставленный диск или общую сетевую папку, например \\сетевая_папка\администратор_клиента_mscrm.

Важно!

Если не указать целевую папку с помощью параметра /targetdir, Установка установит административную установки в папку по умолчанию <диск:> 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 CRM для Outlook будет скрывать кнопку "Перейти в автономный режим" в приложении. Эта кнопка позволяет пользователям переключиться в Dynamics CRM для Outlook с возможностью работы вне сети.

ignoreofflinequeue

Если указать этот параметр, Установка не будет пытаться синхронизировать элементы, которые могут оставаться в автономной очереди, во время обновления.

/X

Удаление Dynamics CRM для Outlook. Это параметр режима обслуживания, который доступен, только когда приложение уже установлено.

Пример XML-файла конфигурации CRM для Outlook для установки

В следующем примере файла конфигурации выполняется установка Dynamics CRM для Outlook без возможности автономного доступа к папке Program Files.

Примечание

Можно использовать один и файл, содержащий как элементы установки, так и элементы настройки.Установка и Мастер настройки игнорируют элементы, не относящиеся к операции.

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

Шаг 2. Настройка CRM для Outlook с помощью XML-файла конфигурации

После установки Dynamics CRM для Outlook необходимо произвести настройку. Это можно сделать, запустив Dynamics CRM для OutlookМастер настройки из командной строки. Файл Мастер настройки называется Microsoft.Crm.Application.Outlook.ConfigWizard.exe и находится в папке Client\ConfigWizard, в которой установлено приложение Dynamics CRM для Outlook. По умолчанию используется папка C:\Program Files\Microsoft Dynamics CRM.

Примечание

Учетные данные пользователя, который будет запускать Dynamics CRM для Outlook, используются для проверки подлинности в Microsoft Dynamics CRM. Поэтому, чтобы выполнить автоматическую настройку Dynamics CRM для Outlook, необходимо запустить Мастер настройки в контексте пользователя, например выполнение вызванного пользователем пакетного файла или использование одноразовой записи в скрипте входа в систему. Дополнительные сведения см. в статье При запуске мастера настройки необходимы учетные данные пользователя. Чтобы развернуть Dynamics CRM для Outlook с помощью групповой политики Майкрософт, см. раздел Развертывание Microsoft Dynamics CRM для Outlook с помощью групповой политики.

Если путь к файлу конфигурации не указан, Мастер настройки выполнит поиск файла конфигурации по умолчанию (default_client_config.xml) в папке неперемещаемого профиля (%localappdata%\Microsoft\MSCRM\). Если файл не находится в папке неперемещаемого профиля, Мастер настройки выполнит поиск папки, в которой установлено приложение Dynamics CRM для Outlook. По умолчанию приложение Dynamics CRM для Outlook установлено в папке C:\Program Files\Microsoft Dynamics CRM.

Если файл конфигурации находится в перемещаемой папке, используемой другими приложениями (AppData\Roaming\Microsoft\MSCRM\), он не будет учитываться.

Примеры команд для настройки CRM для Outlook

Следующая команда настраивает Microsoft Dynamics CRM для 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 [диск:] [[путь] имя_файла_конфигурации.xml]] предоставляет Установка Microsoft Dynamics CRM для Outlook необходимые сведения. Это те же сведения, которые требуются на каждом экране установки.XML-элементы должны быть на английском языке (США); запрещается использовать специальные символы или расширенный набор символов. XML-файл конфигурации с локализованными XML-элементами будет работать неправильно. Описание каждого XML-элемента и пример XML-файла см. ниже.

Параметр /xa при использовании с параметром /q удаляет все организации, настроенные для Dynamics CRM для Outlook.

Параметр /R может использоваться для отмены применения пользовательского интерфейса Мастер настройки и отображения лишь диалогового окна хода выполнения. Для этого параметра требуется действительный файл XMLУстановка с именем Default_Client_Config.xml. Этот параметр должен быть расположен либо в папке AppData локального пользователя, либо в папке установки клиента.

Элементы XML-файла конфигурации CRM для Outlook

Элемент

Описание

<Deployments> </Deployments>

Файл конфигурации должен быть действительным XML-файлом, использующим <Развертывание> как корневой элемент.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Указывает тип установки Dynamics CRM для Outlook. Если задать значение true, будет установлена возможность Microsoft Dynamics CRM для Outlook с доступом вне сети.

<TargetDir>drive:\path</TargetDirectory>

Определяет папку, в которую будут установлены файлы Dynamics CRM для Outlook.

<Deployment> </Deployment>

Родительский элемент для всех следующих элементов.

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

Указывает URL-адрес для Microsoft Dynamics CRMВеб-служба обнаружения.

Для локального развертывания Сервер Microsoft Dynamics CRM может поддерживаться привязка HTTPS или HTTP. Если в Веб-служба обнаружения используется порт, отличный от портов 80 (HTTP) или 443 (HTTPS) по умолчанию, необходимо указать номер порта. Если это развертывание полного сервера Сервер Microsoft Dynamics CRM, URL-адрес Веб-служба обнаружения совпадает с URL-адресом веб-приложения, например http://сервер_CRM.

В случае Microsoft Dynamics CRM Online используйте полный URL-адрес организации, например https://orgname.crm.dynamics.com, или в зависимости от сетевой среды и положения используйте URL-адрес службы обнаружения в форме https://disco.crm.dynamics.com. Список URLs см. в разделе MSDN: служба обнаружения.

<Organizations> </Organizations>

Это родительский элемент для следующего элемента <Organization>.

<Organization FriendlyName="понятное_имя_организации" IsPrimary="true"/"false">OrganizationName</Organization>

Указывает имя организации, к которой подключается клиент.

FriendlyName. Указывает другое отображаемое имя, отличной от имени организации в Microsoft Outlook.

IsPrimary. Указывает организацию, которая будет настроена как организация для синхронизации в Dynamics CRM для Outlook.

Примечание

OrganizationName учитывает регистр.

<CEIPNotification>true/false</CEIPNotification>

Указывает, будет ли Dynamics CRM для Outlook отображать баннер уведомления "Я хочу участвовать в программе улучшения качества ПО". По умолчанию задано значение true и баннер уведомления отображается. Если указать значение false, баннер уведомления не будет отображаться в Dynamics CRM для Outlook.Дополнительные сведения:Программа улучшения качества программного обеспечения Майкрософт

При запуске мастера настройки необходимы учетные данные пользователя

Для Мастер настройки требуются учетные данные пользователя. Во время автоматической настройки с помощью параметра /Q с файлом Microsoft.Crm.Application.Outlook.ConfigWizard.exeМастер настройки выполнит поиск учетных данных пользователя в хранилище Windows. Если Мастер настройки не сможет найти учетные данные или учетные данные будут иметь неверный формат, настройка не будет завершена и в файле журнала настройки будет зарегистрирована ошибка. Обратите внимание, что Мастер настройки не поддерживает добавление UPN пользователя или пароля в XML-файле конфигурации. Дополнительные сведения о добавлении учетных данных пользователя из скрипта команды в хранилище Windows см. в записи блога Для автоматической настройки клиента CRM для Outlook в CRM 2011 требуется доступная среда. Дополнительные сведения о хранилище и диспетчере учетных данных Windows см. в разделе Диспетчер учетных данных.

Пример XML-файла конфигурации CRM для Outlook для настройки

В следующем примере файла конфигурации выполняется настройка Dynamics CRM для Outlook для подключения к основной организации с именем Contoso и другой организации с именем AdventureWorksCycle на сервере Сервер Microsoft Dynamics CRM с именем crmserver.

Примечание

Можно использовать один и файл, содержащий как элементы установки, так и элементы настройки.Установка и Мастер настройки будут игнорировать элементы, не относящиеся к операции.

Пример файла Default_Client_Config.xml

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

Примечание

В предыдущем примере представлены две различные организации, к которым имеет доступ пользователь, и приложение Dynamics CRM для Outlook настроена на отображение баннера уведомления "Я хочу участвовать в программе улучшения качества ПО". Значение в элементе Organization не может содержать специальные символы или пробелы. При использовании Microsoft Dynamics CRM (локальная версия) уникальное имя организации можно найти, запустив командлет Get-CrmOrganization Windows PowerShell или просмотрев столбец Имя в области Организации в Управление развертыванием.

Настройка CRM для Outlook с помощью скрипта

  1. Создайте скрипт для автоматического обновления параметров конфигурации для пользователей Dynamics CRM для 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://contoso.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 – пользователи и компьютеры (ADUC) или объектов групповой политики (GPO).

См. также

Настройка CRM для Outlook
Install Microsoft Dynamics CRM Server by using a command prompt
CRM для Outlook

© Корпорация Майкрософт (Microsoft Corporation), 2016. Все права защищены. Авторские права