명령 프롬프트를 사용하여 Microsoft Dynamics 365 for Outlook 설치
Microsoft Dynamics 365 for Outlook 설치 절차는 두 단계로 구성됩니다. 먼저, 설치를 실행하여 컴퓨터에 파일을 설치해야 합니다. 그런 다음 Dynamics 365 for Customer Engagement 구성 마법사를 실행하여 응용 프로그램을 구성하고 설치를 완료합니다.
중요
구성 파일의 값과 명령줄 매개 변수의 값이 충돌하는 경우 명령줄 매개 변수가 우선합니다.
1단계: 파일 설치
노트
다운로드 지침은 Dynamics 365 for Outlook 설치를 참조하십시오.
다음 명령은 명령 프롬프트에서 Microsoft Dynamics CRM for Outlook 설치를 실행하는 데 사용할 수 있는 옵션을 보여 줍니다.
Setupclient.exe [/A] [/Q] [/X] [/L 또는 /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Dynamics 365 for Outlook 설치에 대한 명령 예제
여행 중이거나 항상 Dynamics 365 Server에 연결되어 있지 않은 사용자를 위해 Dynamics 365 for Microsoft Office Outlook with Offline Access는 고객 데이터에 대한 액세스를 제공합니다. 자동 모드에서 Dynamics 365 for Microsoft Office Outlook with Offline Access를 설치하려면:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
자동 모드에서 Dynamics 365 for Microsoft Office Outlook with Offline Access를 제거하려면:
SetupClient /x /q
Dynamics 365 for Outlook 설치용 매개 변수
| 매개 변수 | Description |
|---|---|
| 없음 | 매개 변수 없이 사용하면 Setupclient.exe가 전체 표시 화면으로 실행됩니다. |
| installofflinecapability | 오프라인 기능을 설치할지 여부를 결정합니다. 이 매개 변수를 포함하면 오프라인 기능 및 구성 요소가 설치됩니다. 이 매개 변수를 지정하지 않으면 온라인 전용 클라이언트가 설치됩니다. |
| /targetdir <"drive:\path"> | Dynamics 365 for Outlook 파일을 설치할 폴더를 지정합니다. |
| /A | Windows Installer 패키지를 만들어 Dynamics 365 for Outlook의 관리 설치를 생성합니다. 이 패키지를 사용하면 사용자가 네트워크 공유에서 설정을 실행하거나 관리자가 아닌 사용자가 그룹 정책에서 구동되는 설정을 실행할 수 있습니다. 이 매개 변수는 앞에서 설명한 /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 | 이 매개 변수를 지정하면 응용 프로그램에서 "오프라인으로 전환" 단추를 숨기도록 Dynamics 365 for Outlook이 구성됩니다. 사용자는 이 단추로 오프라인 기능이 있는 Dynamics 365 for Outlook으로 전환할 수 있습니다. |
| ignoreofflinequeue | 이 매개 변수를 지정하면 설치 프로그램에서 업그레이드 중에 오프라인 큐에 남아 있을 수 있는 항목을 동기화하지 않습니다. |
| /X | Dynamics 365 for Outlook을 제거합니다. 응용 프로그램이 이미 설치된 경우에만 사용할 수 있는 유지 관리 모드 옵션입니다. |
설치를 위한 Dynamics 365 for Outlook XML 구성 파일 샘플
다음 구성 파일 예제에서는 오프라인 액세스 기능을 제외하고 Dynamics 365 for Outlook을 Program Files 폴더에 설치합니다.
노트
설치 및 구성 요소를 모두 포함하는 동일한 파일을 사용할 수 있습니다. 설치 및 구성 마법사는 작업과 관련이 없는 요소를 무시합니다.
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
2단계: XML 구성 파일을 사용하여 Dynamics 365 for Outlook 구성
Dynamics 365 for Outlook 설치 후에는 구성이 필요합니다. 명령 프롬프트에서 Dynamics 365 for Outlook 구성 마법사를 실행하여 이 작업을 수행할 수 있습니다. 구성 마법사 파일의 이름은 Microsoft.Crm.Application.Outlook.ConfigWizard.exe이며 Dynamics 365 for Outlook이 설치된 Client\ConfigWizard 폴더에 있습니다. 기본적으로 이 위치는 C:\Program Files\Microsoft Dynamics CRM입니다.
노트
Dynamics 365 for Outlook을 실행할 사용자의 자격 증명은 Dynamics 365 for Customer Engagement에 인증하는 데 사용됩니다. 따라서 Dynamics 365 for Outlook의 자동 구성을 수행하려면 사용자가 호출한 배치 파일을 실행하거나 로그온 스크립트의 일회성 항목으로 사용자 컨텍스트에서 구성 마법사를 실행해야 합니다. 자세한 내용은 구성 마법사 실행 시 사용자 자격 증명 필요를 참조하십시오. Microsoft 그룹 정책을 사용하여 Dynamics 365 for Outlook을 배포하려면 그룹 정책을 사용하여 Microsoft Dynamics 365 for Outlook 배포를 참조하십시오.
구성 파일의 경로가 지정되지 않은 경우 구성 마법사는 비로밍 프로필 폴더(%localappdata%\Microsoft\MSCRM\)에서 기본 구성 파일(default_client_config.xml)을 찾습니다. 파일이 비로밍 프로필 폴더에 없으면 구성 마법사는 Dynamics 365 for Outlook이 설치된 폴더를 찾습니다. 기본적으로 Dynamics 365 for Outlook는 C:\Program Files\Microsoft Dynamics CRM 폴더에 설치됩니다.
다른 응용 프로그램에서 사용하는 로밍 위치(AppData\Roaming\Microsoft\MSCRM\)에 있는 구성 파일은 적용되지 않습니다.
Dynamics 365 for Outlook 구성 명령 예제
다음 명령은 config_client.xml이라는 파일을 사용하여 자동 모드로 Microsoft Dynamics 365 for Outlook with Offline Access를 구성하고 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]] 명령줄 매개 변수는 필요한 정보와 함께 Microsoft Dynamics CRM for Outlook 설치 프로그램을 제공합니다. 각 설치 화면에서 요구하는 정보와 동일한 정보입니다. XML 요소는 영어(미국)로 되어 있어야 합니다. 특수 문자 또는 확장 문자를 사용할 수 없습니다. XML 요소가 해당 지역 언어로 지역화된 XML 구성 파일은 제대로 작동하지 않습니다. 다음은 각 XML 요소에 대한 설명과 XML 파일 샘플입니다.
/xa 매개 변수를 /q 매개 변수와 함께 사용하면 Dynamics 365 for Outlook에 대해 구성된 모든 조직이 제거됩니다.
/R 매개 변수는 구성 마법사 사용자 인터페이스를 표시하지 않고 진행률 대화 상자만 표시하는 데 사용할 수 있습니다. 이 매개 변수는 이름이 Default_Client_Config.xml이고, 로컬 사용자 AppData 또는 클라이언트 설치 폴더에 있어야 하는 유효한 XMLSetup 파일이 필요합니다.
Dynamics 365 for Outlook XML 구성 파일 요소
| 요소 | Description |
|---|---|
| <Deployments></Deployments> | 구성 파일은 <배포>를 루트 요소로 사용하는 유효한 XML 파일이어야 합니다. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Dynamics 365 for Outlook 설치 유형을 지정합니다.
true를 지정하면 Microsoft Dynamics 365 for Outlook with Offline Access 기능이 설치됩니다. |
| <TargetDir>drive:\path</TargetDirectory> | Dynamics 365 for Outlook 파일을 설치할 폴더를 지정합니다. |
| <Deployment></Deployment> | 모든 이후 요소의 상위 요소입니다. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Dynamics 365 for Customer Engagement Discovery 웹 서비스의 URL을 지정합니다. Dynamics 365 for Customer Engagement의 경우 https://orgname.crm.dynamics.com과 같은 전체 조직 URL을 사용하거나, 온라인 환경 및 위치에 따라 양식 https://disco.crm.dynamics.com의 검색 서비스 URL을 사용하십시오. URL의 목록은 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. Dynamics 365 for Outlook에서 동기화 조직으로 구성될 조직을 지정합니다. 참고:OrganizationName은 대소문자를 구분합니다. |
| <CEIPNotification>true/false</CEIPNotification> | Dynamics 365 for Outlook에서 "사용자 환경 개선 프로그램에 참여하겠습니다." 알림 배너를 표시할지 여부를 지정합니다. 기본 설정은 true이며 알림 배너가 표시됩니다.
false로 지정하면 알림 배너가 Dynamics 365 for Outlook에 표시되지 않습니다. 추가 정보: Microsoft 고객 환경 개선 프로그램 |
구성 마법사 실행 시 사용자 자격 증명 필요
구성 마법사에는 사용자 자격 증명이 필요합니다. 자동 구성 중 Microsoft.Crm.Application.Outlook.ConfigWizard.exe 파일에 /Q를 사용하면 구성 마법사는 Windows 자격 증명 모음에서 사용자의 자격 증명을 찾습니다. 구성 마법사에서 자격 증명을 찾지 못하거나 자격 증명이 필요한 형식이 아닌 경우 구성이 완료되지 않고 구성 로그 파일에 오류가 기록됩니다. 구성 마법사는 XML 구성 파일에 사용자 UPN 또는 암호를 추가할 수 없습니다. Windows 자격 증명 모음 및 자격 증명 관리자에 대한 자세한 내용은 자격 증명 관리자란?을 참조하십시오.
구성을 위한 Dynamics 365 for Outlook XML 구성 파일 샘플
다음 구성 파일 예제에서는 crmserver라는 Dynamics 365 Server에서 Contoso라는 기본 조직과 AdventureWorksCycle이라는 다른 조직에 연결하도록 Dynamics 365 for Outlook을 구성합니다.
노트
설치 및 구성 요소를 모두 포함하는 동일한 파일을 사용할 수 있습니다. 설치 및 구성 마법사는 작업과 관련이 없는 요소를 무시합니다.
Default_Client_Config.xml 파일 예제
<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
노트
앞의 예제에서는 사용자가 액세스할 수 있는 서로 다른 조직을 지정하고 Dynamics 365 for Outlook에서 "사용자 환경 개선 프로그램에 참여하겠습니다." 알림 배너를 표시하지 않도록 구성합니다.
Organization 요소의 값은 특수 문자나 공백을 포함할 수 없습니다. Customer Engagement (on-premises)의 경우 Get-CrmOrganization Windows PowerShell cmdlet을 실행하거나 설정>사용자 지정>개발자 리소스로 이동하여 인스턴스 참조 정보 아래에서 고유 이름을 복사하여 조직 고유 이름을 찾을 수 있습니다.
스크립트를 사용하여 Dynamics 365 for Outlook 구성
Dynamics 365 for Outlook 사용자의 구성 설정을 자동으로 업데이트하는 스크립트를 작성할 수 있습니다. 다음과 같은 줄을 사용하면 <
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>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>서버가 변경된 조직의 각 클라이언트 컴퓨터에서 스크립트를 실행합니다. ADUC(Active Directory 사용자 및 컴퓨터)에 있는 사용자 속성 대화 상자의 프로필 탭을 통하거나 GPO(그룹 정책 개체)를 통하는 등 다양한 방법으로 스크립트를 실행할 수 있습니다.