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

Dynamics CRM 2016
 

Опубликовано: Февраль 2017

Применимо к: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

System_CAPS_importantВажно

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

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

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

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

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

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

SetupClient /x /q

Параметр

Описание

Нет

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

installofflinecapability

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

/targetdir <"drive:\path">

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

/A

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

System_CAPS_importantВажно

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

ignoreofflinequeue

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

/X

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

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

System_CAPS_noteПримечание

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

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

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

System_CAPS_noteПримечание

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

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

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

Следующая команда настраивает 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).

System_CAPS_importantВажно

Для запуска Мастер настройки в тихом режиме необходимы допустимые учетные данные пользователя, хранящиеся в хранилище Windows.Дополнительные сведения:При запуске мастера настройки необходимы учетные данные пользователя

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

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

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

Элемент

Описание

<Deployments> </Deployments>

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

<InstallOfflineCapability>true/false</InstallOfflineCapability>

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

<TargetDir>drive:\path</TargetDirectory>

Определяет папку, в которую будут установлены файлы Dynamics 365 для 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-адрес Веб-служба обнаружения совпадает с URL-адресом веб-приложения, например http://сервер_CRM.

В случае Microsoft Dynamics 365 Online используйте полный 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>.

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

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

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

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

System_CAPS_noteПримечание

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

<CEIPNotification>true/false</CEIPNotification>

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

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

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

System_CAPS_noteПримечание

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

Пример файла 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>
System_CAPS_noteПримечание

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

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

  1. Создайте скрипт для автоматического обновления параметров конфигурации для пользователей Dynamics 365 для 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"
    
    System_CAPS_tipСовет

    Рассмотрите вариант запуска скрипта как скрипта входа в систему или задайте определенное время выполнения крипта, например с помощью Управление настройками 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).

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

Добавления сообщества

ДОБАВИТЬ
Показ: