Partager via

Installer Microsoft Dynamics 365 for Outlook à l’aide d’une invite de commandes

  • Article

La procédure d’installation de Microsoft Dynamics 365 for Outlook comprend deux étapes. Vous devez tout d’abord exécuter l’installation de manière à installer les fichiers sur l’ordinateur, Ensuite, exécutez l’Assistant Configuration de Dynamics 365 for Customer Engagement pour configurer l’application et 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.

Étape 1 : installation des fichiers

Note

Voir Installer Dynamics 365 for 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 for 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 for Outlook

Pour les utilisateurs en déplacement ou qui ne sont pas toujours connectés à Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook avec accès hors connexion leur permet d’accéder à leurs données client. Pour installer Dynamics 365 for 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 Dynamics 365 for Microsoft Office Outlook avec accès hors connexion en mode silencieux :

SetupClient /x /q

Paramètres pour l’installation de Dynamics 365 for 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 <"lecteur:\chemin d’accès"> Spécifie le dossier dans lequel les fichiers Dynamics 365 for Outlook seront installés.
/A Crée une installation administrative de Dynamics 365 for Outlook en créant un package Windows Installer. Ce package permet aux utilisateurs d’exécuter le programme d’installation à partir d’un partage réseau ou aux utilisateurs non-administrateurs d’exécuter le programme d’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 installe l’installation administrative dans le dossier <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 [lecteur:][[chemin] 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 [lecteur:][[chemin] 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 for 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 for Outlook avec le mode hors connexion.
ignoreofflinequeue Lorsque ce paramètre est spécifié, le programme d’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 for 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 for Outlook

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

Note

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 : configurer Dynamics 365 for Outlook à l’aide d’un fichier de configuration XML

Après avoir installé Dynamics 365 for Outlook, vous devez le configurer. Pour cela, exécutez l’Assistant Configuration de Dynamics 365 for Outlook sur 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 l’emplacement d’installation de Dynamics 365 for Outlook. Par défaut, ce dossier est C:\Program Files\Microsoft Dynamics CRM.

Note

Les informations d’identification de l’utilisateur qui exécute Dynamics 365 for Outlook sont utilisées pour l’authentification dans Dynamics 365 for Customer Engagement. Par conséquent, pour effectuer une configuration silencieuse de Dynamics 365 for 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 for Outlook à l’aide d’une stratégie de groupe Microsoft, voir Déployer Microsoft Dynamics 365 for 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 for Outlook. Par défaut, Dynamics 365 for 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 for Outlook

La commande suivante configure Microsoft Dynamics 365 for 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 valides stockées dans le coffre Windows sont nécessaires pour exécuter l’Assistant Configuration en mode silencieux. 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 au programme d’installation de Microsoft Dynamics CRM for Outlook les informations requises. Chaque écran d’installation a besoin de ces mêmes informations. Les éléments XML doivent être en anglais (US). et les caractères spéciaux et é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 for Outlook.

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

Éléments de fichier de configuration XML pour Dynamics 365 for 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 for Outlook. En précisant true, Microsoft Dynamics 365 for Outlook est installé avec la capacité d’accès hors connexion.
<TargetDir>lecteur:\chemin d’accès</TargetDirectory> Spécifie le dossier dans lequel les fichiers Dynamics 365 for Outlook seront installés.
<Deployment></Deployment> Élément parent de tous les éléments suivants.
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> Spécifie l’URL du service Web de découverte de Dynamics 365 for Customer Engagement.

Pour Dynamics 365 for Customer Engagement, utilisez l’URL complète de l’organisation, telle que https://orgname.crm.dynamics.com, ou en fonction de votre environnement en ligne et de votre emplacement, utilisez l’URL du service de découverte, dans le formulaire https://disco.crm.dynamics.com. Pour une liste d’URL, 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 l’Assistant Configuration. Si vous spécifiez false, vous pouvez utiliser des informations d’identification telles que 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 mon 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 for Outlook. Remarque :OrganizationName respecte la casse.
<CEIPNotification>true/false</CEIPNotification> Spécifie si Dynamics 365 for 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 for Outlook. 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 a besoin des informations d’identification. Pendant une configuration silencieuse, via /Q avec le fichier Microsoft.Crm.Application.Outlook.ConfigWizard.exe, l’Assistant Configuration recherche 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 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 Dynamics 365 for Outlook

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

Note

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>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>

Note

L’exemple précédent spécifie deux organisations distinctes auxquelles l’utilisateur a accès et configure Dynamics 365 for 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 Customer Engagement (on-premises), vous pouvez identifier le nom unique de l’organisation en exécutant l’applet de commande Windows PowerShell Get-CrmOrganization. Sinon, 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 for Outlook à l’aide d’un script

  1. Écrivez un script qui met automatiquement à jour les paramètres de configuration des utilisateurs de Dynamics 365 for 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"

    Pourboire

    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 l’Assistant Configuration de Microsoft System Center 2012.

    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>https://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 des 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 for Outlook