コマンド プロンプトを使用した Microsoft Dynamics 365 for Outlook のインストール
Microsoft Dynamics 365 for Outlook のインストールは 2 つの手順で行います。 まず、セットアップを実行してファイルをコンピュータにインストールする必要があります。 次に、Dynamics 365 for Customer Engagement 構成ウィザードを実行してアプリケーションを構成し、インストールを完了します。
重要
構成ファイルとコマンドライン パラメーターの値が異なる場合は、コマンドライン パラメーターが優先されます。
手順 1: ファイルのインストール
Note
ダウンロードの方法については、 Dynamics 365 for Outlook のインストール を参照してください。
次のコマンドにより、コマンド プロンプトで Microsoft Dynamics CRM for Outlookセットアップを実行するときに使用できるオプションを表示できます。
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Dynamics 365 for Outlook をインストールするためのコマンド例
外出先にいるときや、Dynamics 365 Server に常時接続できないユーザーも、オフラインアクセスでの Dynamics 365 for Microsoft Office Outlook によって顧客データにアクセスできます。 サイレントモードで、オフラインアクセスで Dynamics 365 for Microsoft Office Outlook をインストールするには
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
サイレントモードで、オフラインアクセスで Dynamics 365 for Microsoft Office Outlook をアンインストールするには
SetupClient /x /q
Dynamics 365 for Outlook をインストールするためパラメーター
| パラメーター | 説明設定 |
|---|---|
| なし | パラメーターを指定しないと、ディスプレイの画面全体を使用して Setupclient.exe が実行されます。 |
| installofflinecapability | オフライン機能をインストールするかどうかを指定します。 このパラメーターを使用するとき、オフライン機能とコンポーネントがインストールされます。 このパラメーターを指定しない場合、オンライン専用クライアントがインストールされます。 |
| /targetdir <"drive:\path"> | Dynamics 365 for Outlook ファイルがインストールされるフォルダーを指定します。 |
| /A | Windows インストーラー パッケージを作成することによって、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 構成ファイル
次の構成ファイルのサンプルでは、Program Files フォルダーへのオフライン アクセス機能を与えずに Dynamics 365 for Outlook をインストールします。
Note
インストールおよび構成の両方の要素を含む同じファイルを使用できます。 セットアップと構成ウィザードは、処理に関係しない要素は無視します。
<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 koussinを実行することでこれをおこなえます。 構成ファイルは Microsoft.Crm.Application.Outlook.ConfigWizard.exe という名前が付けられ、Dynamics 365 for Outlook がインストールされる Client\ConfigWizard フォルダーに置かれます。 既定では、このフォルダーは C:\Program Files\Microsoft Dynamics CRMです。
Note
Dynamics 365 for Outlook を実行するユーザーの資格情報は、Dynamics 365 for Customer Engagement での認証に使用されます。 そのため、Dynamics 365 for Outlook の自動構成を行うには、構成ウィザードをユーザーのコンテキストで実行する必要があります (ユーザー呼び出しのバッチ ファイルの実行またはログオン スクリプト内のワンタイム エントリとするなど)。 詳細については、ユーザーの資格情報は、構成ウィザードを実行するときに必要ですを参照してください。 Microsoft グループ ポリシーを使用して Dynamics 365 for Outlook を展開するには、グループ ポリシーを使用した Microsoft Dynamics 365 for Outlook の展開を参照してください。
構成ファイルのパスが指定されない場合、構成ウィザードは既定の構成ファイル (default_client_config.xml) を非移動ユーザー プロファイル フォルダー (%localappdata%\Microsoft\MSCRM\) で探します。 非移動ユーザー プロファイル フォルダーにファイルがない場合、構成ウィザードは 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 を構成し、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 [ドライブ:] [[パス] configfilename.xml]] コマンドライン パラメーターは、Microsoft Dynamics CRM for Outlook Setupに必要な情報を提供します。 この情報は、各インストール画面で必要な情報と同じです。 XML 要素は米国英語である必要があり、特殊文字および拡張文字は使用することができません。 XML 要素がローカライズされている XML 構成ファイルは正常に動作しません。 各 XML 要素の説明と XML ファイルのサンプルを次に示します。
/xa パラメーターを /q パラメーターと共に使用すると、Dynamics 365 for Outlook で構成されているすべての組織が削除されます。
/R パラメーターを使用すると、構成ウィザード ユーザー インターフェイスを表示しないで、進行ダイアログ ボックスのみを表示することができます。 このパラメーターには、ローカル ユーザーの AppData またはクライアントのインストール フォルダーに置く必要がある、Default_Client_Config.xml という名前の有効な XML セットアップ ファイルが必要です。
Dynamics 365 for Outlook XML 構成ファイル要素
| 要素 | 説明設定 |
|---|---|
| <Deployments></Deployments> | 構成ファイルは、ルート要素として <Deployment> を使用する有効な XML ファイルである必要があります。 |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Dynamics 365 for Outlook のインストールの種類を指定します。 true を指定すると、オフライン アクセス機能の Microsoft Dynamics 365 for Outlook をインストールできます。 |
| <TargetDir>drive:\path</TargetDirectory> | Dynamics 365 for Outlook ファイルがインストールされるフォルダーを指定します。 |
| <Deployment></Deployment> | 以下のすべての要素の親要素です。 |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Dynamics 365 for Customer EngagementDiscovery Web サービスの URL を指定します。 Dynamics 365 for Customer Engagementの場合は、 https://orgname.crm.dynamics.com などの完全な組織URLを使用するか、オンライン 環境 と場所に応じて、フォームに検出サービスURLを使用します https://disco.crm.dynamics.com。 URL のリストについては、MSDN: 探索サービスを参照してください。 |
| <FederatedAuthentication>true/false</FederatedAuthentication> | 構成ウィザードでの認証にフェデレーション (Azure Active Directory) 資格情報を使用するかどうかを指定します。 false を指定する場合、user@contoso.onmicrosoft.com などの資格情報を使用できます。 |
| <Organizations></Organizations> | 以下の <Organization> 要素の親要素です。 |
| <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 カスタマー エクスペリエンス向上プログラム |
ユーザーの資格情報は、構成ウィザードを実行するときに必要です
構成ウィザードはユーザーの資格情報が必要です。 自動構成中に、/Q を Microsoft.Crm.Application.Outlook.ConfigWizard.exe ファイルと共に使用して、構成ウィザードは Windows の保管サービス内のユーザー資格情報を検索します。 構成ウィザードが資格情報を検索できないか、資格情報が指定された形式ではない場合、構成は完了せず、エラーが構成ログ ファイルに記録されます。 構成ウィザードが、ユーザー UPN またはパスワードの XML 構成ファイルへの追加をサポートしていないことに注意してください。 Windows の保管サービスおよび資格情報マネージャーの詳細については、「資格情報マネージャーとは」を参照してください。
Dynamics 365 for Outlook XML 構成ファイルのサンプル
次の構成ファイルのサンプルでは、Contoso という名前のプライマリ組織、および、crmserver という名前の Dynamics 365 Server 上にある AdventureWorksCycle という名前の別の組織に接続するように Dynamics 365 for Outlook を構成しています。
Note
インストールおよび構成の両方の要素を含む同じファイルを使用できます。 セットアップと構成ウィザードは、処理に関係しない要素は無視します。
サンプルの 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>
Note
前述のサンプルでは、ユーザーがアクセスできる 2 つの別々の組織を指定し、“カスタマー エクスペリエンス向上プログラムに参加します” 通知バナーを表示しないように 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 構成マネージャーなどを使用して、スクリプトをログオン スクリプトとして実行するか、特定の時刻に強制的に実行することを検討してください。
このスクリプトには、クライアント コンピューターが構成済みであるかどうかを判断する検出ロジックを含めることもできます。 構成済みである場合は、操作を行わずにスプリプトを終了できます。
サンプルの Default_Client_Config.xml ファイル
<Deployment> <DiscoveryUrl>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>サーバーが変更された組織内の各クライアント コンピューターでスクリプトを実行します。 スクリプトはさまざまな方法で実行できます。たとえば、Active Directory Users and Computers (ADUC) のユーザー プロパティ ダイアログ ボックスの プロファイル タブを使用する方法や、グループ ポリシー オブジェクト (GPO) を使用する方法があります。