다음을 통해 공유

XRM 도구를 사용하여 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 IFD(인터넷 연결 배포)에 연결

CRM(클레임 기반)에 연결

모든 생성자에 대한 선택적 매개 변수

연결 상태 확인

OrganizationServiceProxy를 사용하여 CRM에 연결

사용자가 제공한 OrganizationServiceProxy 인스턴스를 사용하여 CRM에 연결하려면 다음 생성자를 사용합니다.

CrmServiceClient crmSvc = new CrmServiceClient(<orgServiceproxy>);

CRM Online(Live ID)에 연결

다음 생성자를 사용합니다.

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

<CRMonlineRegion> 매개 변수의 유효한 값은 NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 및 NorthAmerica2입니다.String.Empty로 설정하면 Dynamics 365 조직의 모든 지역에 있는 서버를 검색합니다.<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.

CRM Online(Office 365)에 연결

다음 생성자를 사용합니다.

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

<CRMonlineRegion> 매개 변수의 유효한 값은 NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 및 NorthAmerica2입니다.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 IFD(인터넷 연결 배포)에 연결

다음 생성자를 사용합니다.

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

이 메서드는 지정한 로컬 도메인을 기반으로 클레임 기반 인증을 실행합니다.AD FS를 사용하는 고객에게 유용하며 Dynamics 365 서버를 클레임으로 구성하여 많은 사용자가 Dynamics 365 서버와 동일한 AD FS 도메인에 밀집됩니다.<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 서버를 클레임으로 구성하여 많은 사용자가 Dynamics 365 서버와 동일한 AD FS 도메인에 밀집됩니다.<Server> 매개 변수의 경우 Dynamics 365 서버의 호스트 이름을 지정합니다(예: crmtest).<OrgName> 매개 변수의 경우 고유하거나 친숙한 이름을 지정할 수 있습니다.

모든 생성자에 대한 선택적 매개 변수

앞에서 표시된 각 생성자를 사용할 수 있는 선택적 매개 변수입니다.

  • useUniqueInstance: 연결이 계속 활성인데 다시 호출하면 기존 연결을 재사용할지 여부를 나타냅니다. 기본값은 false입니다.true로 설정하면 시스템에서 고유한 연결을 만들도록 합니다.

  • useSSL: SSL을 사용하여 Dynamics 365에 연결할지 여부를 나타냅니다. 기본값은 false이고, 즉 http:// 를 사용합니다.true 로 설정하면 https:// 를 사용합니다.

  • orgDetail: 기본값은 null입니다. 설정하면 쿼리에서 검색 서비스로 반환되고 일반적으로 조직 선택 프로세스의 두 번째 구간으로 사용됩니다.

연결 상태 확인

연결 요청이 성공적이었는지 확인하려면 CrmServiceClient.IsReady 속성의 값을 확인합니다.참인 경우, 연결이 성공적이고 귀하는 작업할 준비가 된 것입니다. 그렇지 않으면 CrmServiceClient의 값을 체크하십시오. 연결 실패의 원인에 대한 LastCrmError 및 CrmServiceClient.LastCrmException 속성.

참고 항목

XRM 도구에 PowerShell cmdlets를 사용하여 CRM에 연결
XRM 도구를 사용하여 CRM에서 작업 실행
샘플: Microsoft Dynamics CRM용 빠른 시작
XRM 도구를 사용하여 클라이언트 응용 프로그램 빌드

© 2017 Microsoft. All rights reserved. 저작권 정보