Instalar Microsoft Dynamics CRM para Outlook utilizando un símbolo del sistema
Publicado: julio de 2016
Se aplica a: Dynamics CRM 2015
La instalación de Microsoft Dynamics CRM 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 CRMAsistente 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 CRM para Outlook mediante un archivo de configuración XML
Ejemplos de comandos de la configuración de CRM para Outlook
Elementos del archivo de configuración XML de CRM para Outlook
Las credenciales de usuario son necesarias al ejecutar el asistente para configuración
Ejemplo de archivo de configuración XML de CRM para Outlook para la configuración
Paso 1: Instalar archivos
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 or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Ejemplos de comandos de la instalación de CRM para Outlook
Para aquellos usuarios que viajan o que no están siempre conectados a Microsoft Dynamics CRM Server, Microsoft Dynamics CRM para Microsoft Office Outlook con acceso sin conexión les proporciona acceso a los datos de los clientes. Para instalar Microsoft Dynamics CRM 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 CRM para Microsoft Office Outlook con acceso sin conexión en modo silencioso:
SetupClient /x /q
Parámetros de la instalación de CRM para Outlook
Parámetro |
Descripción |
---|---|
Ninguna |
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 CRM para Outlook. |
/A |
Crea una instalación administrativa de Dynamics CRM 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. Importante 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:
|
/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 CRM para Outlook para ocultar el botón "desconexión" en la aplicación. Este botón permite a los usuarios cambiar a Dynamics CRM 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 CRM 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 XML de CRM para Outlook para la instalación
El siguiente ejemplo de archivo de configuración instala Dynamics CRM 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 CRM para Outlook mediante un archivo de configuración XML
Después de instalar Dynamics CRM para Outlook, debe configurarlo. Para ello, puede ejecutar el Dynamics CRM 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 CRM para Outlook. De forma predeterminada, la carpeta es C:\Program Files\Microsoft Dynamics CRM.
Nota
Las credenciales del usuario que ejecutará Dynamics CRM para Outlook se usan para realizar la autenticación en Microsoft Dynamics CRM. Por lo tanto, para realizar una configuración silenciosa de Dynamics CRM 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 CRM para Outlook mediante la directiva de grupo de Microsoft, consulte Implementar Microsoft Dynamics CRM 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 CRM para Outlook. De forma predeterminada, Dynamics CRM 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 CRM para Outlook
El siguiente comando configura Microsoft Dynamics CRM 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:] [[rutaDeAcceso] nombreArchivoConfig.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 CRM 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 CRM 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 CRM para Outlook. Si se especifica true, se instalará con funcionalidad de Microsoft Dynamics CRM para Outlook con acceso sin conexión. |
<TargetDir>drive:\path</TargetDirectory> |
Especifica la carpeta en la que se instalarán los archivos de Dynamics CRM para Outlook. |
<Deployment> </Deployment> |
Elemento principal de todos los elementos siguientes. |
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> |
Especifica la dirección URL de Microsoft Dynamics CRMServicio web de detección . Para una implementación local de Microsoft Dynamics CRM 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 CRM 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 CRM 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. |
<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 CRM para Outlook. Nota NombreOrganización distingue mayúsculas de minúsculas. |
<CEIPNotification>true/false</CEIPNotification> |
Especifica si Dynamics CRM 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 CRM 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 CRM para Outlook para la configuración
El siguiente archivo de configuración de ejemplo configura Dynamics CRM para Outlook para conectarse a una organización primaria llamada Contoso y a otra organización llamada AdventureWorksCycle en el Microsoft Dynamics CRM 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'>Constoso</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 CRM 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 Microsoft Dynamics CRM (local), puede buscar el nombre único de la organización ejecutando el cmdlet Get-CrmOrganization Windows PowerShell o en la columna Nombre en el área Organizaciones de Administrador de implementaciones.
Configure CRM para Outlook mediante un script
Escriba un script que de forma automática actualice los valores de configuración para los usuarios de Dynamics CRM 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://contoso.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>
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
Configurar CRM para Outlook
Instalar Microsoft Dynamics CRM Server utilizando el símbolo del sistema
CRM para Outlook
© 2016 Microsoft Corporation. Todos los derechos reservados. Copyright