Instalar o Microsoft Dynamics 365 for Outlook usando um prompt de comando
A instalação do Microsoft Dynamics 365 for 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 Dynamics 365 for Customer Engagement 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.
Etapa 1: Instalar arquivos
Nota
Consulte Instalar o Dynamics 365 for 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 for Outlook no prompt de comando:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Exemplos de comando para instalação do Dynamics 365 for Outlook
Para usuários que viajam ou que nem sempre estão conectados ao Dynamics 365 Server, o Dynamics 365 for Microsoft Office Outlook com Acesso Offline permite acesso a seus dados de cliente. Para instalar o Dynamics 365 for Microsoft Office Outlook com Acesso Offline em modo silencioso:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
Para desinstalar o Dynamics 365 for Microsoft Office Outlook com Acesso Offline em modo silencioso:
SetupClient /x /q
Parâmetros para instalação do Dynamics 365 for 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 for Outlook serão instalados. |
| /A | Gera uma instalação administrativa do Dynamics 365 for 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, a Instalação executará a instalação administrativa na pasta padrão <unidade:> 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 /i contém 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 [unidade:][[caminho] nomearquivolog.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 [unidade:][[caminho] nomearquivolog.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 for Outlook é configurado para ocultar o botão "ficar offline" no aplicativo. Esse botão permite que os usuários alternem para o Dynamics 365 for 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 for 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 Dynamics 365 for Outlook para instalação
O seguinte arquivo de configuração de exemplo instala o Dynamics 365 for Outlook, sem o recurso de acesso offline, na pasta Arquivos de Programas.
Nota
É 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 Dynamics 365 for Outlook usando um arquivo de configuração XML
Após instalar o Dynamics 365 for Outlook, você deverá configurá-lo. Você pode fazer isso executando o Assistente de Configuração do Dynamics 365 for Outlook no prompt de comando. O arquivo do Assistente de Configuração chama-se Microsoft.Crm.Application.Outlook.ConfigWizard.exe e está localizado na pasta Client\ConfigWizard, em que o Dynamics 365 for Outlook foi instalado. Por padrão, a pasta é C:\Program Files\Microsoft Dynamics CRM.
Nota
As credenciais do usuário que executará o Dynamics 365 for Outlook são usadas para autenticação no Dynamics 365 for Customer Engagement. Portanto, para realizar uma configuração silenciosa do Dynamics 365 for 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 for Outlook usando a Política de Grupo da Microsoft, consulte Implantar o Microsoft Dynamics 365 for Outlook usando a Política de Grupo.
Caso não seja especificado o caminho para o arquivo de configuração, o Assistente de Configuração procurará o arquivo de configuração padrão (default_client_config.xml) na pasta de perfil não 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 for Outlook estiver instalado. Por padrão, o Dynamics 365 for Outlook é instalado na pasta c:\Program Files\Microsoft Dynamics CRM.
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 for Outlook
O comando a seguir configura o Microsoft Dynamics 365 for 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. Mais informações: As credenciais de usuário são necessárias ao executar o Assistente de Configuração
O parâmetro /i [drive:] [[path] configfilename.xml]] command-line fornece as informações necessárias à Instalação do Microsoft Dynamics CRM for 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 for Outlook.
O parâmetro /R pode ser usado para suprimir a interface do usuário do Assistente de Configuração e exibir apenas a caixa de diálogo andamento. Esse parâmetro requer um arquivo XMLSetup 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 for Outlook
| Elemento | Descrição |
|---|---|
| <Deployments></Deployments> | O arquivo de configuração deve ser um arquivo XML válido que use <Implantação> como o elemento raiz. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Especifica o tipo de instalação do Dynamics 365 for Outlook. Especificar true instala o Microsoft Dynamics 365 for Outlook com capacidade de Acesso Offline. |
| <TargetDir>drive:\path</TargetDirectory> | Especifica a pasta na qual os arquivos do Dynamics 365 for Outlook serão instalados. |
| <Deployment></Deployment> | Elemento pai de todos os elementos a seguir. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Especifica a URL para o Serviço Web de Descoberta do Dynamics 365 for Customer Engagement. Para o Dynamics 365 for Customer Engagement, use a URL completa da organização, como https://orgname.crm.dynamics.com, ou, dependendo do seu ambiente online e localização, 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 (Azure Active Directory) são usadas para autenticação no Assistente de Configuração. Se você especificar false, pode usar credenciais como user@contoso.onmicrosoft.com. |
| <Organizations></Organizations> | É o elemento pai para o elemento <Organização> a seguir. |
| <Organization FriendlyName="My Friendly Organization Name" 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 for Outlook. Observação: OrganizationName diferencia maiúsculas e minúsculas. |
| <CEIPNotification>true/false</CEIPNotification> | Especifica se Dynamics 365 for 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 for Outlook. Mais informações: Programa de Aperfeiçoamento da Experiência do Cliente da Microsoft |
As credenciais de usuário são necessárias ao executar o Assistente de Configuração
O Assistente de Configuração precisa de credenciais de usuário. Durante uma configuração silenciosa, usando /Q com o arquivo Microsoft.Crm.Application.Outlook.ConfigWizard.exe, o Assistente de Configuração procurará as credenciais do usuário no Cofre do Windows. Se o Assistente de Configuração não encontrar as credenciais ou as credenciais não estiverem 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 o Gerenciador de Credenciais e o Cofre do Windows, consulte O que é Gerenciador de Credenciais
Arquivo de configuração XML de exemplo do Dynamics 365 for Outlook XML para configuração
O seguinte arquivo de configuração de exemplo define o Dynamics 365 for Outlook para se conectar a uma organização primária chamada Contoso e a uma outra organização chamada AdventureWorksCycle no Dynamics 365 Server denominado crmserver.
Nota
É 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 ignora os elementos irrelevantes à operação.
Arquivo Default_Client_Config.xml de exemplo
<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</Organization>
<Organization>AdventureWorksCycle</Organization>
</Organizations>
<CEIPNotification>false</CEIPNotification>
</Deployment>
</Deployments>
Nota
O exemplo anterior especifica duas organizações diferentes às quais o usuário tem acesso e configura Dynamics 365 for 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 Customer Engagement (on-premises), é possível localizar o nome exclusivo da organização executando o cmdlet Get-CrmOrganization do Windows PowerShell ou vá para Configurações>Personalizações>Recursos do Desenvolvedor e, em Informações de Referência da Instância copie o Nome Exclusivo.
Configurar o Dynamics 365 for Outlook usando um script
Gere um script que atualize automaticamente as definições de configuração para os usuários do Dynamics 365 for 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"Gorjeta
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>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>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 em Usuários e Computadores do Active Directory (ADUC) ou pelos Objetos de Política de Grupo (GPO).