Freigeben über

Verwenden Sie XRM, um eine Verbindung mit CRM herzustellen

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Wenn Sie eine Verbindung mit Microsoft Dynamics 365 herstellen, erstellen Sie eine Instanz der CrmServiceClient Klasse und nutzen dann einen der Konstruktoren, um eine Verbindung herzustellen. Jeder Objekt-Methodenaufruf dieser Klasse wird als eine Arbeitseinheit betrachtet und alle Anrufe zu Microsoft Dynamics 365 sind sicher.

In diesem Thema

Mithilfe von OrganizationServiceProxy zu CRM verbinden

Verbinden mit CRM Online (Live ID)

Zu CRM Online verbinden (Office 365)

Mit dem CRM lokal verbinden (Active Directory)

Zu CRM Bereitstellung mit Internetzugriff (IFD) verbinden

Zu CRM verbinden (Anspruch basiert)

Optionale Parameter für alle Konstruktoren

Bestimmung Ihres Verbindungsstatus

Mithilfe von OrganizationServiceProxy zu CRM verbinden

Verwenden Sie nachfolgenden Konstruktor, um eine Verbindung mit CRM mithilfe der dem Benutzer zur Verfügung gestellten OrganizationServiceProxy-Instanz herzustellen.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

Verbinden mit CRM Online (Live ID)

Verwenden Sie folgenden Konstruktor.

CrmServiceClient crmSvc = new CrmServiceClient("<LiveID>", "<Password>", "<CRMonlineRegion>", "<OrgName>");

Für den Parameter <CRMonlineRegion> sind gültige Werte: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan und NorthAmerica2. Wenn Sie dies auf String.Empty festgelegt haben, werden Server in allen diesen Regionen für die Dynamics 365 - Organisation gesucht. Für den <OrgName> Parameter können Sie entweder den eindeutigen Namen oder den Anzeigenamen angeben.

Zu CRM Online verbinden (Office 365)

Verwenden Sie folgenden Konstruktor.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", "<Password>", "<CRMonlineRegion>", "<OrgName>", isOffice365:true);

Für den Parameter <CRMonlineRegion> sind gültige Werte: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan und NorthAmerica2. Wenn Sie dies auf String.Empty festgelegt haben, werden Server in allen diesen Regionen für die Dynamics 365 - Organisation gesucht. Für den <OrgName> Parameter können Sie entweder den eindeutigen Namen oder den Anzeigenamen angeben.

Mit dem CRM lokal verbinden (Active Directory)

Verwenden Sie folgenden Konstruktor.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”),"<Server>", "<Port>", "<OrgName>");

Dadurch wird eine Active Directory Authentifizierung basierend auf der angegebenen Domäne ausgelöst. Für den <Server> Parameter geben Sie den Hostnamen Ihres Dynamics 365 Servers an; beispielsweise: crmtest. Für den <OrgName> Parameter können Sie entweder den eindeutigen Namen oder den Anzeigenamen angeben.

Zu CRM Bereitstellung mit Internetzugriff (IFD) verbinden

Verwenden Sie folgenden Konstruktor.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.IFD, "<Server>", "<Port>", "<OrgName>");

Diese Methode führt eine anspruchsbasierte Authentifizierung der angegebenen Domäne lokal aus. Dies ist hilfreich für Kunden, die AD FS verwenden und Ihre Dynamics 365 Server als Ansprüche konfiguriert haben, bei denen der Benutzerbestand sich in derselben Domäne wie der AD FS Server Dynamics 365 befindet. Für den <Server> Parameter geben Sie den Hostnamen Ihres Dynamics 365 Servers an; beispielsweise: crmtest. Für den <OrgName> Parameter können Sie entweder den eindeutigen Namen oder den Anzeigenamen angeben.

Zu CRM verbinden (Anspruch basiert)

Verwenden Sie folgenden Konstruktor.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”, "<HomeRealm>"),"<Server>", "<Port>", "<OrgName>");

Diese Methode führt eine anspruchsbasierte Authentifizierung gegenüber dem angegebenen Startbereich aus. Dies ist hilfreich für Kunden, die AD FS verwenden und Ihre Dynamics 365 Server als Ansprüche konfiguriert haben, bei denen der Benutzerbestand sich in derselben Domäne wie der AD FS Server Dynamics 365 befindet. Für den <Server> Parameter geben Sie den Hostnamen Ihres Dynamics 365 Servers an; beispielsweise: crmtest. Für den <OrgName> Parameter können Sie entweder den eindeutigen Namen oder den Anzeigenamen angeben.

Optionale Parameter für alle Konstruktoren

Dies sind die optionalen Parameter, die Sie mit den beiden Konstruktoren verwenden können, der zuvor gezeigt wurden.

  • useUniqueInstance: Zeigt eine vorhandene wiederverwendete Verbindung an, wenn Sie wieder aufgerufen wird, solange die Verbindung noch aktiv ist. Standard ist falsch. Wenn auf wahr festgelegt, wird das System gezwungen, eine eindeutige Verbindung herzustellen.

  • useSSL: Gibt an, ob von SSL verwendet wird, um eine Verbindung mit Dynamics 365 herzustellen. Standardwert für false. Verwenden Sie http://. Wenn auf wahr festgelegt, wird https:// verwendet.

  • orgDetail: Standardwerte auf Null. Wenn gesetzt, wird dieses Feld aus einer Abfrage an den Suchdienst zurückgegeben und ist in der Regel das zweite Bein eines Organisationsauswahlverfahrens.

Bestimmung Ihres Verbindungsstatus

Um zu bestimmen, ob die Verbindungsaufforderung erfolgreich war, überprüfen Sie den Wert für die CrmServiceClient.IsReady-Eigenschaft. Wenn der Wert true ist, ist die Verbindung erfolgreich undSie können mit der Arbeit beginnen. Andernfalls überprüfen Sie die Werte des CrmServiceClient.LastCrmError und CrmServiceClient.LastCrmException Eigenschaften der Ursache für Verbindungsfehler.

Siehe auch

Verwenden von PowerShell-Cmdlets für XRM-Tooling, um eine Verbindung mit CRM herzustellen
XRM-Tooling zur Ausführung von Aktionen in CRM verwenden
Beispiel: Erste Schritte für Microsoft Dynamics CRM
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright