Instalar Microsoft Dynamics 365 para Outlook utilizando un símbolo del sistema

  • Artículo

 

Publicado: febrero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

La instalación de Microsoft Dynamics 365 para Outlook es un procedimiento de dos pasos. En primer lugar, debe ejecutar el programa de instalación para instalar los archivos en el equipo. A continuación, ejecute el Microsoft Dynamics 365Asistente para configuración para configurar la aplicación y completar la instalación.

Importante

Si se produce algún conflicto entre un valor en el archivo de configuración y un valor en los parámetros de la línea de comandos, el parámetro de la línea de comandos tiene prioridad.

En este tema

Paso 1: Instalar archivos

Paso 2: Configure Dynamics 365 para Outlook mediante un archivo de configuración XML

Ejemplos de comandos de la configuración de Dynamics 365 para Outlook.

Elementos del archivo de configuración XML de Dynamics 365 para Outlook

Las credenciales de usuario son necesarias al ejecutar el asistente para configuración

Ejemplo de archivo de configuración XML de Dynamics 365 para Outlook para configuración

Paso 1: Instalar archivos

Nota

Consulte Instalar Dynamics 365 para Outlook para descargar las instrucciones.

El siguiente comando muestra las opciones disponibles para ejecutar Programa de instalación de Microsoft Dynamics CRM para Outlook en el símbolo del sistema:

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

Ejemplos de comandos de la instalación de Dynamics 365 para Outlook.

Para aquellos usuarios que viajan o que no están siempre conectados a Microsoft Dynamics 365 Server, Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión les proporciona acceso a los datos de los clientes. Para instalar Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión en modo silencioso:

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

Para desinstalar Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión en modo silencioso:

SetupClient /x /q

Parámetros de la instalación de Dynamics 365 para Outlook.

Parámetro

Descripción

Ninguno

Cuando se usa sin parámetros, Setupclient.exe se ejecuta con todas las pantallas.

installofflinecapability

Determina si se instalará la capacidad de trabajar sin conexión. Cuando se incluye este parámetro, se instalan la capacidad de trabajar sin conexión y los componentes. Si no se especifica el parámetro, se instala el cliente de trabajo solo en línea.

/targetdir <"drive:\path">

Especifica la carpeta en la que se instalarán los archivos de Dynamics 365 para Outlook.

/A

Crea una instalación administrativa de Dynamics 365 para Outlook mediante la creación de un paquete de Windows Installer. Este paquete permite que los usuarios ejecuten el Programa de instalación desde un recurso compartido de red o que los usuarios no administrativos ejecuten el Programa de instalación que se controla desde una directiva de grupo. Este parámetro se debe usar con el parámetro /targetdir descrito anteriormente. Cuando se usa este parámetro, el valor de /targetdir no tiene que estar ubicado en el equipo local. Puede usarse una unidad asignada o un recurso compartido de red, como \\recursoCompartido\mscrm_client_admin.

> [!IMPORTANT] >

Si no se especifica una carpeta de destino mediante el parámetro /targetdir, Programa de instalación realiza la instalación administrativa en la carpeta predeterminada <unidad:> Program Files\Microsoft Dynamics CRM.

Por ejemplo, el comando:

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

/Q

Instalación en modo silencioso. Este parámetro requiere un archivo de configuración en formato XML. El parámetro /i contiene el nombre del archivo de configuración XML. No aparecerá ningún cuadro de diálogo ni ningún mensaje de error en la pantalla. Para capturar la información de los mensajes de error, es necesario incluir un parámetro de archivo de registro (/L oLV).

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

Crea un archivo de registro de la actividad de instalación. Debe especificar el nombre del archivo de registro y la ubicación en que desea guardarlo, pero la ruta de acceso no puede ser una ruta de acceso relativa, como %appdata%\CRMLogs.

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

Crea un archivo de registro detallado de la actividad de instalación. Debe especificar el nombre del archivo de registro y la ubicación en que desea guardarlo, pero la ruta de acceso no puede ser una ruta de acceso relativa, como %appdata%\CRMLogs.

disableofflinecapability

Cuando se especifica este parámetro, se configura Dynamics 365 para Outlook para ocultar el botón "desconexión" en la aplicación. Este botón permite a los usuarios cambiar a Dynamics 365 para Outlook con capacidad de trabajar sin conexión.

ignoreofflinequeue

Cuando se especifica este parámetro, el Programa de instalación no intentará sincronizar elementos que puedan permanecer en la cola sin conexión durante la actualización.

/X

Desinstala el Dynamics 365 para Outlook. Ésta es una opción del modo de mantenimiento que solo está disponible cuando la aplicación ya está instalada.

Ejemplo de archivo de configuración de Dynamics 365 para Outlook XML para la instalación

El siguiente ejemplo de archivo de configuración instala Dynamics 365 para Outlook sin la capacidad de trabajar sin conexión en la carpeta de Archivos de programa.

Nota

Puede usar el mismo archivo que incluye ambos elementos, el de instalación y el de configuración. El Programa de instalación y el Asistente para configuración ignoran los elementos que no son relevantes para la operación.

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

Paso 2: Configure Dynamics 365 para Outlook mediante un archivo de configuración XML

Después de instalar Dynamics 365 para Outlook, debe configurarlo. Para ello, puede ejecutar el Dynamics 365 para OutlookAsistente para configuración en la línea de comandos. El archivo del Asistente para configuración se llama Microsoft.Crm.Application.Outlook.ConfigWizard.exe y está ubicado en la carpeta Client\ConfigWizard donde está instalado Dynamics 365 para Outlook. De forma predeterminada, la carpeta es C:\Program Files\Microsoft Dynamics CRM.

Nota

Las credenciales del usuario que ejecutará Dynamics 365 para Outlook se usan para realizar la autenticación en Microsoft Dynamics 365. Por lo tanto, para realizar una configuración silenciosa de Dynamics 365 para Outlook, debe ejecutar el Asistente para configuración en el contexto del usuario, ya sea ejecutando un archivo por lotes invocado por el usuario o como una entrada de una sola vez en un script de inicio de sesión. Para obtener más información, vea Las credenciales de usuario son necesarias al ejecutar el asistente para configuración. Para implementar Dynamics 365 para Outlook mediante la directiva de grupo de Microsoft, consulte Implementar Microsoft Dynamics 365 para Outlook mediante la directiva de grupo.

Si no se especifica la ruta de acceso del archivo de configuración, el Asistente para configuración busca el archivo de configuración predeterminado (default_client_config.xml) en la carpeta del perfil que no es móvil (%localappdata%\Microsoft\MSCRM\). Si el archivo no está ubicado en dicha carpeta, el Asistente para configuración busca la carpeta donde está instalado Dynamics 365 para Outlook. De forma predeterminada, Dynamics 365 para Outlook se instala en la carpeta C:\Program Files\Microsoft Dynamics CRM.

Si el archivo de configuración está ubicado en la ubicación móvil usada por otras aplicaciones (AppData\Roaming\Microsoft\MSCRM\), no se mantendrá.

Ejemplos de comandos de la configuración de Dynamics 365 para Outlook.

El siguiente comando configura Microsoft Dynamics 365 para Outlook con acceso sin conexión con un archivo llamado config_client.xml en modo silencioso y crea un archivo de registro llamado clientinstall.log:

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

El parámetro de configuración del modo silencioso /Q requiere un archivo de configuración en formato XML. No aparecerá ningún cuadro de diálogo ni ningún mensaje de error en la pantalla. Para capturar la información de los mensajes de error, incluya el parámetro de archivo de registro (/L) o de registro detallado (/LV).

Importante

Las credenciales de un usuario válido almacenadas en el almacén de credenciales de Windows deben ejecutar el Asistente para configuración en modo silencioso.Más información:Las credenciales de usuario son necesarias al ejecutar el asistente para configuración

El parámetro de línea de comando /i [unidad:] [[ruta] configfilename.xml]] proporciona a Programa de instalación de Microsoft Dynamics CRM para Outlook la información necesaria. Es la misma información que requiere cada pantalla de la instalación. Los elementos XML deben estar en inglés (Estados Unidos) y no pueden usarse caracteres especiales ni extendidos. Un archivo de configuración XML con elementos XML traducidos no funcionará correctamente. A continuación se ofrece una explicación de los elementos del archivo XML y un ejemplo de dicho archivo XML:

El parámetro /xa, cuando se usa con el parámetro /q, quita todas las organizaciones que están configuradas para Dynamics 365 para Outlook.

El parámetro /R se puede usar para eliminar la interfaz de usuario de Asistente para configuración y mostrar sólo el cuadro de diálogo de progreso. Este parámetro requiere un archivo XMLPrograma de instalación válido llamado Default_Client_Config.xml y debe estar ubicado en la carpeta de instalación del cliente o AppData del usuario local.

Elementos del archivo de configuración XML de Dynamics 365 para Outlook

Elemento

Descripción

<Deployments> </Deployments>

El archivo de configuración debe ser un archivo XML válido que use <Deployment> como elemento raíz.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Especifica el tipo de instalación de Dynamics 365 para Outlook. Si se especifica true, se instalará con funcionalidad de Microsoft Dynamics 365 para Outlook con acceso sin conexión.

<TargetDir>drive:\path</TargetDirectory>

Especifica la carpeta en la que se instalarán los archivos de Dynamics 365 para Outlook.

<Deployment> </Deployment>

Elemento principal de todos los elementos siguientes.

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

Especifica la dirección URL de Microsoft Dynamics 365Servicio web de detección .

Para una implementación local de Microsoft Dynamics 365 Server, el enlace admitido puede ser HTTPS o HTTP. Si el Servicio web de detección usa un puerto distinto que los puertos predeterminados 80 (HTTP) o 443 (HTTPS), deberá especificar el número de puerto. Si está realizando una implementación de servidor completo de Microsoft Dynamics 365 Server, la dirección URL del Servicio web de detección será la misma que la de la aplicación web, como por ejemplo http://crmserver.

Para Microsoft Dynamics 365 (online), use la dirección URL completa de la organización, como https://orgname.crm.dynamics.com o en función del entorno y la ubicación en línea, use la dirección URL del servicio de detección, con el formato https://disco.crm.dynamics.com. Para obtener una lista de URLs, consulte MSDN: Servicio de detección.

<FederatedAuthentication>true/false</FederatedAuthentication>

Especifica si las credenciales federadas (Azure Active Directory) se usan para la autenticación en Asistente para configuración. Si especifica false, puede usar credenciales como user@contoso.onmicrosoft.com.

<Organizations> </Organizations>

Es el elemento principal del siguiente elemento <Organization>.

<Organization FriendlyName="Nombre descriptivo de mi organización" IsPrimary="true"/"false">NombreOrganización</Organization>

Especifica el nombre de la organización a la que el cliente se conectará.

NombreDescriptivo. Especifica un nombre para mostrar distinto del nombre de la organización en Outlook.

IsPrimary. Especifica la organización que se configurará como la organización de sincronización en Dynamics 365 para Outlook.

> [!NOTE] >

NombreOrganización distingue mayúsculas de minúsculas.

<CEIPNotification>true/false</CEIPNotification>

Especifica si Dynamics 365 para Outlook mostrará el banner de notificación "Quiero participar en el Programa para la mejora de la experiencia del usuario". La configuración predeterminada es true y se muestra el banner de notificación. Si especifica false, el banner de notificación no aparece en Dynamics 365 para Outlook.Más información:Programa para la mejora de la experiencia del usuario de Microsoft

Las credenciales de usuario son necesarias al ejecutar el asistente para configuración

Asistente para configuración requiere credenciales del usuario. Durante una configuración silenciosa, si se usa /Q con el archivo Microsoft.Crm.Application.Outlook.ConfigWizard.exe, el Asistente para configuración buscará las credenciales de usuario en el almacén de credenciales de Windows. Si Asistente para configuración no encuentra las credenciales, o las credenciales no están en el formato necesario, configuración no acabará y se registrará un error en el archivo de registro de configuración. Observe que el Asistente para configuración no permite agregar el usuario UPN o la contraseña del archivo de configuración XML. Para obtener más información sobre cómo agregar las credenciales de usuario de un script de comando en el almacén de credenciales de Windows, vea la publicación Silent configuration of CRM for Outlook client in CRM 2011 claims enabled environment. Para obtener más información sobre el almacén de credenciales de Windows y el administrador de credenciales, consulte ¿Qué es el Administrador de credenciales?

Ejemplo de archivo de configuración XML de Dynamics 365 para Outlook para configuración

El siguiente archivo de configuración de ejemplo configura Dynamics 365 para Outlook para conectarse a una organización primaria llamada Contoso y a otra organización llamada AdventureWorksCycle en el Microsoft Dynamics 365 Server llamado crmserver.

Nota

Puede usar el mismo archivo que incluye ambos elementos, el de instalación y el de configuración. El Programa de instalación y el Asistente para configuración ignorarán los elementos que no son relevantes para la operación.

Ejemplo de archivo 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>

Nota

El ejemplo anterior especifica dos organizaciones diferentes a las que el usuario tiene acceso y configura Dynamics 365 para Outlook para mostrar el banner de notificación "Quiero participar en el Programa para la mejora de la experiencia del usuario". El valor en el elemento Organization no puede contener caracteres especiales ni espacios. Para Dynamics 365 (local), puede buscar el nombre único de la organización ejecutando el cmdlet de Windows PowerShell Get-CrmOrganization o ir a Configuración > Personalizaciones > Recursos de desarrollador y en Información de referencia de la instancia copiar el Nombre único.

Configure Dynamics 365 para Outlook mediante un script

  1. Escriba un script que de forma automática actualice los valores de configuración para los usuarios de Dynamics 365 para Outlook. Podría usar líneas como las que se incluyen a continuación para realizar acciones básicas de configuración, basado en un nuevo archivo de configuración almacenado en el equipo denominado <servername>.

    En el siguiente script, se sobrescribe el archivo de la configuración predeterminado del cliente, se quitan las organizaciones configuradas anteriormente, se agregan las credenciales de usuario al almacén de credenciales de Windows y se instala la nueva organización.

    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"

    Sugerencia

    Considere la opción de ejecutar el script como un script de inicio de sesión, o forzar que el script se ejecute a una determinada hora, así como usar Microsoft System Center 2012 Configuration Manager.

    Es posible que también quiera incluir en el script lógica de detección que determine si ya se ha configurado el equipo cliente. Si es así, puede hacer que el script finalice sin realizar ninguna acción.

    Ejemplo de archivo Default_Client_Config.xml

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

  2. Ejecute el script en cada equipo cliente en la organización cuyo servidor haya cambiado. Puede ejecutar el script de varias formas, incluido a través de la pestaña Perfil del cuadro de diálogo de propiedades del usuario en Usuarios y equipos de Active Directory (ADUC) o a través de objetos de directiva de grupos (GPO).

Ver también

Instalar Dynamics 365 para Outlook
Configurar Dynamics 365 para Outlook
Instalar Microsoft Dynamics CRM Server utilizando el símbolo del sistema
Dynamics 365 para Outlook

© 2017 Microsoft. Todos los derechos reservados. Copyright