Compartilhar via

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

  • Artigo

 

Publicado: fevereiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

A instalação do Microsoft Dynamics 365 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 365 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 Dynamics 365 para Outlook usando um arquivo de configuração XML

Exemplos de comando para a configuração do Dynamics 365 para Outlook

Elementos do arquivo de configuração XML do Dynamics 365 para Outlook

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

Exemplo de arquivo de configuração XML do Dynamics 365 para Outlook para configuração

Etapa 1: Instalar arquivos

Dica

Consulte Instalar Dynamics 365 para Outlook para obter instruções de download.

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] logfilename.log]"] [/targetdir "[unidade:][ caminho]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Exemplos de comando para a instalação do Dynamics 365 para Outlook

Para usuários que viajam ou que nem sempre estão conectados ao Servidor do Microsoft Dynamics 365, o Microsoft Dynamics 365 para Microsoft Office Outlook com Acesso Offline permite acesso a seus dados de cliente. Para instalar o Microsoft Dynamics 365 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 365 para Microsoft Office Outlook com Acesso Offline no modo silencioso:

SetupClient /x /q

Parâmetros para a instalação do Dynamics 365 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 365 para Outlook serão instalados.

/A

Gera uma instalação administrativa do Dynamics 365 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 365 para Outlook é configurado para ocultar o botão "ficar offline" no aplicativo. Esse botão permite que os usuários alternem para o Dynamics 365 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 365 para Outlook. Esta é uma opção de modo de manutenção disponível apenas quando o aplicativo já está instalado.

Exemplo de arquivo de configuração XML do Dynamics 365 para Outlook para instalação

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

Dica

É 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 Dynamics 365 para Outlook usando um arquivo de configuração XML

Após instalar o Dynamics 365 para Outlook, você deverá configurá-lo. Faça isso executando o Dynamics 365 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 365 para Outlook é instalado. Por padrão, a pasta é C:\Program Files\Microsoft Dynamics CRM.

Dica

As credenciais do usuário que executará o Dynamics 365 para Outlook são usadas para autenticação no Microsoft Dynamics 365. Portanto, para realizar uma configuração silenciosa do Dynamics 365 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 365 para Outlook usando a Política de Grupo da Microsoft , consulte Implantar o Microsoft Dynamics 365 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 365 para Outlook estiver instalado. Por padrão, o C:\Program Files\Microsoft Dynamics CRM é instalado na pasta Dynamics 365 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 Dynamics 365 para Outlook

O comando a seguir configura o Microsoft Dynamics 365 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] configfilename.xml]] fornece as informações necessárias ao Instalação do Microsoft Dynamics CRM para Outlook. 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 365 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 Dynamics 365 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 365 para Outlook. A especificação de true instalará o recurso Microsoft Dynamics 365 para Outlook com Acesso Offline.

<TargetDir>drive:\path</TargetDirectory>

Especifica a pasta na qual os arquivos do Dynamics 365 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 365Serviço Web de Descoberta .

Para uma implantação local do Servidor do Microsoft Dynamics 365, 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 Servidor do Microsoft Dynamics 365, a URL do Serviço Web de Descoberta é a mesma que a do aplicativo Web, como http://crmserver .

Para Microsoft Dynamics 365 (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.

<FederatedAuthentication>true/false</FederatedAuthentication>

Especifica se as credenciais federadas (Active Directory do Azure) são usadas para autenticação Assistente de Configuração. Se você especificar false, você pode usar como user@contoso.onmicrosoft.com credenciais.

<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 365 para Outlook.

Dica

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

<CEIPNotification>true/false</CEIPNotification>

Especifica se Dynamics 365 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 365 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

Exemplo de arquivo de configuração XML do Dynamics 365 para Outlook para configuração

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

Dica

É 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'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>

Dica

O exemplo anterior especifica duas organizações diferentes às quais o usuário tem acesso e configura Dynamics 365 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 o Dynamics 365 (local), é possível localizar o nome exclusivo do cmdlet Get-CrmOrganization do Windows PowerShell ou acessar Configurações > Personalizações > Recursos do Desenvolvedor e, em Informações de Referência da Instância, copiar o Nome Exclusivo.

Configurar o Dynamics 365 para Outlook usando um script

  1. Gere um script que atualize automaticamente as definições de configuração para os usuários do Dynamics 365 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://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"

    Observação

    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

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

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais