Installation von Microsoft Dynamics 365 für Outlook über die Eingabeaufforderung

 

Veröffentlicht: Februar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Die Installation von Microsoft Dynamics 365 für Outlook umfasst zwei Schritte. Zunächst müssen Sie Setup ausführen, um die Dateien auf dem Computer zu installieren. Führen Sie anschließend den Microsoft Dynamics 365Konfigurations-Assistent 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.

In diesem Thema

Schritt 1: Installieren der Dateien

Schritt 2: Konfigurieren von Dynamics 365 für Outlook mithilfe einer XML-Konfigurationsdatei

Beispielbefehle für die Konfiguration von Dynamics 365 für Outlook

XML-Konfigurationsdateielemente für Dynamics 365 für Outlook

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

Beispiel-XML-Konfigurationsdatei für Dynamics 365 für Outlook zur Konfiguration

Schritt 1: Installieren der Dateien

Hinweis

Siehe Dynamics 365 für Outlook installieren für Download-Anweisungen.

Der folgende Befehl zeigt die verfügbaren Optionen zum Ausführen des Setup für Microsoft Dynamics CRM für Outlook an der Eingabeaufforderung an:

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

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

Benutzern, die unterwegs sind oder die nicht immer mit dem Microsoft Dynamics 365 Server verbunden sind, bietet Microsoft Dynamics 365 für Microsoft Office Outlook mit Offlinezugriff Zugriff auf ihre Kundendaten. So installieren Sie Microsoft Dynamics 365 für Microsoft Office Outlook mit Offlinezugriff im stillen Modus:

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

So deinstallieren Sie Microsoft Dynamics 365 für Microsoft Office Outlook mit Offlinezugriff im stillen Modus:

SetupClient /x /q

Parameter für eine Installation von Dynamics 365 für Outlook

Parameter

Beschreibung

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 für Outlook-Dateien installiert werden.

/A

Erstellt eine Administratorinstallation von Dynamics 365 für Outlook, indem ein Windows Installer-Paket erstellt wird. Mit diesem Paket können die Benutzer Setup ausgehend von einer Netzwerkfreigabe ausführen, oder Benutzer ohne Administratorrolle führen Setup basierend auf einer Gruppenrichtlinie aus. 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

Wenn Sie nicht mit dem /targetdir-Parameter einen Zielordner angeben, installiert Setup die administrative Installation im Standardordner <Laufwerk:> Program Files\Microsoft Dynamics CRM.

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 Parameter /i 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 [drive:][[path] 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 [drive:][[path] 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 für 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 für 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 für Outlook. Hierbei handelt es sich um eine Option des Wartungsmodus, die erst nach der Installation der Anwendung verfügbar ist.

Beispiel-XML-Konfigurationsdatei für Dynamics 365 für Outlook zur Installation

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

Hinweis

Sie können Datei verwenden, die sowohl die Installations- als auch die Konfigurationselemente enthält.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: Konfigurieren von Dynamics 365 für Outlook mithilfe einer XML-Konfigurationsdatei

Nach der Installation von Dynamics 365 für Outlook müssen Sie die Anwendung konfigurieren. Führen Sie dazu den Dynamics 365 für OutlookKonfigurations-Assistent an der Eingabeaufforderung aus. Die Datei Konfigurations-Assistent heißt Microsoft.Crm.Application.Outlook.ConfigWizard.exe und befindet sich in dem Client\ConfigWizard-Ordner, in dem Dynamics 365 für Outlook installiert ist. Standardmäßig ist der Ordner C:\Program Files\Microsoft Dynamics CRM.

Hinweis

Die Anmeldeinformationen des Benutzers, der Dynamics 365 für Outlook ausführt, werden zur Authentifizierung von Microsoft Dynamics 365 verwendet. Daher muss zum Ausführen einer stillen Dynamics 365 für Outlook-Konfiguration Konfigurations-Assistent im Kontext des Benutzers ausgeführt werden, z. B. durch Ausführung einer durch den Benutzer aufgerufenen Stapelverarbeitungsdatei 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 für Outlook mithilfe der Microsoft-Gruppenrichtlinie finden Sie unter Bereitstellen von Microsoft Dynamics 365 für 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 für Outlook. Der Dynamics 365 für Outlook ist standardmäßig installiert im Ordner C:\Program Files\Microsoft Dynamics CRM.

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 die Konfiguration von Dynamics 365 für Outlook

Mit dem folgenden Befehl wird Microsoft Dynamics 365 für 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 in Windows Vault gespeichert sind, sind erforderlich, um Konfigurations-Assistent im stillen Modus auszuführen.Weitere Informationen:Anmeldeinformationen des Benutzers sind erforderlich, wenn Sie den Konfigurations-Assistenten ausführen

Der Befehlszeilenparameter /i [Laufwerk:] [[Pfad] configfilename.xml]] stellt für Setup für Microsoft Dynamics CRM für Outlook erforderliche Informationen 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 für 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 entweder im Installationsordner AppData für lokale Benutzer oder Clientinstallationsordner befinden muss.

XML-Konfigurationsdateielemente für Dynamics 365 für Outlook

Element

Beschreibung

<Deployments> </Deployments>

Die Konfigurationsdatei muss eine gültige XML -Datei sein, die <Deployment> als Stammelement verwendet.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Gibt den Typ der Dynamics 365 für Outlook-Installation an. Bei Angabe von true wird die Funktionalität Microsoft Dynamics 365 für Outlook mit Offlinezugriff installiert.

<TargetDir>drive:\path</TargetDirectory>

Gibt den Ordner an, in dem Dynamics 365 für Outlook-Dateien installiert werden.

<Deployment> </Deployment>

Übergeordnetes Element für alle folgenden Elemente.

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

Gibt die URL für den Microsoft Dynamics 365Discovery Web Service an.

Für eine lokale Bereitstellung von Microsoft Dynamics 365 Server kann die unterstützte Bindung HTTPS oder HTTP sein. Wird vom Discovery Web Service ein anderer Port als der Standardport 80 (HTTP) oder 443 (HTTPS) verwendet, müssen Sie die Portnummer angeben. In einer Vollständiger Server-Bereitstellung von Microsoft Dynamics 365 Server ist die Discovery Web Service-URL die gleiche wie die URL für die Webanwendung, wie http://crmserver .

Verwenden Sie für Microsoft Dynamics 365 (online) die gesamte Organisation URL, wie etwa https://orgname.crm.dynamics.com oder, je nach Ihrer Onlineumgebung und Ihrem Standort, den Suchservice 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 in Konfigurations-Assistent verwendet werden. Wenn Sie false angeben, können Sie Anmeldeinformationen, wie beispielsweise user@contoso.onmicrosoft.com, verwenden.

<Organizations> </Organizations>

Dies ist das übergeordnete Element für das folgende <Organization>-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 für Outlook konfiguriert wird.

Hinweis

Für OrganizationName wird die Groß-/Kleinschreibung beachtet.

<CEIPNotification>true/false</CEIPNotification>

Gibt an, ob Dynamics 365 für 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 für Outlook nicht angezeigt.Weitere Informationen:Microsoft-Programm zur Verbesserung der Benutzerfreundlichkeit

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

Der Konfigurations-Assistent erfordert Benutzer-Anmeldeinformationen. Bei eine stillen Konfiguration unter Verwendung von /Q mit Microsoft.Crm.Application.Outlook.ConfigWizard.exe sucht der Konfigurations-Assistent in Windows Vault nach den Anmeldeinformationen des Benutzers. Wenn 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. Informationen dazu, wie Benutzeranmeldeinformationen von einem Befehlsskript dem Windows Vault hinzugefügt werden, finden Sie in dem Blogbeitrag Automatische Konfiguration von CRM für Outlook-Client in CRM 2011-Umgebungen, die für Anspruch aktiviert sind. Weitere Informationen zu Windows Vault und Anmeldeinformationsmanager finden Sie in Was ist der Anmeldeinformationsmanager?

Beispiel-XML-Konfigurationsdatei für Dynamics 365 für Outlook zur Konfiguration

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

Hinweis

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

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

Hinweis

Im vorangehenden Beispiel werden zwei unterschiedliche Organisationen festgelegt, für die der Benutzer Zugriff besitzt und Dynamics 365 für 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 Dynamics 365 (lokal)können Sie den eindeutigen Namen der Organisation finden, indem Sie Get-CrmOrganization Windows PowerShell cmdlet ausführen oder zu EinstellungenAnpassungenEntwicklerressourcen gehen und unter Instanzreferenzinformationen den Eindeutigen Namen kopieren.

Konfigurieren von Dynamics 365 für Outlook mithilfe eines Skripts

  1. Schreiben Sie ein Skript, mit dem die Konfigurationseinstellungen für Benutzer von Dynamics 365 für 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"
    

    Tipp

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

    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>http://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 (Group Policy Object, GPO).

Siehe auch

Dynamics 365 für Outlook installieren
Einrichten von Dynamics 365 für Outlook
Installation des Microsoft Dynamics CRM-Servers mithilfe einer Eingabeaufforderung
Dynamics 365 für Outlook

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright