Compartilhar via

Instale o Microsoft Dynamics CRM para Outlook usando um prompt de comando

  • Artigo

 

Publicado: julho de 2016

Aplicável a: Dynamics CRM 2015

A instalação do Microsoft Dynamics CRM para Outlook é um procedimento de duas etapas. Primeiro, é necessário executar o Programa de Instalação para instalar os arquivos no computador. Em seguida, execute o Assistente de Configuração do Microsoft Dynamics CRM para configurar o aplicativo e concluir a instalação.

Importante

Se houver um conflito entre um valor no arquivo de configuração e um valor nos parâmetros de linha de comando, os parâmetros de linha de comando terão prioridade.

Neste tópico

Etapa 1: Instalar arquivos

Etapa 2: Configurar o CRM para Outlook usando um arquivo de configuração XML

Exemplos de comando para a configuração do CRM para Outlook

Elementos do arquivo de configuração XML do CRM para Outlook

As credenciais de usuário são necessárias ao executar o Assistente de Configuração

Arquivo de configuração XML de exemplo do CRM para Outlook para configuração

Etapa 1: Instalar arquivos

O comando a seguir exibe as opções disponíveis para executar a Instalação do Microsoft Dynamics CRM para Outlook no prompt de comando:

Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[unidade:][[ caminho] nomearquivolog.log]"] [/targetdir "[unidade:][ caminho]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Exemplos de comando para a instalação do CRM para Outlook

Para usuários que viajam ou que nem sempre estão conectados ao Microsoft Dynamics CRM Server, o Microsoft Dynamics CRM para Microsoft Office Outlook com Acesso Offline permite acesso a seus dados de cliente. Para instalar o Microsoft Dynamics CRM para Microsoft Office Outlook com Acesso Offline no modo silencioso:

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

Para desinstalar o Microsoft Dynamics CRM para Microsoft Office Outlook com Acesso Offline no modo silencioso:

SetupClient /x /q

Parâmetros para a instalação do CRM para Outlook

Parâmetro

Descrição

Nenhum(a)

Se for usado sem parâmetros, o Setupclient.exe passará por todas as telas de exibição.

installofflinecapability

Determina se a funcionalidade offline será instalada. Ao incluir esse parâmetro, a funcionalidade e os componentes offline são instalados. Caso esse parâmetro não seja especificado, somente o cliente online é instalado.

/targetdir <"drive:\path">

Especifica a pasta na qual os arquivos do Dynamics CRM para Outlook serão instalados.

/A

Gera uma instalação administrativa do Dynamics CRM para Outlook criando um pacote do Windows Installer. Esse pacote permite que os usuários executem a Instalação de um compartilhamento de rede ou que usuários não administrativos executem a Instalação derivada de uma política de grupo. Esse parâmetro deve ser usado com o parâmetro /targetdir descrito anteriormente. Quando esse parâmetro é usado, o valor /targetdir não precisa estar no computador local. É possível usar uma unidade mapeada ou um compartilhamento de rede, como \\share\mscrm_client_admin.

Importante

Se você não especificar uma pasta de destino usando o parâmetro /targetdir, o Instalação instala a instalação administrativa para a pasta padrão <drive:> Program Files\Microsoft Dynamics CRM.

Por exemplo, o comando:

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

/Q

Instalação em modo silencioso. Esse parâmetro requer um arquivo de configuração em formato XML. O parâmetro /iinclui o nome do arquivo de configuração XML. Nenhuma caixa de diálogo ou mensagem de erro será mostrada na tela de exibição. Para capturar as informações das mensagens de erro, inclua o parâmetro de arquivo de log (/L ou /LV).

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

Cria um arquivo de log da atividade de instalação. Especifique o nome do arquivo de log e o local para armazená-lo; porém, o caminho não pode ser relativo, como %appdata%\CRMLogs.

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

Cria um arquivo de log detalhado da atividade de instalação. Especifique o nome do arquivo de log e o local para armazená-lo; porém, o caminho não pode ser relativo, como %appdata%\CRMLogs.

disableofflinecapability

Quando você especifica esse parâmetro, o Dynamics CRM para Outlook é configurado para ocultar o botão "ficar offline" no aplicativo. Esse botão permite que os usuários alternem para o Dynamics CRM para Outlook com a funcionalidade offline.

ignoreofflinequeue

Quando você especifica esse parâmetro, a Instalação não tenta sincronizar os itens que possam permanecer na fila offline durante a atualização.

/X

Desinstala o Dynamics CRM para Outlook. Esta é uma opção de modo de manutenção disponível apenas quando o aplicativo já está instalado.

Arquivo de configuração XML de exemplo do CRM para Outlook para instalação

O seguinte arquivo de configuração de exemplo instala o Dynamics CRM para Outlook, sem o recurso de acesso offline, na pasta Arquivos de Programas.

Observação

É possível usar o mesmo arquivo que inclui os dois elementos de instalação e configuração. A Instalação e o Assistente de Configuração ignoram os elementos irrelevantes à operação.

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

Etapa 2: Configurar o CRM para Outlook usando um arquivo de configuração XML

Após instalar o Dynamics CRM para Outlook, você deverá configurá-lo. Faça isso executando o Dynamics CRM para OutlookAssistente de Configuração no prompt de comando. O arquivo do Assistente de Configuração é chamado Microsoft.Crm.Application.Outlook.ConfigWizard.exe e está localizado na pasta Client\ConfigWizard onde o Dynamics CRM para Outlook é instalado. Por padrão, a pasta é C:\Program Files\Microsoft Dynamics CRM.

Observação

As credenciais do usuário que executará o Dynamics CRM para Outlook são usadas para autenticação no Microsoft Dynamics CRM. Portanto, para realizar uma configuração silenciosa do Dynamics CRM para Outlook, você deve executar o Assistente de Configuração no contexto do usuário; por exemplo, executando um arquivo em lotes invocado pelo usuário ou como uma entrada única em um script de logon. Para obter mais informações, consulte As credenciais de usuário são necessárias ao executar o Assistente de Configuração. Para implantar o Dynamics CRM para Outlook usando a Política de Grupo da Microsoft , consulte Implantar o Microsoft Dynamics CRM para Outlook usando políticas de grupo.

Quando não é especificado o caminho para o arquivo de configuração, o Assistente de Configuração procura pelo arquivo de configuração padrão (default_client_config.xml) na pasta do perfil sem roaming (%localappdata%\Microsoft\MSCRM\). Caso o arquivo não esteja localizado na pasta de perfil não roaming, o Assistente de Configuração procurará pela pasta no local em que o Dynamics CRM para Outlook estiver instalado. Por padrão, o C:\Program Files\Microsoft Dynamics CRM é instalado na pasta Dynamics CRM para Outlook.

Caso o arquivo de configuração esteja em um local de roaming usado por outros aplicativos (AppData\Roaming\Microsoft\MSCRM\), ele não será aceito.

Exemplos de comando para a configuração do CRM para Outlook

O comando a seguir configura o Microsoft Dynamics CRM para Outlook com Acesso Offline usando um arquivo chamado config_client.xml em modo silencioso e tem como saída um arquivo de log chamado clientinstall.log:

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

O parâmetro de configuração do modo silencioso /Q exige um arquivo de configuração no formato XML. Nenhuma caixa de diálogo ou mensagem de erro será mostrada na tela de exibição. Para capturar informações sobre a mensagem de erro, inclua o parâmetro de arquivo de log (/L) ou de log detalhado (/LV).

Importante

As credenciais de usuário válidas armazenadas no Cofre do Windows são necessárias para executar o Assistente de Configuração no modo silencioso.Para obter mais informações:As credenciais de usuário são necessárias ao executar o Assistente de Configuração

O parâmetro de linha de comando /i [unidade:] [[caminho]nomearquivolog.xml*]] fornece as informações necessárias à*Instalação do Microsoft Dynamics CRM para Outlook com as informações obrigatórias. São as mesmas informações exigidas em cada uma das telas de instalação. Os elementos XML devem estar em inglês (EUA); não é possível usar caracteres especiais nem estendidos. Arquivos de configuração XML que contenham elementos traduzidos não funcionarão corretamente. Veja a seguir uma explicação sobre cada elemento XML e um arquivo XML de exemplo:

Quando o parâmetro /xa é usado com o parâmetro /q, ele remove todas as organizações que estiverem configuradas para o Dynamics CRM para Outlook.

O parâmetro /R pode ser usado para suprimir a interface do usuário de Assistente de Configuração e exibir apenas a caixa de diálogo andamento. Esse parâmetro requer um arquivo XMLInstalação válido com o nome Default_Client_Config.xml e deve ser localizado na pasta sites AppData ou na pasta de instalação do Cliente.

Elementos do arquivo de configuração XML do CRM para Outlook

Elemento

Descrição

<Deployments> </Deployments>

O arquivo de configuração deve ser um arquivo XML válido que use <Deployment> como o elemento raiz.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Especifica o tipo de instalação do Dynamics CRM para Outlook. A especificação de true instalará o recurso Microsoft Dynamics CRM para Outlook com Acesso Offline.

<TargetDir>drive:\path</TargetDirectory>

Especifica a pasta na qual os arquivos do Dynamics CRM para Outlook serão instalados.

<Deployment> </Deployment>

Elemento pai de todos os elementos a seguir.

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

Especifica a URL para o Microsoft Dynamics CRMServiço Web de Descoberta .

Para uma implantação local do Microsoft Dynamics CRM Server, a associação suportada pode ser HTTPS ou HTTP. Se o Serviço Web de Descoberta estiver usando uma porta diferente das portas 80 (HTTP) ou 443 (HTTPS), você deverá especificar o número da porta. Se esta é uma implantação de servidor completo do Microsoft Dynamics CRM Server, a URL do Serviço Web de Descoberta é a mesma que a do aplicativo Web, como http://crmserver .

Para Microsoft Dynamics CRM Online, use a URL completa da organização, como https://orgname.crm.dynamics.com ou, dependendo de seu ambiente online e local, use a URL do serviço de descoberta, no formulário https://disco.crm.dynamics.com. Para obter uma lista de URLs, consulte MSDN: serviço de Descoberta.

<Organizations> </Organizations>

É o elemento pai para a <Organization> seguinte.

<Organization FriendlyName="Meu Nome amigável da organização" IsPrimary="true"/"false">OrganizationName</Organization>

Especifica o nome da organização à qual o cliente se conectará.

FriendlyName. Especifica um nome para exibição diferente do nome da organização no Outlook.

IsPrimary. Especifica a organização que será configurada como a organização de sincronização no Dynamics CRM para Outlook.

Observação

OrganizationName faz distinção entre maiúsculas e minúsculas.

<CEIPNotification>true/false</CEIPNotification>

Especifica se Dynamics CRM para Outlook exibirá o banner de notificação "Eu desejo participar do Programa de aperfeiçoamento de experiência do cliente”. A configuração padrão é true e o banner de notificação é exibido. Se você especificar false, o banner de notificação não aparece em Dynamics CRM para Outlook.Para obter mais informações:Programa de Aperfeiçoamento da Experiência do Usuário da Microsoft

As credenciais de usuário são necessárias ao executar o Assistente de Configuração

O Assistente de Configuração exige credencias do usuário. Durante uma configuração silenciosa, usando o /Q com o arquivo Microsoft.Crm.Application.Outlook.ConfigWizard.exe, o Assistente de Configuração procurará pelas credenciais de usuário no Cofre do Windows. Se o Assistente de Configuração não pode encontrar as credenciais ou as credenciais não estão no formato necessário, a configuração não será concluída e um erro será registrado no arquivo de log da configuração. Observe que o Assistente de Configuração não oferece suporte à adição do UPN do usuário ou senha no arquivo de configuração XML. Para obter mais informações sobre como adicionar credenciais de um script de comando para o Cofre do Windows, consulte o post de blog Configuração silenciosa do cliente CRM para Outlook em um ambiente habilitado para declarações do CRM 2011. Para obter mais informações sobre o Gerenciador de Credenciais e o Cofre do Windows, consulte O que é Gerenciador de Credenciais

Arquivo de configuração XML de exemplo do CRM para Outlook para configuração

O seguinte arquivo de configuração de exemplo define o Dynamics CRM para Outlook para se conectar a uma organização primária chamada Contoso e a uma outra organização chamada AdventureWorksCycle no Microsoft Dynamics CRM Server denominado crmserver.

Observação

É possível usar o mesmo arquivo que inclui os dois elementos de instalação e configuração. A Instalação e o Assistente de Configuração ignoram os elementos irrelevantes à operação.

Arquivo Default_Client_Config.xml de exemplo

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

Observação

O exemplo anterior especifica duas organizações diferentes às quais o usuário tem acesso e configura Dynamics CRM para Outlook para não exibir o banner de notificação “Não desejo participar do programa de aperfeiçoamento de experiência do cliente”. O valor no elemento Organizationnão pode ter nenhum caractere especial nem espaço. Para Microsoft Dynamics CRM (local), é possível localizar o nome exclusivo da organização ao executar o cmdlet Windows PowerShellGet-CrmOrganization ou na coluna de Nome na área Organizações de Gerenciador de Implantação.

Configurar o CRM para Outlook usando um scrip

  1. Gere um script que atualize automaticamente as definições de configuração para os usuários do Dynamics CRM para Outlook. É possível usar linhas, como as que estão mostradas a seguir, para executar ações básicas de configuração, com base em um novo arquivo de configuração armazenado no computador indicado como <servername>.

    No script a seguir, o arquivo de configuração do cliente padrão é substituído, as organizações já configuradas são removidas, as credenciais do usuário são adicionadas ao Cofre do Windows e a nova organização é instalada.

    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://contoso.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"

    Dica

    Considere executar o seu script como um script de logon ou forçar a execução do script em determinado horário; por exemplo, usando o Microsoft System Center 2012 Configuration Manager.

    No script, convém também incluir a lógica de detecção que determina se o computador cliente já foi configurado. Em caso afirmativo, você poderá fazer com que o script saia sem executar nenhuma ação.

    Arquivo Default_Client_Config.xml de exemplo

    <Deployment>
<DiscoveryUrl>http://CrmDiscoveryUrl</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Organization1</Organization>
</Organizations>
</Deployment>

  2. Execute o script em cada computador cliente na organização cujo servidor foi alterado. É possível executar o script de várias maneiras, inclusive pela guia Perfil da caixa de diálogo de propriedades do usuário nos Usuários e Computadores do Active Directory (ADUC) ou pelos Objetos de Política de Grupo (GPO).

Confira Também

Configurar o CRM para Outlook
Instalar Microsoft Dynamics CRM Server usando um prompt de comando
CRM para Outlook

© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos autorais