使用 XRM tooling 连接到 CRM

 

发布日期: 2016年11月

适用于: Dynamics CRM 2015

若要连接到 Microsoft Dynamics 365,您创建 CrmServiceClient 类的实例,然后使用一个构造函数进行连接。 该类的对象每个方法调用被视为工作的一个原子单元,所有对 Microsoft Dynamics 365 的调用都是线程安全。

在本主题中

使用 OrganizationServiceProxy 连接到 CRM

连接到 CRM Online (Live ID)

连接到 CRM Online (Office 365)

连接到 CRM 内部部署 (Active Directory)

连接到 CRM 面向 Internet 的部署 (IFD)

连接到 CRM(基于声明)

所有构造函数的可选参数

确定您的连接状态

使用 OrganizationServiceProxy 连接到 CRM

使用以下构造函数来连接到使用用户提供的 OrganizationServiceProxy 实例的 CRM。

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

连接到 CRM Online (Live ID)

使用以下构造函数。

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

对于 <CRMonlineRegion> 参数的有效值为:NorthAmericaEMEAAPACSouthAmericaOceaniaJapanNorthAmerica2。 如果将此设置到 String.Empty,则将在 Dynamics 365 组织的所有区域中搜索服务器。 对于 <OrgName> 参数,您可以指定唯一或友好名称。

连接到 CRM Online (Office 365)

使用以下构造函数。

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

对于 <CRMonlineRegion> 参数的有效值为:NorthAmericaEMEAAPACSouthAmericaOceaniaJapanNorthAmerica2。 如果将此设置到 String.Empty,则将在 Dynamics 365 组织的所有区域中搜索服务器。 对于 <OrgName> 参数,您可以指定唯一或友好名称。

连接到 CRM 内部部署 (Active Directory)

使用以下构造函数。

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

这将运行基于指定域的 Active Directory 身份验证。 对于 <Server> 参数,请指定您的 Dynamics 365 服务器主机名称;例如:crmtest。 对于 <OrgName> 参数,您可以指定唯一或友好名称。

连接到 CRM 面向 Internet 的部署 (IFD)

使用以下构造函数。

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

此方法要基于指定本地域运行基于声明的身份验证。 这对使用 AD FS 的客户很有用,并配置它们的 Dynamics 365 服务器作为声明,用户在 AD FS 域的居住人数和 Dynamics 365 的服务器相同。 对于 <Server> 参数,请指定您的 Dynamics 365 服务器主机名称;例如:crmtest。 对于 <OrgName> 参数,您可以指定唯一或友好名称。

连接到 CRM(基于声明)

使用以下构造函数。

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

此方法将针对指定运行基于指定主页领域运行基于声明的身份验证。 这对使用 AD FS 的客户很有用,并配置它们的 Dynamics 365 服务器作为声明,用户在 AD FS 域的居住人数和 Dynamics 365 的服务器相同。 对于 <Server> 参数,请指定您的 Dynamics 365 服务器主机名称;例如:crmtest。 对于 <OrgName> 参数,您可以指定唯一或友好名称。

所有构造函数的可选参数

这些是您可以与以前显示的每一个构造函数使用的可选参数。

  • useUniqueInstance:在连接仍可用时如果重新调用,指示是否重用现有连接。 默认值为 false 。 如果设置为 true,这会强制系统创建一个唯一连接。

  • useSSL:指示是否使用 SSL 连接到 Dynamics 365。 设置 false 为默认值,即使用 http:// 。 如果设置为 true,它将使用 https://

  • orgDetail:默认为空。 如果设置,这将从查询返回到发现服务,且通常用于组织选择过程的第二行程。

确定您的连接状态

若要确定连接请求是否成功,请检查 CrmServiceClient 的值。IsReady 的属性。 如果为 true ,说明该连接为成功连接,您可以准备工作。 否则,请检查 CrmServiceClient 的值。 连接失败的原因的 LastCrmErrorCrmServiceClient.LastCrmException 属性。

另请参阅

使用 XRM PowerShell cmdlets 工具连接到 CRM
使用 XRM 工具执行 CRM 中的操作
示例:Microsoft Dynamics CRM 快速入门指南
使用 XRM 工具,构建 Windows 客户端应用程序

© 2017 Microsoft。 保留所有权利。 版权