XRM 도구에 PowerShell cmdlets를 사용하여 CRM에 연결

아티클
07/06/2017

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

XRM 도구는 Microsoft Dynamics 365에 연결하고 현재 사용자 액세스가 Get-CrmConnection 및 Get-CrmOrganizations인 조직을 검색하는 데 사용할 수 있는 다음 Windows PowerShell cmdlet을 제공합니다 .

이 항목의 내용

필수 조건

cmdlet 등록

cmdlet를 사용하여 CRM에서 조직 검색

Cmdlet를 사용하여 CRM에 연결

필수 조건

XRM 도구 cmdlet을 사용하려면 버전 3.0 이상인 Powershell의 버전이 필요합니다. 버전을 확인하려면 Powershell 창을 실행하고 $Host 명령을 실행합니다.
서명된 Powershell 스크립트를 실행할 실행 정책을 설정합니다. 이렇게 하려면 Powershell 창을 관리자로 열고 Set-ExecutionPolicy -ExecutionPolicy AllSigned 명령을 실행합니다.

cmdlet 등록

Powershell cmdlets를 사용하려면 등록해야 합니다.

Microsoft Dynamics CRM SDK 패키지를 다운로드합니다. 패키지 파일을 실행하여 패키지의 내용을 추출합니다. cmdlets를 등록하는 Powershell 어셈블리(Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) 및 스크립트(RegisterXRMTooling.ps1)는 SDK의 \SDK\bin 폴더에 있습니다.
컴퓨터에서 높은 권한을 사용하여(관리자로 실행) Windows PowerShell을 시작합니다.
지시되면, 디렉터리를 Powershelldll 파일과 Cmdlet 등록용 스크립트가 들어있는 폴더로 변경하십시오. 예를 들면 다음과 같습니다.
```
cd c:\SDK\bin
```
RegisterXRMTooling.ps1 스크립트를 실행하여 XRM 도구 Powershell 어셈블리를 등록하고 Windows PowerShell 스냅인을 설치합니다. 다음 명령을 입력하고 Enter 키를 누릅니다.
```
.\RegisterXRMTooling.ps1
```
Windows PowerShell 스냅인을 추가합니다. 그러면 Get-CrmConnection 및 Get-CrmOrganizations cmdlets가 등록됩니다.
```
Add-PSSnapin Microsoft.Xrm.Tooling.Connector
```

이제 이러한 Windows PowerShell cmdlets를 사용할 준비가 되었습니다. 등록한 cmdlets를 나열하려면 Windows PowerShell 창에서 다음 명령을 실행합니다.

Get-Help “Crm”

cmdlet를 사용하여 CRM에서 조직 검색

Get-CrmOrganizations cmdlet를 사용하여 액세스 권한이 있는 조직을 검색합니다.

자격 증명을 제공하여 Microsoft Dynamics CRM(온-프레미스) 또는 Microsoft Dynamics CRM Online 인스턴스에 연결합니다. 다음 명령을 실행하면 Dynamics 365 인스턴스에 연결하도록 사용자 이름과 암호를 입력하라는 메시지가 표시되고 $Cred 변수에 저장됩니다.
```
$Cred = Get-Credential
```
다음 명령을 사용하여 조직을 검색하고 $CRMOrgs 변수에 정보를 저장합니다.
- Microsoft Dynamics CRM(온-프레미스) 서버에 연결할 경우:
```
$CRMOrgs = Get-CrmOrganizations –ServerUrl http://<CRM_Server_Host> –Credential $Cred
```
- Microsoft Dynamics CRM Online 인스턴스에 연결할 경우:
```
$CRMOrgs = Get-CrmOrganizations -Credential $Cred -DeploymentRegion NorthAmerica –OnlineType Office365
```
  참고
  
  DeploymentRegion 매개 변수의 경우 유효한 값은 NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 및 NorthAmerica2입니다.OnlineType 매개 변수의 유효한 값은 Office365 및 LiveID입니다.
- 지정된 홈 영역에 대해 클레임 기반 인증을 사용하여 Dynamics 365 서버에 연결할 경우
```
$CRMOrgs = Get-CrmOrganizations –ServerUrl http://<CRM_Server_Host> –Credential $Cred –HomRealmURL http://<Identity_Provider_Address>
```
2단계서 명령을 시행할 때 제공한 자격 증명의 유효성이 검사됩니다. 명령 집행이 성공하면, 다음 명령을 입력하고 Enter 키를 눌러 귀하가 액세스할 수 있는 조직을 표시합니다:
```
$CRMOrgs
```
팁

검색한 Dynamics 365 조직을 저장하는 데 사용한 변수를 사용하여(이 경우 $CRMOrgs) Get-CrmConnection cmdlet로 Dynamics 365에 연결할 수 있습니다. 조직 이름을 지정하려면 $CRMOrgs.UniqueName 명령을 사용합니다.

$CRMOrgs 변수에 저장된 조직 값이 둘 이상일 경우 $CRMOrgs[n-1] 명령을 사용하여 nth 조직을 참조할 수 있습니다. 예를 들어 $CRMOrgs 변수(”MyOrg”)에서 타사 조직의 고유 이름을 참조하려면 $CRMOrgs[2].UniqueName 명령을 사용합니다.추가 정보:TechNet: 어레이의 값 액세스

Cmdlet를 사용하여 CRM에 연결

Get-CrmConnection cmdlet를 사용하여 Dynamics 365 인스턴스에 연결합니다. Cmdlet를 사용하면 XRM 도구의 공통 로그인 컨트롤을 사용하여 자격 증명을 지정하고 Dynamics 365에 연결하거나 자격 증명을 인라인 매개 변수로 지정할 수 있습니다.추가 정보:클라이언트 응용 프로그램에서 XRM 도구의 공통 로그인 컨트롤 사용

공통 로그인 컨트롤을 사용하여 CRM에 연결

Dynamics 365에 연결하기 위해 공통 로그인 컨트롤을 사용하여 자격 증명을 제공하려면 다음 명령을 사용합니다. 나중에 사용할 수 있도록 연결 정보는 $CRMConn 변수에 저장됩니다.
```
$CRMConn = Get-CrmConnection -InteractiveMode
```
LoginControl 대화 상자가 나타납니다. 자격 증명을 제공하여 Dynamics 365 인스턴스에 연결하고 로그인을 클릭합니다.

자격 증명 인라인을 지정하여 CRM에 연결

CRM에 연결하려면 다음 명령을 사용합니다. 이러한 명령은 조직을 검색하는 동안 자격 증명을 저장하기 위에 앞에서 만든 $Cred 변수를 사용합니다. 연결 정보는 $CRMConn 변수에 저장됩니다.
- Microsoft Dynamics CRM(온-프레미스) 서버에 연결할 경우:
```
$CRMConn = Get-CrmConnection –ServerUrl http://<CRM_Server_Host> -Credential $Cred -OrganizationName <OrgName>
```
- Microsoft Dynamics CRM Online 인스턴스에 연결할 경우:
```
$CRMConn = Get-CrmConnection -Credential $Cred -DeploymentRegion <Deployment region name> –OnlineType <Online type name> –OrganizationName <OrgName>
```
  참고
  
  DeploymentRegion 매개 변수의 경우 유효한 값은 NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan 및 NorthAmerica2입니다.OnlineType 매개 변수의 유효한 값은 Office365 및 LiveID입니다.
- 지정된 홈 영역에 대해 클레임 기반 인증을 사용하여 Dynamics 365 서버에 연결할 경우
```
$CRMConn = Get-CrmConnection –ServerUrl http://<CRM_Server_Host> -Credential $Cred -OrganizationName <OrgName> –HomRealmURL http://<Identity_Provider_Address>
```
참고

앞의 모든 명령에서 OrganizationName 매개 변수의 경우 조직 고유 이름 또는 친숙한 이름을 지정할 수 있습니다. Get-CrmOrganizations cmdlet를 사용하여 검색하거나 $CRMOrgs 변수에 저장된 조직의 고유 이름 또는 친숙한 이름을 사용할 수 있습니다. 예를 들어, $CRMOrgs[x].UniqueName 또는 $CRMOrgs[x].FriendlyName를 사용할 수 있습니다.
2단계서 명령을 시행할 때 제공한 자격 증명의 유효성이 검사됩니다. Cmdlet 집행이 성공하면, 다음 명령을 입력하고 Enter 키를 눌러 연결 정보와 상태를 표시합니다:
```
$CRMConn
```

참고 항목

XRM 도구를 사용하여 CRM에 연결
XRM 도구를 사용하여 클라이언트 응용 프로그램 빌드

다음을 통해 공유

XRM 도구에 PowerShell cmdlets를 사용하여 CRM에 연결

이 항목의 내용

필수 조건

cmdlet 등록

cmdlet를 사용하여 CRM에서 조직 검색

Cmdlet를 사용하여 CRM에 연결

공통 로그인 컨트롤을 사용하여 CRM에 연결

자격 증명 인라인을 지정하여 CRM에 연결

참고 항목

추가 리소스