Compartir a través de

Instalar Microsoft Dynamics 365 for Outlook mediante un símbolo del sistema

  • Artículo

La instalación de Microsoft Dynamics 365 for 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 asistente de configuración de Dynamics 365 for Customer Engagement 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.

Paso 1: Instalar archivos

Nota

Consulte Instalar Dynamics 365 for Outlook para descargar las instrucciones.

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

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

Ejemplos de comando para la instalación de Dynamics 365 for Outlook

Para aquellos usuarios que viajan o que no están siempre conectados a Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook con acceso sin conexión les proporciona acceso a los datos de los clientes. Para instalar Dynamics 365 for 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 Dynamics 365 for Microsoft Office Outlook con acceso sin conexión en modo silencioso:

SetupClient /x /q

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

Parámetro Description
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 for Outlook.
/A Crea una instalación administrativa de Dynamics 365 for Outlook mediante la creación de un paquete de Windows Installer. Este paquete permite que los usuarios ejecuten la instalación desde un recurso compartido de red o que los usuarios no administrativos ejecuten la 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 \\share\mscrm_client_admin. Importante: Si no especifica una carpeta de destino mediante el parámetro /targetdir, la instalación realiza la instalación administrativa en la carpeta predeterminada: <unidad:> Archivos de programa\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 [unidad:][[rutaDeAcceso] nombreDeArchivoDeRegistro.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 [unidad:][[rutaDeAcceso] nombreDeArchivoDeRegistro.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 for Outlook para ocultar el botón "desconexión" en la aplicación. Este botón permite a los usuarios cambiar a Dynamics 365 for Outlook con capacidad de trabajar sin conexión.
ignoreofflinequeue Cuando se especifica este parámetro, la instalación no intentará sincronizar elementos que puedan permanecer en la cola sin conexión durante la actualización.
/X Desinstala el Dynamics 365 for 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 XML de Dynamics 365 for Outlook para la instalación

El siguiente ejemplo de archivo de configuración instala Dynamics 365 for 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. La instalación y el asistente de 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: Configurar Dynamics 365 for Outlook mediante un archivo de configuración XML

Después de instalar Dynamics 365 for Outlook, debe configurarlo. Puede hacer esto ejecutando el asistente de configuración de Dynamics 365 for Outlook en el símbolo del sistema. El archivo del asistente de configuración se llama Microsoft.Crm.Application.Outlook.ConfigWizard.exe y está ubicado en la carpeta Client\ConfigWizard donde está instalado Dynamics 365 for Outlook. De forma predeterminada, la carpeta es C:\Program Files\Microsoft Dynamics CRM.

Nota

Las credenciales del usuario que ejecutará Dynamics 365 for Outlook se usan para realizar la autenticación en Dynamics 365 for Customer Engagement. Por lo tanto, para realizar una configuración silenciosa de Dynamics 365 for Outlook, debe ejecutar el asistente de 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 for Outlook mediante la directiva de grupo de Microsoft, vea Implementar Microsoft Dynamics 365 for Outlook para Outlook mediante la directiva de grupo.

Si no se especifica la ruta de acceso al archivo de configuración, el asistente de 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 de configuración busca la carpeta donde está instalado Dynamics 365 for Outlook. De forma predeterminada, Dynamics 365 for 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 liquidará.

Ejemplos de comandos de la configuración de Dynamics 365 for Outlook

El siguiente comando configura Microsoft Dynamics 365 for 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 de 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] nombreArchivoConfig.xml]]] proporciona al programa de instalación de Microsoft Dynamics CRM for 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:

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

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

Elemento de archivo de configuración XML Dynamics 365 for Outlook

Elemento Description
<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 for Outlook. Especificando true instalará Microsoft Dynamics 365 for Outlook con capacidad de acceso sin conexión.
<TargetDir>drive:\path</TargetDirectory> Especifica la carpeta en la que se instalarán los archivos de Dynamics 365 for Outlook.
<Deployment></Deployment> Elemento principal de todos los elementos siguientes.
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> Especifica la dirección URL del servicio web Discovery de Dynamics 365 for Customer Engagement.

Para Dynamics 365 for Customer Engagement, use la URL completa de la organización, como https://orgname.crm.dynamics.com, o según su conexión en línea ambiente y ubicación, use la URL del servicio de detección en el formulario https://disco.crm.dynamics.com. Para obtener una lista de direcciones URL, vea MSDN: Servicio de detección.
<FederatedAuthentication>true/false</FederatedAuthentication> Especifica si las credenciales federadas (Azure Active Directory) se usan para la autenticación en el asistente de configuración. Si especifica false, puede usar credenciales como user@contoso.onmicrosoft.com.
<Organizations></Organizations> Este es el elemento principal para el siguiente elemento <Organization>.
<Organization FriendlyName="Mi nombre descriptivo de la 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 for Outlook. Nota:NombreDeOrganización distingue mayúsculas de minúsculas.
<CEIPNotification>true/false</CEIPNotification> Especifica si Dynamics 365 for 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 for 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

Las credenciales de usuario son necesarias para ejecutar el asistente para configuración Durante una configuración silenciosa, si se usa /Q con el archivo Microsoft.Crm.Application.Outlook.ConfigWizard.exe, el asistente de configuración buscará las credenciales de usuario en el almacén de credenciales de Windows. Si el asistente de 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 de configuración no admite la adición del UPN de usuario o la contraseña en el archivo de configuración XML. 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?

Archivo de configuración XML de ejemplo de Dynamics 365 for Outlook para la configuración

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

Nota

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

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

Nota

El ejemplo anterior especifica dos organizaciones diferentes a las que el usuario tiene acceso y configura Dynamics 365 for 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 Customer Engagement (on-premises), 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.

Configurar Dynamics 365 for 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 for 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"

    Propina

    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 el Administrador de configuración de Microsoft System Center 2012.

    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>https://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 grupo (GPO).

Consulte también

Instalación de Dynamics 365 for Outlook