Installer Microsoft Dynamics 365 pour Outlook à l'aide d'une invite de commande

 

Date de publication : février 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

La procédure d'installation de Microsoft Dynamics 365 pour Outlook comprend deux étapes. Vous devez tout d'abord exécuter l'installation de manière à installer les fichiers sur l'ordinateur, puis exécuter l'Assistant Configuration de Microsoft Dynamics 365 afin de configurer l'application et de terminer l'installation.

Important

En cas de conflit entre une valeur du fichier de configuration et une valeur des paramètres de ligne de commande, le paramètre de ligne de commande est prioritaire.

Contenu de la rubrique

Étape 1 : installation des fichiers

Étape 2 : configuration de Dynamics 365 pour Outlook à l'aide d'un fichier de configuration XML

Exemples de commandes pour la configuration de Dynamics 365 pour Outlook

Éléments du fichier de configuration XML de Dynamics 365 pour Outlook

Les informations d'identification sont nécessaires lorsque vous exécutez l'Assistant Configuration

Exemple de fichier de configuration XML pour la configuration de Dynamics 365 pour Outlook

Étape 1 : installation des fichiers

Notes

Voir Installer Dynamics 365 pour Outlook pour obtenir des instructions sur le téléchargement.

La commande suivante illustre les options disponibles pour exécuter le Programme d'installation de Microsoft Dynamics CRM pour Outlook via l'invite de commandes :

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

Exemples de commandes pour l'installation de Dynamics 365 pour Outlook

Pour les utilisateurs qui voyagent ou qui ne sont pas toujours connectés au serveur Microsoft Dynamics 365 Server, Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion leur permet d'accéder à leurs données clients. Pour installer Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion en mode silencieux :

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

Pour désinstaller Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion en mode silencieux :

SetupClient /x /q

Paramètres pour l'installation de Dynamics 365 pour Outlook

Paramètre

Description

Aucune

Utilisé sans paramètres, Setupclient.exe s'exécute avec tous les écrans d'affichage.

installofflinecapability

Détermine si le mode hors connexion doit être installé. Si ce paramètre est spécifié, le mode hors connexion et ses composants sont installés ; s'il ne l'est pas, seul le client en ligne est installé.

/targetdir <"drive:\path">

Spécifie le dossier dans lequel les fichiers Dynamics 365 pour Outlook seront installés.

/A

Crée une installation administrative de Dynamics 365 pour Outlook en créant un package Windows Installer. Ce package permet aux utilisateurs d'exécuter Installation à partir d'un partage réseau et aux utilisateurs non-administrateurs d'exécuter Installation piloté à partir d'une stratégie de groupe. Ce paramètre doit être utilisé avec le paramètre /targetdir décrit plus haut. Si ce paramètre est utilisé, la valeur /targetdir ne doit pas nécessairement se trouver sur l'ordinateur local. Un lecteur mappé ou un partage réseau, comme \\share\mscrm_client_admin, peut être utilisé.

Important

Si vous ne spécifiez pas de dossier cible à l'aide du paramètre /targetdir, le programme d'Installation réalise l'installation administrative dans le dossier par défaut <lecteur:> Program Files\Microsoft Dynamics CRM.

Exemple de commande :

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

/Q

Installation en mode silencieux. Ce paramètre nécessite un fichier de configuration au format XML. Le paramètre /i contient le nom du fichier de configuration XML. Aucune boîte de dialogue ni aucun message d'erreur ne s'affiche à l'écran. Pour capturer les informations sur les messages d'erreur, indiquez le paramètre de fichier journal (/L ou /LV).

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

Crée un fichier journal de l'activité d'installation. Vous devez spécifier le nom du fichier journal et son emplacement, mais le chemin d'accès ne peut pas être relatif, comme %appdata%\CRMLogs.

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

Crée un fichier journal détaillé de l'activité d'installation. Vous devez spécifier le nom du fichier journal et son emplacement, mais le chemin d'accès ne peut pas être relatif, comme %appdata%\CRMLogs.

disableofflinecapability

Lorsque ce paramètre est spécifié, Dynamics 365 pour Outlook est configuré de manière à masquer le bouton Mode hors connexion dans l'application. Ce bouton permet aux utilisateurs de basculer vers Dynamics 365 pour Outlook avec le mode hors connexion.

ignoreofflinequeue

Lorsque ce paramètre est spécifié, le Installation n'essaie pas de synchroniser les éléments susceptibles de rester dans la file d'attente hors connexion au cours de la mise à niveau.

/X

Désinstalle Dynamics 365 pour Outlook. Il s'agit d'une option du mode maintenance disponible uniquement lorsque l'application est déjà installée.

Exemple de fichier de configuration XML pour l'installation de Dynamics 365 pour Outlook

L'exemple de fichier de configuration suivant installe Dynamics 365 pour Outlook sans fonctionnalité d'accès en mode hors connexion dans le dossier Program Files.

Notes

Vous pouvez utiliser le même fichier de configuration dans la mesure où il regroupe les éléments d'installation et les éléments de configuration. Le programme d'Installation et l'Assistant Configuration ignorent les éléments qui ne sont pas pertinents pour l'opération.

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

Étape 2 : configuration de Dynamics 365 pour Outlook à l'aide d'un fichier de configuration XML

Après avoir installé Dynamics 365 pour Outlook, vous devez le configurer. Pour ce faire, vous pouvez exécuter l'Assistant Configuration de Dynamics 365 pour Outlook à l'invite de commandes. Le fichier de l'Assistant Configuration est nommé Microsoft.Crm.Application.Outlook.ConfigWizard.exe et se trouve dans le dossier Client\ConfigWizard dans lequel Dynamics 365 pour Outlook est installé. L'emplacement par défaut du dossier est C:\Program Files\Microsoft Dynamics CRM.

Notes

Les informations d'identification de l'utilisateur qui exécutera Dynamics 365 pour Outlook sont utilisées pour l'authentification dans Microsoft Dynamics 365. Par conséquent, pour effectuer une configuration silencieuse de Dynamics 365 pour Outlook, vous devez exécuter l'Assistant Configuration dans le contexte de l'utilisateur, par exemple en exécutant un fichier de commandes appelé par l'utilisateur ou en tant qu'entrée unique dans un script d'ouverture de session. Pour plus d'informations, voir Les informations d'identification sont nécessaires lorsque vous exécutez l'Assistant Configuration. Pour déployer Dynamics 365 pour Outlook à l'aide d'une stratégie de groupe Microsoft, consultez la rubrique Déployer Microsoft Dynamics 365 pour Outlook à l’aide d'une stratégie de groupe.

Si aucun chemin d'accès au fichier de configuration n'est spécifié, l'Assistant Configuration recherche le fichier de configuration par défaut (default_client_config.xml) dans le dossier de profil non itinérant (%localappdata%\Microsoft\MSCRM\. Si le fichier ne se trouve pas dans ce dossier, l'Assistant Configuration le recherche dans le dossier d'installation de Dynamics 365 pour Outlook. Par défaut, Dynamics 365 pour Outlook est installé dans le dossier C:\Program Files\Microsoft Dynamics CRM.

Si le fichier de configuration se trouve à l'emplacement itinérant utilisé par d'autres applications (AppData\Roaming\Microsoft\MSCRM\), il ne sera pas utilisé.

Exemples de commandes pour la configuration de Dynamics 365 pour Outlook

La commande suivante configure Microsoft Dynamics 365 pour Outlook avec accès hors connexion à l'aide d'un fichier nommé config_client.xml en mode silencieux et génère en sortie un fichier journal appelé clientinstall.log:

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

Le paramètre de configuration du mode silencieux /Q nécessite un fichier de configuration au format XML. Aucune boîte de dialogue ni aucun message d'erreur ne s'affiche à l'écran. Pour capturer les informations de message d'erreur, incluez le paramètre de fichier journal (/L) ou de journalisation détaillée (/LV).

Important

Les informations d'identification valide stockées dans le coffre Windows sont nécessaires pour exécuter l'Assistant Configuration en mode silencieux.Pour plus d'informations :Les informations d'identification sont nécessaires lorsque vous exécutez l'Assistant Configuration

Le paramètre de ligne de commande /i [drive:] [[path] configfilename.xml]] fournit à Programme d'installation de Microsoft Dynamics CRM pour Outlook les informations requises. Chaque écran d'installation a besoin de ces mêmes informations. Les éléments XML doivent être en anglais (U.S), et les caractères spéciaux ou étendus ne peuvent pas être utilisés. Un fichier de configuration XML comprenant des éléments XML localisés ne fonctionnera pas correctement. Chaque élément XML est décrit ci-dessous. Un exemple de fichier XML est également fourni :

Le paramètre /xa, lorsqu'il est utilisé avec le paramètre /q, supprime toutes les organisations configurées pour Dynamics 365 pour Outlook.

Le paramètre /R peut être utilisé pour supprimer l'interface utilisateur de Assistant Configuration et pour afficher seulement la boîte de dialogue de progression. Ce paramètre requiert un fichier d'InstallationXML valide nommé Default_Client_Config.xml et doit être situé dans le dossier AppData ou Installation Client de l'utilisateur local.

Éléments du fichier de configuration XML de Dynamics 365 pour Outlook

Élément

Description

<Deployments> </Deployments>

Le fichier de configuration doit être un fichier XML valide, utilisant <Deployment> comme élément racine.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Spécifie le type d'installation de Dynamics 365 pour Outlook. En spécifiant true, vous installez la fonction Microsoft Dynamics 365 pour Outlook avec accès hors connexion.

<TargetDir>drive:\path</TargetDirectory>

Spécifie le dossier dans lequel les fichiers Dynamics 365 pour Outlook seront installés.

<Deployment> </Deployment>

Élément parent de tous les éléments suivants.

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

Spécifie l'URL pour le Service Web de découverteMicrosoft Dynamics 365.

Pour un déploiement local de Microsoft Dynamics 365 Server, la liaison prise en charge peut être HTTPS ou HTTP. Si le Service Web de découverte utilise un port autre que les ports par défaut 80 (HTTP) ou 443 (HTTPS), vous devez spécifier le numéro de port. S'il s'agit d'un déploiement serveur complet de Microsoft Dynamics 365 Server, l'URL du Service Web de découverte est la même que celle de l'application Web, comme http://crmserver.

Pour Microsoft Dynamics 365 (Online), utilisez l'URL complète de l'organisation, telle que https://orgname.crm.dynamics.com, ou en fonction de votre environnement et lieu, utilisez l'URL du service de découverte, sous la forme https://disco.crm.dynamics.com. Pour une liste d'URLs, voir MSDN : service de découverte.

<FederatedAuthentication>true/false</FederatedAuthentication>

Spécifie si les informations d'identification fédérées (Azure Active Directory) sont utilisées pour l'authentification dans Assistant Configuration. Si vous spécifiez false, vous pouvez utiliser des informations d'identification comme user@contoso.onmicrosoft.com.

<Organizations> </Organizations>

Il s'agit de l'élément parent de l'élément <Organization> suivant.

<Organization FriendlyName="Nom convivial de l'organisation" IsPrimary="true"/"false">OrganizationName</Organization>

Spécifie le nom de l'organisation auquel le client se connectera.

FriendlyName. Spécifie un autre nom d'affichage que celui de l'organisation dans Outlook.

IsPrimary. Spécifie l'organisation qui sera configurée en tant qu'organisation de synchronisation dans Dynamics 365 pour Outlook.

Notes

OrganizationName respecte la casse.

<CEIPNotification>true/false</CEIPNotification>

Spécifie si Dynamics 365 pour Outlook affiche la bannière de notification « Je veux participer au Programme d'amélioration du produit ». Le paramètre par défaut est true et la bannière de notification s'affiche. Si vous spécifiez la valeur false, la bannière de notification n'apparaît pas dans Dynamics 365 pour Outlook.Pour plus d'informations :Programme d'amélioration du produit Microsoft

Les informations d'identification sont nécessaires lorsque vous exécutez l'Assistant Configuration

L'Assistant Configuration requiert les informations d'identification. Pendant une configuration silencieuse, via /Q avec le fichier Microsoft.Crm.Application.Outlook.ConfigWizard.exe, l'Assistant Configuration recherchera les informations d'identification de l'utilisateur dans le coffre Windows. Si l'Assistant Configuration ne parvient pas à trouver les informations d'identification, ou si les informations d'identification ne sont pas au format requis, la configuration ne finit pas et une erreur est enregistrée dans le fichier journal de configuration. Notez que l'Assistant Configuration ne prend pas en charge l'ajout du nom d'utilisateur principal (UPN) ou du mot de passe de l'utilisateur dans le fichier de configuration XML. Pour plus d'informations sur l'ajout des informations d'identification de l'utilisateur depuis un script de commande au coffre Windows, consultez le billet de blog La configuration silencieuse du client CRM pour Outlook dans l'environnement à revendications de CRM 2011. Pour plus d'informations sur le coffre Windows et le Gestionnaire d'informations d'identification, voir Qu'est-ce que le Gestionnaire d'informations d'identification

Exemple de fichier de configuration XML pour la configuration de Dynamics 365 pour Outlook

L'exemple de fichier de configuration suivant permet de configurer Dynamics 365 pour Outlook de sorte qu'il se connecte à une organisation principale nommée Contoso et à une autre organisation nommée AdventureWorksCycle sur le serveur Microsoft Dynamics 365 Server nommé crmserver.

Notes

Vous pouvez utiliser le même fichier de configuration dans la mesure où il regroupe les éléments d'installation et les éléments de configuration. Le programme d'Installation et l'Assistant Configuration ignorent les éléments qui ne sont pas pertinents pour l'opération.

Exemple de fichier 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>

Notes

L'exemple précédent spécifie deux organisations distinctes auxquelles l'utilisateur a accès et configure Dynamics 365 pour Outlook pour ne pas afficher la bannière de notification « Je veux participer au Programme d'amélioration du produit ». La valeur de l'élément Organization ne doit contenir ni caractères spéciaux ni espaces. Pour Dynamics 365 (local), vous pouvez identifier le nom unique de l'organisation en exécutant l'applet de commande Get-CrmOrganization de Windows PowerShell. Ou bien, accédez à Paramètres > Personnalisations > Ressources du développeur et sous Informations de référence d'instance, copiez le Nom unique.

Configurer Dynamics 365 pour Outlook à l'aide d'un script

  1. Écrivez un script qui met automatiquement à jour les paramètres de configuration des utilisateurs de Dynamics 365 pour Outlook. Vous pouvez utiliser des lignes de script comme celles indiquées ci-dessous afin de réaliser les actions de configuration de base. Ce script utilise un nouveau fichier de configuration stocké sur l'ordinateur indiqué en tant que <servername>.

    Dans le script suivant, le fichier de configuration client par défaut est remplacé ; les organisations précédemment configurées sont supprimées, les informations d'identification sont ajoutées au coffre Windows et la nouvelle organisation est installée.

    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"
    

    Conseil

    Envisagez la possibilité d'exécuter votre script en tant que script d'ouverture de session ou de forcer le script à s'exécuter à une heure spécifique, par exemple, en utilisant Microsoft System Center 2012 Configuration Manager.

    Vous voudrez peut-être également inclure dans le script une logique de détection qui détermine si l'ordinateur client a déjà été configuré. S'il l'a déjà été, vous pouvez faire en sorte que le script quitte sans aucune intervention de votre part.

    Exemple de fichier Default_Client_Config.xml

    <Deployment>
    <DiscoveryUrl>http://CrmDiscoveryUrl</DiscoveryUrl>
    <Organizations>
    <Organization IsPrimary='true'>Organization1</Organization>
    </Organizations>
    </Deployment>
    
  2. Exécutez le script sur chaque ordinateur client de votre organisation dont le serveur a changé. Vous pouvez exécuter le script de différentes façons, y compris par le biais de l'onglet Profil de la boîte de dialogue de propriétés de l'utilisateur dans Utilisateurs et ordinateurs Active Directory (ADUC) ou via des objets de stratégie de groupe (GPO).

Voir aussi

Installer Dynamics 365 pour Outlook
Configurer Dynamics 365 pour Outlook
Installer Microsoft Dynamics CRM Server à l'aide d'une invite de commandes
Dynamics 365 pour Outlook

© 2017 Microsoft. Tous droits réservés. Copyright