Установите Microsoft Dynamics 365 for Outlook, используя командную строку
Установка Microsoft Dynamics 365 for Outlook выполняется за два шага. Сначала нужно запустить программу установку для установки файлов на компьютер. Затем запустите мастер настройки Dynamics 365 for Customer Engagement, чтобы настроить приложение и завершить установку.
Внимание
В случае конфликта между значением в файле конфигурации и значением в параметрах командной строки параметр командной строки имеет более высокий приоритет.
Шаг 1. Установка файлов
Заметка
Инструкции по загрузке см. в разделе Dynamics 365 for Outlook.
Следующая команда показывает доступные варианты для запуска настройки Microsoft Dynamics CRM for Outlook в командной строке:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Примеры команды для установки Dynamics 365 for Outlook
Для пользователей, которые находятся в поездке или не всегда подключены к Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook с доступом вне сети предоставляет доступ к данным клиента. Чтобы установить Dynamics 365 for Microsoft Office Outlook с доступом вне сети в автоматическом режиме:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
Чтобы удалить Dynamics 365 for Microsoft Office Outlook с доступом вне сети в автоматическом режиме:
SetupClient /x /q
Параметры установки Dynamics 365 for Outlook
| Параметр | Description |
|---|---|
| Нет | Используется без параметров, Setupclient.exe будет выполняться со всеми экранами просмотра. |
| installofflinecapability | Указывает, следует ли устанавливать возможность работы вне сети. При включении этого параметра устанавливаются режим работы вне сети и компоненты. Если этот параметр не указан, устанавливается только интерактивный клиент. |
| /targetdir <"диск:\путь"> | Определяет папку, в которую будут установлены файлы Dynamics 365 for Outlook. |
| /A | Создает административную установку Dynamics 365 for 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 365 for Outlook будет скрывать кнопку "Перейти в автономный режим" в приложении. Эта кнопка позволяет пользователям переключиться в Dynamics 365 for Outlook с возможностью работы вне сети. |
| ignoreofflinequeue | Если указать этот параметр, программа настройки не будет пытаться синхронизировать элементы, которые могут оставаться в автономной очереди, во время обновления. |
| /X | Удаление Dynamics 365 for Outlook. Это параметр режима обслуживания, который доступен, только когда приложение уже установлено. |
Пример XML-файла конфигурации Dynamics 365 for Outlook XML для установки
В следующем примере файла конфигурации выполняется установка Dynamics 365 for Outlook без возможности автономного доступа к папке Program Files.
Заметка
Можно использовать один и файл, содержащий как элементы установки, так и элементы настройки. Настройка и мастер настройки будут игнорировать элементы, не относящиеся к операции.
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
Шаг 2. Настройка Dynamics 365 for Outlook для 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, используются для проверки подлинности в Dynamics 365 for Customer Engagement. Поэтому, чтобы выполнить автоматическую настройку Dynamics 365 for Outlook, необходимо запустить мастер настройки в контексте пользователя, например выполнение вызванного пользователем пакетного файла или использование одноразовой записи в скрипте входа в систему. Дополнительные сведения см. в разделе При запуске мастера настройки необходимы учетные данные пользователя. Чтобы выполнить развертывание Dynamics 365 for Outlook с использованием групповой политики Майкрософт, см. раздел Развертывание Microsoft Dynamics 365 for Outlook для 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 for 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 for Outlook необходимые сведения. Это те же сведения, которые требуются на каждом экране установки. XML-элементы должны быть на английском языке (США); запрещается использовать специальные символы или расширенный набор символов. XML-файл конфигурации с локализованными XML-элементами будет работать неправильно. Описание каждого XML-элемента и пример XML-файла см. ниже.
Параметр /xa при использовании с параметром /q удаляет все организации, настроенные для Dynamics 365 for Outlook.
Параметр /R может использоваться для отмены применения пользовательского интерфейса мастера настройки и отображения лишь диалогового окна хода выполнения. Для этого параметра требуется действительный файл XMLSetup с именем Default_Client_Config.xml. Он должен быть расположен либо в папке AppData локального пользователя, либо в папке установки клиента.
Элементы XML-файла конфигурации Dynamics 365 for Outlook
| Элемент | Description |
|---|---|
| <Deployments></Deployments> | Файл конфигурации должен быть действительным XML-файлом, использующим <Deployment> как корневой элемент. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Указывает тип установки Dynamics 365 for Outlook. Если указать true, Microsoft Dynamics 365 for Outlook будет установлено с возможностью автономного доступа. |
| <TargetDir>диск:\путь</TargetDirectory> | Определяет папку, в которую будут установлены файлы Dynamics 365 for Outlook. |
| <Deployment></Deployment> | Родительский элемент для всех следующих элементов. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Указывает URL-адрес веб-службы обнаружения Dynamics 365 for Customer Engagement. Для Dynamics 365 for Customer Engagement используйте полный URL-адрес организации, например https://orgname.crm.dynamics.com, или, в зависимости от сетевой среды и положения, используйте URL-адрес службы обнаружения в форме https://disco.crm.dynamics.com. Список URL-адресов см. в разделе 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 for Outlook. Примечание.OrganizationName учитывает регистр. |
| <CEIPNotification>true/false</CEIPNotification> | Указывает, будет ли Dynamics 365 for Outlook отображать баннер уведомления "Я хочу участвовать в программе улучшения качества ПО". По умолчанию задано значение true и баннер уведомления отображается. Если указать значение false, баннер уведомления не будет отображаться в Dynamics 365 for Outlook. Дополнительные сведения: Программа улучшения качества программного обеспечения Майкрософт |
При запуске мастера настройки необходимы учетные данные пользователя
При запуске мастера настройки необходимы учетные данные пользователя. Во время автоматической настройки с помощью параметра /Q с файлом Microsoft.Crm.Application.Outlook.ConfigWizard.exe мастер настройки выполнит поиск учетных данных пользователя в хранилище Windows. Если мастер настройки не сможет найти учетные данные или учетные данные будут иметь неверный формат, настройка не будет завершена и в файле журнала настройки будет зарегистрирована ошибка. Обратите внимание, что мастер настройки не поддерживает добавление UPN пользователя или пароля в XML-файле конфигурации. Дополнительные сведения о хранилище и диспетчере учетных данных Windows см. в разделе Диспетчер учетных данных.
Пример XML-файла конфигурации Dynamics 365 for Outlook XML для конфигурации
В следующем примере файла конфигурации выполняется настройка Dynamics 365 for Outlook для подключения к основной организации с именем Contoso и другой организации с именем AdventureWorksCycle на сервере Dynamics 365 Server с именем crmserver.
Заметка
Можно использовать один и файл, содержащий как элементы установки, так и элементы настройки. Настройка и мастер настройки будут игнорировать элементы, не относящиеся к операции.
Пример файла Default_Client_Config.xml
<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
Заметка
В предыдущем примере представлены две различные организации, к которым имеет доступ пользователь, и приложение Dynamics 365 for Outlook настроена на отображение баннера уведомления "Я хочу участвовать в программе улучшения качества ПО". Значение в элементе Organization не может содержать специальные символы или пробелы. В Customer Engagement (on-premises) уникальное имя организации можно найти, запустив командлет Windows PowerShell Get-CrmOrganization или перейдя в раздел Параметры>Настройки>Ресурсы для разработчиков и в разделе Справочная информация экземпляра скопировав Уникальное имя.
Настройка Dynamics 365 for Outlook с помощью скриптов
Создайте скрипт для автоматического обновления параметров конфигурации для пользователей 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>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>Выполните скрипт на каждом клиентском компьютере в организации, сервер которой был изменен. Выполнить скрипт можно различными способами, в том числе с помощью вкладки Профиль диалогового окна настроек пользователя в "Active Directory – пользователи и компьютеры" (ADUC) или объектов групповой политики (GPO).