명령 프롬프트를 사용하여 Outlook용 Microsoft Dynamics 365 설치

 

게시 날짜: 2017년 2월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Outlook용 Microsoft Dynamics 365 설치 절차는 두 단계로 구성됩니다. 먼저, 설치를 실행하여 컴퓨터에 파일을 설치해야 합니다. 그런 다음 Microsoft Dynamics 365구성 마법사를 실행하여 응용 프로그램을 구성하고 설치를 완료합니다.

중요

구성 파일의 값과 명령줄 매개 변수의 값이 충돌하는 경우 명령줄 매개 변수가 우선합니다.

이 항목의 내용

1단계: 파일 설치

2단계: XML 구성 파일을 사용하여 Outlook용 Dynamics 365 구성

Outlook용 Dynamics 365 구성 명령 예제

Outlook용 Dynamics 365 XML 구성 파일 요소

구성 마법사 실행 시 사용자 자격 증명 필요

구성할 Outlook용 Dynamics 365 XML 구성 파일 샘플

1단계: 파일 설치

참고

자세한 내용은 Outlook용 Dynamics 365 설치의 다운로드 지침을 참조하십시오.

다음 명령은 명령 프롬프트에서 Outlook용 Microsoft Dynamics CRM 설정를 실행하는 데 사용할 수 있는 옵션을 보여 줍니다.

Setupclient.exe [/A] [/Q] [/X] [/L 또는 /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Outlook용 Dynamics 365 설치 명령 예제

이동이 많거나 Microsoft Dynamics 365 Server에 항상 연결되어 있지 않은 사용자는 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)을 통해 고객 데이터에 액세스할 수 있습니다.Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)을 자동 모드로 설치하려면 다음 명령을 실행합니다.

Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"

자동 모드로 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)을 제거하려면 다음 명령을 실행합니다.

SetupClient /x /q

Outlook용 Dynamics 365 설치 매개 변수

매개 변수

설명

없음

매개 변수 없이 사용하면 Setupclient.exe가 전체 표시 화면으로 실행됩니다.

installofflinecapability

오프라인 기능을 설치할지 여부를 결정합니다. 이 매개 변수를 포함하면 오프라인 기능 및 구성 요소가 설치됩니다. 이 매개 변수를 지정하지 않으면 온라인 전용 클라이언트가 설치됩니다.

/targetdir <"drive:\path">

Outlook용 Dynamics 365 파일을 설치할 폴더를 지정합니다.

/A

Windows Installer 패키지를 만들어 Outlook용 Dynamics 365의 관리 설치를 생성합니다. 이 패키지는 사용자가 네트워크 공유에서 설치을 실행할 수 있게 하며, 관리자가 아닌 사용자가 그룹 정책으로 제어되는 설치를 실행할 수 있게 합니다. 이 매개 변수는 앞에서 설명한 /targetdir 매개 변수와 함께 사용해야 합니다. 이 매개 변수를 사용할 때는 /targetdir 값이 로컬 컴퓨터에 있지 않아도 무방합니다. 매핑된 드라이브나 네트워크 공유(예: \\share\mscrm_client_admin)를 사용할 수 있습니다.

중요

/targetdir 매개 변수를 사용하여 대상 폴더를 지정하지 않으면 설치에서 관리 설치를 기본 폴더 <drive:> Program Files\Microsoft Dynamics CRM에 설치합니다.

다음 명령을 예로 들 수 있습니다.

Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"

/Q

자동 모드 설치입니다. 이 매개 변수를 사용하려면 XML 형식의 구성 파일이 있어야 합니다./i 매개 변수에는 XML 구성 파일의 이름이 포함됩니다. 대화 상자 또는 오류 메시지가 표시 화면에 나타나지 않습니다. 오류 메시지 정보를 캡처하려면 로그 파일 매개 변수(/L 또는 /LV)를 포함합니다.

/L [drive:][[path] logfilename.log]

설치 작업에 대한 로그 파일을 만듭니다. 로그 파일의 이름과 저장 위치를 지정해야 하지만 경로는 %appdata%\CRMLogs와 같은 상대 경로일 수 없습니다.

/LV [drive:][[path] logfilename.log]

설치 작업에 대한 자세한 로그 파일을 만듭니다. 로그 파일의 이름과 저장 위치를 지정해야 하지만 경로는 %appdata%\CRMLogs와 같은 상대 경로일 수 없습니다.

disableofflinecapability

이 매개 변수를 지정하면 응용 프로그램에서 "오프라인으로 전환" 단추를 숨기도록 Outlook용 Dynamics 365이 구성됩니다. 사용자는 이 단추로 오프라인 기능이 있는 Outlook용 Dynamics 365으로 전환할 수 있습니다.

ignoreofflinequeue

이 매개 변수를 지정하면 설치에서 업그레이드 중에 오프라인 큐에 남아 있을 수 있는 항목을 동기화하지 않습니다.

/X

Outlook용 Dynamics 365을 제거합니다. 응용 프로그램이 이미 설치된 경우에만 사용할 수 있는 유지 관리 모드 옵션입니다.

설치할 Outlook용 Dynamics 365 XML 구성 파일 샘플

다음 구성 파일 예제에서는 오프라인 액세스 기능을 제외하고 Outlook용 Dynamics 365을 Program Files 폴더에 설치합니다.

참고

설치 및 구성 요소를 모두 포함하는 동일한 파일을 사용할 수 있습니다.설치 및 구성 마법사는 해당 작업과 관련되지 않은 요소를 무시합니다.

<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>

2단계: XML 구성 파일을 사용하여 Outlook용 Dynamics 365 구성

Outlook용 Dynamics 365 설치 후에는 구성이 필요합니다. 명령 프롬프트에서 Outlook용 Dynamics 365구성 마법사를 실행하여 구성할 수 있습니다.구성 마법사 파일의 이름은 Microsoft.Crm.Application.Outlook.ConfigWizard.exe이고 Outlook용 Dynamics 365이 설치된 Client\ConfigWizard 폴더에 있습니다. 기본 폴더는 C:\Program Files\Microsoft Dynamics CRM입니다.

참고

Outlook용 Dynamics 365을 실행하는 사용자의 자격 증명이 Microsoft Dynamics 365에 인증하는 데 사용됩니다. 따라서 Outlook용 Dynamics 365의 자동 구성을 수행하려면 사용자의 컨텍스트에서 구성 마법사을 실행해야 합니다. 예를 들어 사용자가 호출하는 배치 파일을 사용하거나 로그온 스크립트에서 한 번 입력할 수 있습니다. 자세한 내용은 구성 마법사 실행 시 사용자 자격 증명 필요을 참조하십시오. Microsoft 그룹 정책을 사용하여 Outlook용 Dynamics 365을 배포하려면 그룹 정책을 사용하여 Outlook용 Microsoft Dynamics 365 배포를 참조하십시오.

구성 파일에 대한 경로를 지정하지 않으면 구성 마법사에서 고정된 프로필 폴더((%localappdata%\Microsoft\MSCRM\)의 기본 구성 파일(default_client_config.xml)을 찾습니다. 고정된 프로필 폴더에 파일이 없으면 구성 마법사에서는 Outlook용 Dynamics 365이 설치된 폴더에서 파일을 찾습니다. 기본적으로 Outlook용 Dynamics 365은 C:\Program Files\Microsoft Dynamics CRM에 설치됩니다.

다른 응용 프로그램에서 사용하는 고정되지 않은 위치(AppData\Roaming\Microsoft\MSCRM\)에 있는 구성 파일은 적용되지 않습니다.

Outlook용 Dynamics 365 구성 명령 예제

다음 명령은 config_client.xml이라는 파일을 사용하여 자동 모드로 Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)을 구성하고 clientinstall.log라는 로그 파일을 출력합니다.

Microsoft.Crm.Application.Outlook.ConfigWizard.exe /Q /i c:\config_client.xml /xa /l c:\clientinstall.log

자동 모드 구성 매개 변수인 /Q 를 사용하려면 XML 형식의 구성 파일이 있어야 합니다. 대화 상자 또는 오류 메시지가 표시 화면에 나타나지 않습니다. 오류 메시지 정보를 캡처하려면 로그 파일 매개 변수(/L) 또는 자세한 로깅 매개 변수(/LV)를 포함합니다.

중요

구성 마법사를 자동 모드에서 실행하려면 Windows 자격 증명 모음에 저장된 유효한 사용자 자격 증명이 필요합니다.추가 정보:구성 마법사 실행 시 사용자 자격 증명 필요

/i [drive:] [[path] configfilename.xml]] 명령줄 매개 변수는 Outlook용 Microsoft Dynamics CRM 설정에 필요한 정보를 제공합니다. 각 설치 화면에서 요구하는 정보와 동일한 정보입니다.XML 요소는 영어(미국)로 되어 있어야 합니다. 특수 문자 또는 확장 문자는 사용할 수 없습니다.XML 요소가 해당 지역 언어로 지역화된 XML 구성 파일은 제대로 작동하지 않습니다. 다음은 각 XML 요소에 대한 설명과 XML 파일 샘플입니다.

/xa 매개 변수를 /q 매개 변수와 함께 사용하면 Outlook용 Dynamics 365에 대해 구성된 모든 조직이 제거됩니다.

/R 매개 변수는 구성 마법사 사용자 인터페이스를 표시하지 않고 진행률 대화 상자만 표시하는 데 사용할 수 있습니다. 이 매개 변수는 이름이 Default_Client_Config.xml이고 로컬 사용자 AppData 또는 클라이언트 설치 폴더에 있어야 하는 유효한 XML설치이 필요합니다.

Outlook용 Dynamics 365 XML 구성 파일 요소

Element(요소)

설명

<Deployments> </Deployments>

구성 파일은 Deployment를 루트 요소로 사용하는 유효한 XML 파일이어야 합니다.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Outlook용 Dynamics 365 설치 유형을 지정합니다.true를 지정하면 Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능) 기능이 설치됩니다.

<TargetDir>drive:\path</TargetDirectory>

Outlook용 Dynamics 365 파일을 설치할 폴더를 지정합니다.

<Deployment> </Deployment>

모든 이후 요소의 상위 요소입니다.

<DiscoveryUrl>https://website:portnumber</DiscoveryUrl>

Microsoft Dynamics 365Discovery Web Service 의 URL을 지정합니다.

Microsoft Dynamics 365 Server의 온-프레미스 배포의 경우 HTTPS 또는 HTTP 바인딩이 지원될 수 있습니다.Discovery Web Service에서 기본 포트인 80(HTTP) 또는 443(HTTPS) 이외의 포트를 사용하는 경우 포트 번호를 지정해야 합니다.Microsoft Dynamics 365 Server의 전체 서버 배포인 경우 Discovery Web Service URL은 웹 응용 프로그램의 URL과 동일합니다(예: http://crmserver ).

Microsoft Dynamics 365(온라인)의 경우 https://orgname.crm.dynamics.com과 같은 전체 조직 URL을 사용하거나, 온라인 환경 및 위치에 따라 https://disco.crm.dynamics.com 형식의 검색 서비스 URL을 사용하십시오.URLs의 목록은 MSDN: 검색 서비스를 참조하십시오.

<FederatedAuthentication>true/false</FederatedAuthentication>

연결된 (Azure Active Directory) 자격 인증이 구성 마법사에서 인증을 위해 사용되는 경우 지정합니다.false를 지정하면 user@contoso.onmicrosoft.com과 같은 자격 증명을 사용할 수 있습니다.

<Organizations> </Organizations>

다음 <조직> 요소의 상위 요소입니다.

<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization>

클라이언트가 연결할 조직의 이름을 지정합니다.

FriendlyName.Outlook에 조직 이름이 아닌 다른 표시 이름을 지정합니다.

IsPrimary.Outlook용 Dynamics 365에서 동기화 조직으로 구성될 조직을 지정합니다.

참고

OrganizationName은 대/소문자를 구분합니다.

<CEIPNotification>true/false</CEIPNotification>

Outlook용 Dynamics 365에서 "사용자 환경 개선 프로그램에 참여하겠습니다." 알림 배너를 표시할지 여부를 지정합니다. 기본 설정은 true이며 알림 배너가 표시됩니다.false로 지정하면 알림 배너가 Outlook용 Dynamics 365에 표시되지 않습니다.추가 정보:Microsoft 사용자 환경 개선 프로그램

구성 마법사 실행 시 사용자 자격 증명 필요

구성 마법사에는 사용자 자격 증명이 필요합니다. 자동 구성 중 Microsoft.Crm.Application.Outlook.ConfigWizard.exe 파일에 /Q를 사용하면 구성 마법사는 Windows 자격 증명 모음에서 사용자의 자격 증명을 찾습니다.구성 마법사에서 자격 증명을 찾지 못하거나 자격 증명이 필요한 형식이 아닌 경우 구성이 완료되지 않고 구성 로그 파일에 오류가 기록됩니다.구성 마법사는 XML 구성 파일에 사용자 UPN 또는 암호를 추가할 수 없습니다. 명령 스크립트에서 Windows 자격 증명 모음으로 사용자 자격 증명을 추가하는 방법에 대한 자세한 내용은 CRM 2011 클레임 가능 환경에서 Outlook용 CRM클라이언트 자동 구성 블로그 게시물을 참조하십시오. Windows 자격 증명 모음 및 자격 증명 관리자에 대한 자세한 내용은 자격 증명 관리자란?을 참조하십시오.

구성할 Outlook용 Dynamics 365 XML 구성 파일 샘플

다음 구성 파일 예제에서는 Outlook용 Dynamics 365에서 crmserver라는 Microsoft Dynamics 365 Server에 있는 Contoso라는 기본 조직 및 AdventureWorksCycle이라는 다른 조직에 연결하도록 구성합니다.

참고

설치 및 구성 요소를 모두 포함하는 동일한 파일을 사용할 수 있습니다.설치 및 구성 마법사는 해당 작업과 관련되지 않은 요소를 무시합니다.

Default_Client_Config.xml 파일 예제

<Deployments>
<Deployment>
<DiscoveryUrl>http://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>

참고

앞의 예제에서는 사용자가 액세스할 수 있는 서로 다른 조직을 지정하고 Outlook용 Dynamics 365에서 "사용자 환경 개선 프로그램에 참여하겠습니다." 알림 배너를 표시하지 않도록 구성합니다.Organization 요소의 값은 특수 문자나 공백을 포함할 수 없습니다.Dynamics 365(온-프레미스)의 경우, Get-CrmOrganization Windows PowerShell cmdlet을 실행하거나 설정 > 사용자 지정 > 개발자 리소스로 이동하여 인스턴스 참조 정보 아래에서 고유 이름을 복사하여 조직의 고유한 이름을 찾을 수 있습니다.

스크립트를 사용하여 Outlook용 Dynamics 365 구성

  1. Outlook용 Dynamics 365 사용자의 구성 설정을 자동으로 업데이트하는 스크립트를 작성할 수 있습니다. 다음과 같은 줄을 사용하면 servername으로 지정된 컴퓨터에 저장된 새 구성 파일을 기반으로 기본적인 구성 작업을 수행할 수 있습니다.

    다음 스크립트에서는 기본 클라이언트 구성 파일을 덮어쓰고, 이전에 구성한 조직을 제거하고, 사용자 자격 증명을 Windows 자격 증명 모음에 추가하고, 새 조직을 설치합니다.

    copy /y \\<servername>\share\Default_Client_Config.xml "c:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"
    "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /xa
    cmdkey /generic:Microsoft_CRM_https://disco.crm.dynamics.com/ /user:user@contoso.com /password{password_goes_here}
    "C:\Program Files\Microsoft Dynamics CRM\Client\ConfigWizard\Microsoft.Crm.Application.Outlook.ConfigWizard.exe" /q /i 
    "C:\Program Files\Microsoft Dynamics CRM\Default_Client_Config.xml"
    

    스크립트를 로그온 스크립트로 실행하거나 특정 시간에 스크립트가 실행되도록 설정해 보십시오. 예를 들어 Microsoft System Center 2012 Configuration Manager을 사용할 수 있습니다.

    스크립트에 클라이언트 컴퓨터가 이미 구성되어 있는지 여부를 확인하는 검색 논리를 포함할 수도 있습니다. 이미 구성된 경우에는 작업을 수행하지 않고 스크립트를 종료할 수 있습니다.

    Default_Client_Config.xml 파일 예제

    <Deployment>
    <DiscoveryUrl>http://CrmDiscoveryUrl</DiscoveryUrl>
    <Organizations>
    <Organization IsPrimary='true'>Organization1</Organization>
    </Organizations>
    </Deployment>
    
  2. 서버가 변경된 조직의 각 클라이언트 컴퓨터에서 스크립트를 실행합니다. ADUC(Active Directory 사용자 및 컴퓨터)의 사용자 속성 대화 상자에 있는 프로필 탭이나 GPO(그룹 정책 개체) 등의 다양한 방법으로 스크립트를 실행할 수 있습니다.

참고 항목

Outlook용 Dynamics 365 설치
Outlook용 Dynamics 365 설정
명령 프롬프트를 사용하여 Microsoft Dynamics CRM Server 설치
Outlook용 Dynamics 365

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