Installation von Microsoft Dynamics 365 for Outlook über die Eingabeaufforderung

  • Artikel

Die Installation von Microsoft Dynamics 365 for Outlook umfasst zwei Schritte. Zunächst müssen Sie Setup ausführen, um die Dateien auf dem Computer zu installieren. Führen Sie als Nächstes den Konfigurations-Assistenten für Dynamics 365 for Customer Engagement aus, um die Anwendung zu konfigurieren und die Installation abzuschließen.

Wichtig

Tritt ein Konflikt zwischen einem Wert in der Konfigurationsdatei und einem Wert in den Befehlszeilenparametern auf, hat der Befehlszeilenparameter Vorrang.

Schritt 1: Installieren der Dateien

Notiz

Siehe Installation von Dynamics 365 for Outlook für Download-Anweisungen.

Der folgende Befehl zeigt die verfügbaren Optionen zum Ausführen des Setups von Microsoft Dynamics CRM for Outlook an der Eingabeaufforderung an:

Setupclient.exe [/A] [/Q] [/X] [/L oder /LV "[Laufwerk:][[ Pfad] logfilename.log]"] [/targetdir "[Laufwerk:][ Pfad]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Beispielbefehle für eine Konfiguration von Dynamics 365 for Outlook Installation

Benutzer, die unterwegs sind oder die nicht immer mit dem Dynamics 365 Server verbunden sind, haben mit Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff Zugriff auf ihre Kundendaten. Gehen Sie wie folgt vor, um Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff im stillen Modus zu installieren:

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

Gehen Sie wie folgt vor, um Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff im stillen Modus zu deinstallieren:

SetupClient /x /q

Parameter für die Dynamics 365 for Outlook-Installation.

Parameter Beschreibung des Dataflows
Keine Bei der Verwendung ohne Parameter wird Setupclient.exe mit allen Bildschirmen ausgeführt.
installofflinecapability Legt fest, ob die Offlinefunktion installiert wird. Wenn Sie diesen Parameter einschließen, werden Offlinefunktion und -komponenten installiert. Wird dieser Parameter nicht angegeben, wird der reine Onlineclient installiert.
/targetdir <„drive:\path“> Gibt den Ordner an, in dem Dynamics 365 for Outlook-Dateien installiert werden.
/A Erstellt eine Administratorinstallation von Dynamics 365 for Outlook, indem ein Windows Installer-Paket erstellt wird. Mit diesem Paket können die Benutzer das Setup ausgehend von einer Netzwerkfreigabe ausführen. Alternativ können Benutzer ohne Administratorrolle das Setup basierend auf einer Gruppenrichtlinie aus ausführen. Dieser Parameter muss zusammen mit dem zuvor beschriebenen Parameter /targetdir verwendet werden. Bei der Verwendung dieses Parameters muss sich der Wert /targetdir nicht auf dem lokalen Computer befinden. Ein zugeordnetes Laufwerk oder eine Netzwerkfreigabe wie \\share\mscrm_client_admin kann verwendet werden. Wichtig: Falls Sie nicht mithilfe des Parameters /targetdir einen Zielordner angeben, installiert das Setup die Administratorinstallation im Standardordner <Laufwerk:> Program Files\Microsoft Dynamics CRM installiert.

Ein Beispiel hierfür ist der Befehl:

Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"
/Q Installation im stillen Modus. Dieser Parameter erfordert eine Konfigurationsdatei im XML-Format. Der /i-Parameter enthält den Namen der XML-Konfigurationsdatei. Auf dem Bildschirm werden keine Dialogfelder oder Fehlermeldungen angezeigt. Zum Erfassen von Fehlermeldungsinformationen muss der Protokolldateiparameter (/L oder /LV) angegeben werden.
/L [Laufwerk:][[Pfad] logfilename.log] Erstellt eine Protokolldatei mit Installationsaktivitäten. Sie müssen den Dateinamen der Protokolldatei und einen Pfad angeben. Der Pfad darf jedoch kein relativer Pfad sein, z. B. %appdata%\CRMLogs.
/LV [Laufwerk:][[Pfad] logfilename.log] Erstellt eine ausführliche Protokolldatei mit Installationsaktivitäten. Sie müssen den Dateinamen der Protokolldatei und einen Pfad angeben. Der Pfad darf jedoch kein relativer Pfad sein, z. B. %appdata%\CRMLogs.
disableofflinecapability Bei Angabe dieses Parameters wird Dynamics 365 for Outlook zum Ausblenden der Schaltfläche "Offline gehen" in der Anwendung konfiguriert. Mit dieser Schaltfläche können Benutzer mit der Offlinefunktion zu Dynamics 365 for Outlook wechseln.
ignoreofflinequeue Bei Angabe dieses Parameters werden beim Setup keine Elemente synchronisiert, die während der Aktualisierung in der Offlinewarteschlange verbleiben.
/X Deinstalliert Dynamics 365 for Outlook. Hierbei handelt es sich um eine Option des Wartungsmodus, die erst nach der Installation der Anwendung verfügbar ist.

Beispiel für eine Dynamics 365 for Outlook-XML-Konfigurationsdatei für die Installation

Mithilfe des folgenden Konfigurationsdateibeispiels wird Dynamics 365 for Outlook ohne Offlinezugriff im Ordner "Programme" installiert.

Notiz

Sie können Datei verwenden, die sowohl die Installations- als auch die Konfigurationselemente enthält. Das Setup und der Konfigurations-Assistent ignorieren die für den Vorgang nicht relevanten Elemente.

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

Schritt 2: Konfiguration von Dynamics 365 for Outlook mithilfe einer XML-Konfigurationsdatei

Nach der Installation von Dynamics 365 for Outlook müssen Sie die Anwendung konfigurieren. Sie können dies tun, indem Sie den Konfigurations-Assistenten für Dynamics 365 for Outlook bei der Eingabeaufforderung ausführen. Der Name der Konfigurations-Assistentendatei lautet Microsoft.Crm.Application.Outlook.ConfigWizard.exe und befindet sich im Ordner „Client\ConfigWizard“, in dem Dynamics 365 for Outlook installiert wurde. Der Standardordner lautet "C:\Programme\Microsoft Dynamics CRM".

Notiz

Die Anmeldeinformationen des Benutzers, der Dynamics 365 for Outlook ausführt, werden zur Authentifizierung von Dynamics 365 for Customer Engagement verwendet. Daher müssen Sie zum Ausführen einer stillen Dynamics 365 for Outlook-Konfiguration den Konfigurations-Assistenten im Kontext des Benutzers ausführen, z. B. durch Ausführung einer durch den Benutzer aufgerufenen Batchdatei oder als einmaliger Eintrag in einem Anmeldeskript. Weitere Informationen finden Sie unter Anmeldeinformationen des Benutzers sind erforderlich, wenn Sie den Konfigurations-Assistenten ausführen Informationen zum Bereitstellen von Dynamics 365 for Outlook mithilfe der Microsoft Gruppenrichtlinie finden Sie im Thema Bereitstellen von Microsoft Dynamics 365 for Outlook mithilfe von Gruppenrichtlinien.

Falls kein Pfad zur Konfigurationsdatei angegeben ist, sucht der Konfigurations-Assistent nach der Standardkonfigurationsdatei (default_client_config.xml) im nicht zwischengespeicherten Profilordner (%localappdata%\Microsoft\MSCRM\). Befindet sich die Datei nicht im nicht zwischengespeicherten Profilordner, sucht der Konfigurations-Assistent den Ordner im Installationsordner von Dynamics 365 for Outlook. Standardmäßig wird Dynamics 365 for Outlook im Ordner c:\program files\Microsoft Dynamics CRM installiert.

Befindet sich die Konfigurationsdatei im zwischengespeicherten Ordner, der von anderen Anwendungen (AppData\Roaming\Microsoft\MSCRM\) verwendet wird, wird sie nicht berücksichtigt.

Beispielbefehle für eine Konfiguration von Dynamics 365 for Outlook

Mit dem folgenden Befehl wird Microsoft Dynamics 365 for Outlook mit Offlinezugriff mithilfe der Datei config_client.xml im stillen Modus konfiguriert. Dabei wird die Protokolldatei clientinstall.log ausgegeben:

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

Der Konfigurationsparameter /Q für den stillen Modus erfordert eine Konfigurationsdatei im XML-Format. Auf dem Bildschirm werden keine Dialogfelder oder Fehlermeldungen angezeigt. Zum Erfassen von Fehlermeldungsinformationen muss der Protokolldateiparameter (/L) oder die ausführliche Protokollierung (/LV) angegeben werden.

Wichtig

Die gültigen Anmeldeinformationen des Benutzers, die im Windows-Tresor gespeichert sind, sind erforderlich, um den Konfigurations-Assistenten im stillen Modus auszuführen. Weitere Informationen: Anmeldeinformationen des Benutzers sind erforderlich, wenn Sie den Konfigurations-Assistenten ausführen

Der /i [drive:] [[Pfad] configfilename.xml]] Befehlszeilenparamter stellt Microsoft Dynamics CRM for Outlook die notwendigen Informationen zur Einrichtung bereit. Dabei handelt es sich um dieselben Informationen, die für jeden Installationsbildschirm erforderlich sind. Die XML-Elemente müssen in Englisch (USA) angegeben werden, und Sonderzeichen oder erweiterte Zeichen sind nicht zulässig. Eine XML-Konfigurationsdatei mit lokalisierten XML-Elementen kann nicht ordnungsgemäß ausgeführt werden. Es folgen eine Erläuterung der einzelnen XML-Elemente sowie eine XML-Beispieldatei:

Wird der /xa mit dem Parameter /q verwendet, werden alle Organisationen entfernt, die für Dynamics 365 for Outlook konfiguriert sind.

Der Parameter /R kann genutzt werden, um die Konfigurations-Assistent-Benutzeroberfläche zu unterdrücken und nur das Statusdialogfeldfeld anzuzeigen. Dieser Parameter erfordert eine gültige XMLSetup-Datei namens Default_Client_Config.xml, die sich im AppData- oder Clientinstallationsordner des lokalen Benutzers befinden muss.

Dynamics 365 for Outlook XML-Konfigurationsdatei-Elemente

Element Beschreibung des Dataflows
<Bereitstellungen></Bereitstellungen> Die Konfigurationsdatei muss eine gültige XML-Datei sein, die <Bereitstellung> als Stammelement verwendet.
<InstallOfflineCapability>true/false</InstallOfflineCapability> Gibt den Typ der Dynamics 365 for Outlook-Installation an. Wenn Sie true festlegen, wird Microsoft Dynamics 365 for Outlook mit der Offlinezugriffsfunktion installiert.
<TargetDir>drive:\path</TargetDirectory> Gibt den Ordner an, in dem Dynamics 365 for Outlook-Dateien installiert werden.
<Bereitstellung></Bereitstellung> Übergeordnetes Element für alle folgenden Elemente.
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> Gibt die URL für den Discovery Web Service von Dynamics 365 for Customer Engagement an.

Verwenden Sie für Dynamics 365 for Customer Engagement die gesamte Organisations-URL an, wie etwa https://orgname.crm.dynamics.com oder, je nach Ihrer Onlineumgebung und Ihrem Standort, die Suchdienst-URL im Formular https://disco.crm.dynamics.com. Eine Liste von URLs finden Sie unter MSDN: Suchdienst..
<FederatedAuthentication>true/false</FederatedAuthentication> Gibt an, ob verbundene Anmeldeinformationen (Azure Active Directory) für die Authentifizierung im Konfigurations-Assistenten verwendet werden. Wenn Sie false angeben, können Sie Anmeldeinformationen, wie beispielsweise user@contoso.onmicrosoft.com, verwenden.
<Organisationen></Organisationen> Dies ist das übergeordnete Element für das folgende <Organisation>-Element.
<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization> Gibt den Namen der Organisation an, mit der der Client eine Verbindung herstellt.

FriendlyName. Gibt einen anderen Anzeigenamen als den Organisationsnamen in Outlook an.

IsPrimary: Gibt die Organisation an, die als Synchronisierungsorganisation in Dynamics 365 for Outlook konfiguriert wird. Hinweis: BeiOrganizationName muss die Groß-/Kleinschreibung beachtet werden.
<CEIPNotification>true/false</CEIPNotification> Gibt an, ob Dynamics 365 for Outlook das Benachrichtigungsbanner "Ich möchte am Programm zur Verbesserung der Benutzerfreundlichkeit teilnehmen" anzeigt. Die Standardeinstellung ist true, und das Benachrichtigungsbanner wird angezeigt. Wenn Sie false angeben, wird das Benachrichtigungsbanner in Dynamics 365 for Outlook nicht angezeigt. Weitere Informationen: Microsoft-Programm zur Verbesserung der Benutzerfreundlichkeit

Anmeldeinformationen des Benutzers sind erforderlich, wenn Sie den Konfigurations-Assistenten ausführen

Für den Konfigurations-Assistenten sind Anmeldeinformationen des Benutzers erforderlich. Bei einer stillen Konfiguration unter Verwendung von /Q mit Microsoft.Crm.Application.Outlook.ConfigWizard.exe, sucht der Konfigurations-Assistent im Windows-Tresor nach den Anmeldeinformationen des Benutzers. Wenn der Konfigurations-Assistent die Anmeldeinformationen nicht findet oder die Anmeldeinformationen nicht das erforderliche Format aufweisen, wird die Konfiguration nicht abgeschlossen, und ein Fehler wird in der Konfigurationsprotokolldatei aufgezeichnet. Beachten Sie, dass der Konfigurations-Assistent nicht das Hinzufügen des Benutzer-UPN oder des Kennworts in der XML-Konfigurationsdatei unterstützt. Weitere Informationen zu Windows Vault und Anmeldeinformationsmanager finden Sie in Was ist der Anmeldeinformationsmanager?

Beispiel für eine Dynamics 365 for Outlook-XML-Konfigurationsdatei für die Konfiguration

Im folgenden Konfigurationsdateibeispiel wird Dynamics 365 for Outlook so konfiguriert, dass eine Verbindung zur primären Organisation Contoso und der Organisation AdventureWorksCycle auf dem Dynamics 365 Server mit dem Namen crmserver hergestellt wird.

Notiz

Sie können Datei verwenden, die sowohl die Installations- als auch die Konfigurationselemente enthält. Das Setup und der Konfigurations-Assistent ignorieren die für den Vorgang nicht relevanten Elemente.

Beispieldatei "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>

Notiz

Im vorangehenden Beispiel werden zwei unterschiedliche Organisationen festgelegt, für die der Benutzer Zugriff besitzt und Dynamics 365 for Outlook so konfiguriert, dass das Benachrichtigungsbanner "Ixch möchte an dem Programm zur Verbesserung der Benutzerfreundlichkeit teilnehmen" nicht angezeigt wird. Der Wert im Element Organization darf keine Sonder- oder Leerzeichen enthalten. In Customer Engagement (on-premises) finden Sie den eindeutigen Namen der Organisation, indem Sie das „Get-CrmOrganization Windows PowerShell“-Cmdlet ausführen oder zu Einstellungen>Anpassungen>Entwicklerressourcen gehen und unter Instanzreferenzinformationen den Eindeutigen Namen kopieren.

Konfigurieren von Dynamics 365 for Outlook mithilfe eines Skripts

  1. Schreiben Sie ein Skript, mit dem die Konfigurationseinstellungen für Benutzer von Dynamics 365 for Outlook automatisch aktualisiert werden. Sie können beispielsweise folgende Zeilen verwenden, um die grundlegenden Konfigurationsaktionen auf Basis einer neuen Konfigurationsdatei, die auf dem als <servername> bezeichneten Computer gespeichert ist, auszuführen.

    Im folgenden Skript wird die Standarddatei für die Clientkonfiguration überschrieben, zuvor konfigurierte Organisationen werden entfernt, Benutzeranmeldeinformationen werden Windows Vault hinzugefügt, und die neue Organisation wird installiert.

    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"

    Trinkgeld

    Sie können das Skript als Anmeldeskript ausführen oder erzwingen, dass das Skript zu einem bestimmten Zeitpunkt ausgeführt wird, beispielsweise mithilfe des Konfigurations-Managers von Microsoft System Center 2012.

    Sie können auch Erkennungslogik ins Skript aufnehmen, die ermittelt, ob der Clientcomputer bereits konfiguriert wurde. Sie können festlegen, dass in diesem Fall das Skript beendet wird, ohne dass eine Aktion ausgeführt wird.

    Beispieldatei "Default_Client_Config.xml"

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

  2. Führen Sie das Skript für alle Clientcomputer in der Organisation aus, deren Server geändert wurde. Das Skript kann auf verschiedene Arten ausgeführt werden, u. a. über die Registerkarte Profil des Dialogfelds für Benutzereigenschaften in Active Directory-Benutzer und -Computer (ADUC) oder über Gruppenrichtlinienobjekte (GPO).

Siehe auch

Installieren von Dynamics 365 for Outlook