Freigeben über

CrmServiceClient-Konstruktoren verwenden, um eine Verbindung mit Dynamics 365 herzustellen

  • Artikel

 

Veröffentlicht: Januar 2017

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

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. Alle Aufrufe zu Dynamics 365 unter Verwendung des CrmServiceClient-Klasse sind threadsicher.

Abgesehen von den Konstruktoren, die in diesem Thema beschrieben werden, können Sie auch CrmServiceClient Verbindungszeichenfolgen verwenden, um eine Verbindung mit Dynamics 365herzustellen.Weitere Informationen:Verwenden von Verbindungszeichenfolgen im XRM-Tooling zum Herstellen einer Verbindung zu Dynamics 365

In diesem Thema

Mithilfe von OrganizationServiceProxy zu Dynamics 365 verbinden

Mithilfe von OrganizationWebProxyClient zu Dynamics 365 verbinden

Verbindung mit Dynamics 365 (online) (Office 365) herstellen

Verbinden mit Dynamics 365 (online) (Office 365) unter Verwendung von OAuth

Mit Dynamics 365 lokal verbinden (Active Directory)

Zu Dynamics 365-Bereitstellung mit Internetzugriff (IFD) verbinden

Mithilfe von OAuth mit Dynamics 365-Bereitstellung mit Internetzugriff (IFD) verbinden

Mit Dynamics 365 verbinden (anspruchbasiert)

Bestimmung Ihres Verbindungsstatus

Mithilfe von OrganizationServiceProxy zu Dynamics 365 verbinden

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

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceProxy>);

Mithilfe von OrganizationWebProxyClient zu Dynamics 365 verbinden

Verwenden Sie den nachfolgenden Konstruktor, um eine Verbindung mit Dynamics 365 mithilfe der dem Benutzer zur Verfügung gestellten OrganizationWebProxyClient-Instanz herzustellen. Dieser Konstruktor wird in Microsoft Dynamics 365 (online und lokal) eingeführt.

CrmServiceClient crmSvc = new CrmServiceClient(<orgWebProxyClient>);

Verbindung mit Dynamics 365 (online) (Office 365) herstellen

Verwenden Sie den folgenden Konstruktor, um eine Verbindung mit Ihrer Dynamics 365 (online)-Instanz in Office 365 herzustellen.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>, isOffice365:true);

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

Die folgenden Parameter sind optional: useUniqueInstance, useSsl und orgDetail.

Verbinden mit Dynamics 365 (online) (Office 365) unter Verwendung von OAuth

Verwenden Sie den folgenden Konstruktor zur Nutzung des OAuth-Protokolls, um eine Verbindung mit Ihrer Dynamics 365 (online)-Instanz in Office 365 herzustellen. Der OAuth Support wird in Microsoft Dynamics 365 (online und lokal) eingeführt.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<CrmRegion>", "<OrgName>", useUniqueInstance:false, <orgDetail>,
                  <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, <externalOrgWebProxyClient>, PromptBehavior.Auto);

Dieser Konstruktor verwendet die Microsoft Azure Active Directory Authentication Library (ADAL) zur Authentifizierung der Benutzer. Wenn die Benutzeranmeldeinformationen (Benutzername und Kennwort) nicht angegeben sind, wird ADAL den Benutzer zur Angabe der Anmeldeinformationen auffordern, abhängig vom PromptBehavior-Parameter, der (optional) im Kontruktor angegeben ist. ADAL authentifiziert die Anmeldeinformationen mithilfe des OAuth-Protokolls, erhält die Zugriffs- und Aktualisierungstoken von Azure Active Directoryund verwendet dann das Zugriffstoken, um Anfragen an Dynamics 365 zu stellen.

Gültige Werte für die <CrmRegion>-Parameter sind: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND 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 Dynamics 365 lokal verbinden (Active Directory)

Verwenden Sie den folgenden Konstruktor, um eine Verbindung zu einer lokalen Instanz mit einer Active Directory-Authentifizierung herzustellen.

CrmServiceClient crmSvc = new CrmServiceClient(new System.Net.NetworkCredential("<UserName>", "<Password>", “<Domain>”), AuthenticationType.AD, "<Server>", "<Port>", "<OrgName>", useUniqueInstance:false, useSsl:false, <orgDetail>);

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.

Die folgenden Parameter sind optional: useUniqueInstance, useSsl und orgDetail.

Zu Dynamics 365-Bereitstellung mit Internetzugriff (IFD) verbinden

Verwenden Sie den folgenden Konstruktor, um eine Verbindung mit einer Dynamics 365 IFD-Instanz herzustellen.

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

So wird eine anspruchsbasierte Authentifizierung der angegebenen Domäne lokal ausgeführt. 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.

Die folgenden Parameter sind optional: useUniqueInstance, useSsl und orgDetail.

Mithilfe von OAuth mit Dynamics 365-Bereitstellung mit Internetzugriff (IFD) verbinden

Verwenden Sie den folgenden Konstruktor zur Nutzung des OAuth-Protokolls in Active Directory-Verbunddienste (AD FS) in Windows Server 2012 R2, um eine Verbindung mit einer Dynamics 365 IFD- Instanz herzustellen. Damit dieser Konstruktor funktioniert, muss der Computer, auf dem Microsoft Dynamics 365 Server installiert ist, so konfiguriert werden, dass er AD FS 2.2 als Sicherheitstokendienst (Security Token Service, STS) verwendet. Der OAuth Support für die Verbindung mit einer Dynamics 365-IFD-Instanz wird in Dynamics 365eingeführt.

CrmServiceClient crmSvc = new CrmServiceClient("<UserName>", CrmServiceClient.MakeSecureString("<Password>"), "<HomeRealm>", "<HostName>", "<Port>", "<OrgName>", useSsl:true, useUniqueInstance:false, 
                        <orgDetail>, <userIdentifier>, <clientId>, <redirectUri>, <tokenCachePath>, externalOrgWebProxyClient, PromptBehavior.Auto);

Die clientId- und redirectUri-Werte für die Anwendung, die OAuth unterstützt, sollten auf dem IFD-Server registriert werden.

Wenn die Benutzeranmeldeinformationen (Benutzername und Kennwort) nicht angegeben sind, wird ADAL den Benutzer zur Angabe der Anmeldeinformationen auffordern, abhängig vom PromptBehavior-Parameter, der (optional) im Kontruktor angegeben ist. ADAL authentifiziert den Benutzer unter Verwendung des Sicherheitstoken von AD FSund nutzt dieses Token, um Aktionen in Dynamics 365auszuführen.

Mit Dynamics 365 verbinden (anspruchbasiert)

Verwenden Sie den folgenden Konstruktor zum Deaktivieren der anspruchsbasierten Authentifizierung.

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

So wird eine anspruchsbasierte Authentifizierung gegenüber dem angegebenen Startbereich ausgeführt. 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.

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

AuthenticationType
Verwenden von Verbindungszeichenfolgen im XRM-Tooling zum Herstellen einer Verbindung zu Dynamics 365
Verwenden von PowerShell-Cmdlets für XRM-Tooling, um eine Verbindung mit Dynamics 365 herzustellen
XRM-Tooling zur Ausführung von Aktionen in Dynamics 365 verwenden
Beispiel: Erste Schritte für Microsoft Dynamics 365
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright