Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Установка 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
| Параметр | Описание |
|---|---|
| None | Используется без параметров, Setupclient.exe будет выполняться со всеми экранами просмотра. |
| Возможность установки в автономном режиме | Указывает, следует ли устанавливать возможность работы вне сети. При включении этого параметра устанавливаются режим работы вне сети и компоненты. Если этот параметр не указан, устанавливается только интерактивный клиент. |
| /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 для установки
В следующем примере файла конфигурации выполняется установка 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 с помощью 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 с помощью групповой политики.
Если путь к файлу конфигурации не указан, мастер настройки ищет конфигурации по умолчанию (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
| Элемент | Описание |
|---|---|
| <Deployments></Deployments> | Файл конфигурации должен быть действительным XML-файлом, в котором <Deployment> является корневым элементом. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Указывает тип установки Dynamics 365 for Outlook. Если указать true, устанавливается Microsoft Dynamics 365 for Outlook с доступом вне сети. |
| <TargetDir>drive:\path</TargetDirectory> | Определяет папку, в которую будут установлены файлы Dynamics 365 for Outlook. |
| <Развертывание></Развертывание> | Родительский элемент для всех следующих элементов. |
| <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. |
| <Организации></Организации> | Это родительский элемент для следующего элемента <Organization>. |
| <Organization FriendlyName="Понятное имя моей организации" IsPrimary="true"/"false">OrganizationName</Organization> | Указывает имя организации, к которой подключается клиент. Дружественное имя. Указывает другое отображаемое имя, отличной от имени организации в 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 для настройки
В следующем примере файла конфигурации выполняется настройка 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) уникальное имя организации можно найти, запустив командлет Get-CrmOrganization Windows PowerShell или выбрав Параметры>Настройки>Ресурсы для разработчиков и в раздел Справочная информация экземпляра скопировав Уникальное имя.
Настройка 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).