Instalar o Microsoft Dynamics 365 for Outlook utilizando uma linha de comandos
Instalar o Microsoft Dynamics 365 for Outlook é um procedimento de dois passos. Primeiro, tem de executar a configuração para instalar os ficheiros para o computador. De seguida, execute o Assistente de Configuração do Dynamics 365 for Customer Engagement para configurar a aplicação e conclua a instalação.
Importante
Se existir um conflito introduza um valor no ficheiro de configuração e um valor na linha de comandos, na linha de comandos parâmetro da precedência.
Passo 1: Instalar ficheiros
Nota
Consulte Instalar o Dynamics 365 for Outlook para obter instruções de transferência.
O comando seguinte apresenta as opções disponíveis para executar a Configuração do Microsoft Dynamics CRM for Outlook na linha de comandos:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Exemplos de comandos para instalação do Dynamics 365 for Outlook
Para os utilizadores que viajam ou que não são sempre ligados ao Dynamics 365 Server, o Dynamics 365 for Microsoft Office Outlook com Acesso Offline fornece acesso aos dados dos clientes. 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 | Utilizado sem parâmetros, Setupclient.exe será executado com todos os ecrãs de apresentação. |
| installofflinecapability | Determina se a capacidade offline será instalada. Quando parâmetro, este inclui a capacidade offline e os componentes estão instalados. Se não especificar o parâmetro, o cliente apenas online é instalado. |
| /targetdir <"drive:\path"> | Especifica a pasta onde os ficheiros de Dynamics 365 for Outlook serão instalados. |
| /A | Criar uma instalação administrativa de Dynamics 365 for Outlook criar um pacote Windows installer. Este pacote permite que os utilizadores execute a Configuração a partir de uma partilha de rede ou permite que os utilizadores não administrativos executem a Configuração orientada a partir de uma política de grupo. Este parâmetro tem de ser utilizada com o parâmetro de /targetdir descrito anteriormente. Ao utilizar este parâmetro, o valor de /targetdir não tenha de ser localizada no computador local. Uma unidade mapeada ou um partilha de rede, tal como \\share\mscrm_client_admin, pode ser utilizada.
Importante: se não especificar uma pasta de destino utilizando o parâmetro /targetdir, a Configuração instala a instalação administrativa para a pasta predefinida <unidade:> Programas\Microsoft Dynamics CRM. Por exemplo, o comando: Setupclient /Q /A /targetdir "\\share\mscrm_client_admin" |
| /Q | Instalação no modo silencioso. Este parâmetro requer um ficheiro de configuração no formato XML. O parâmetro /i contém o nome do ficheiro de configuração XML. Nenhuma caixa de diálogo ou mensagem de erro aparece no ecrã de apresentação. Para capturar informações de mensagem de erro, inclua o parâmetro do ficheiro de registo (/L ou /LV). |
| /L [drive:][[path] logfilename.log] | Criar um ficheiro de registo de atividade de configuração. Tem de especificar o nome do ficheiro do ficheiro de registo e onde colocá-lo, mas o caminho não pode ser um caminho relativo, tal como %appdata%\CRMLogs. |
| /LV [drive:][[path] logfilename.log] | Criar um ficheiro de registo verboso de atividade de configuração. Tem de especificar o nome do ficheiro do ficheiro de registo e onde colocá-lo, mas o caminho não pode ser um caminho relativo, tal como %appdata%\CRMLogs. |
| disableofflinecapability | Quando especifica o parâmetro, Dynamics 365 for Outlook está configurado para ocultar “trabalhar offline” botão na aplicação. Este botão mudar permite aos utilizadores a Dynamics 365 for Outlook com capacidade offline. |
| ignoreofflinequeue | Quando especifica o parâmetro, a Configuração não irá tentar sincronizar os itens que podem permanecer na fila offline durante a atualização. |
| /X | Desinstalar o Dynamics 365 for Outlook. Esta é uma opção de modo de manutenção que só estão disponíveis quando a aplicação já está instalada. |
Amostra de ficheiro de configuração XML Dynamics 365 for Outlook para instalação
O seguinte exemplo configuração- ficheiro de instalação Dynamics 365 for Outlook sem capacidade de acesso offline na pasta de ficheiros do programa.
Nota
Poderá utilizar o mesmo ficheiro que inclui os elementos da instalação e da configuração. A Configuração e o Assistente de Configuração irão ignorar os elementos que não são relevantes para a operação.
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
Passo 2: Configurar o Dynamics 365 for Outlook utilizando um ficheiro de configuração XML
Depois de instalar o Dynamics 365 for Outlook, tem de o configurar. Pode fazê-lo executando o Assistente de Configuração do Dynamics 365 for Outlook na linha de comandos. O ficheiro do Assistente de Configuração é denominado Microsoft.Crm.Application.Outlook.ConfigWizard.exe e está localizado na pasta Client\ConfigWizard, onde o Dynamics 365 for Outlook está instalado. Por predefinição, a pasta é C:\Program Files\Microsoft Dynamics CRM.
Nota
As credenciais do utilizador que executa o Dynamics 365 for Outlook são utilizadas para autenticar para o Dynamics 365 for Customer Engagement. Consequentemente, efetuar uma configuração de silenciosa do Dynamics 365 for Outlook, tem de executar o Assistente de Configuração no contexto de utilizador, como efetuar um ficheiro do que invocado ou como um único entrada num script de início de sessão. Para obter mais informações, consulte As credenciais do utilizador quando são necessárias para executar o Assistente de Configuração. Para implementar o Dynamics 365 for Outlook utilizando a Política de Grupo da Microsoft, consulte Implementar o Microsoft Dynamics 365 for Outlook utilizando a Política de Grupo.
Se um caminho para o ficheiro de configuração não for especificado, o Assistente de Configuração procura pelo ficheiro de configuração predefinido (default_client_config.xml) na pasta de perfil não itinerante (%localappdata%\Microsoft\MSCRM\). Se o ficheiro não está localizado na pasta não vagueando de perfil, o Assistente de Configuração procura a pasta onde o Dynamics 365 for Outlook está instalado. Por predefinição, o Dynamics 365 for Outlook é instalado na pasta C:\Program Files\Microsoft Dynamics CRM.
Se o ficheiro de configuração está localizado na localização itinerante utilizada por outras aplicações (AppData\Roaming\Microsoft\MSCRM\), não será honrado.
Exemplos de comandos para configuração do Dynamics 365 for Outlook
O comando seguinte configura o Microsoft Dynamics 365 for Outlook com Acesso Offline utilizando um ficheiro chamado config_client.xml no modo quieto e cria um ficheiro de registo denominado 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 requer um ficheiro de configuração no formato XML. Nenhuma caixa de diálogo ou mensagem de erro aparece no ecrã de apresentação. Para capturar informações de mensagem de erro, inclua o parâmetro do ficheiro de registo (/L) ou registo verboso (/LV).
Importante
As credenciais do utilizador válido cofre armazenadas no Windows são necessários para executar o Assistente de Configuração em modo silencioso. Mais informações: As credenciais do utilizador quando são necessárias para executar o Assistente de Configuração
O parâmetro de linha de comandos /i [unidade:] [[caminho] configfilename.xml]] fornece as informações necessárias à Configuração do Microsoft Dynamics CRM for Outlook. É as mesmas informações que cada ecrã de configuração necessita. Os elementos XML devem ser escritos em inglês (EUA); os caracteres especiais ou expandidos não podem ser utilizados. Um ficheiro de configuração XML com elementos XML localizados não irá funcionar corretamente. Explicação de cada elemento XML e um ficheiro XML de exemplo seguinte:
O parâmetro /xa, quando utilizado com o parâmetro /q, remove todas as organizações que estão configuradas para Dynamics 365 for Outlook.
O parâmetro /R pode ser utilizado para eliminar uma interface de utilizador do Assistente de Configuração e apresentar apenas a caixa de diálogo progresso. Este parâmetro requer um ficheiro XMLSetup válido do denominado Default_Client_Config.xml e tem de estar localizado na pasta AppData do utilizador local ou da configuração do cliente.
Elementos do ficheiro de configuração XML do Dynamics 365 for Outlook
| Elemento | Descrição |
|---|---|
| <Deployments></Deployments> | O ficheiro de configuração tem de ser um ficheiro XML válido que utilize <Deployment> como o elemento de raiz. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Especifica o tipo de instalação do Dynamics 365 for Outlook. A especificação true instalará o Microsoft Dynamics 365 for Outlook com capacidade de Acesso Offline. |
| <TargetDir>drive:\path</TargetDirectory> | Especifica a pasta onde os ficheiros de Dynamics 365 for Outlook serão instalados. |
| <Deployment></Deployment> | Elemento principal para os elementos de monitorização. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Especifica o URL para o Serviço Web de Deteção do Dynamics 365 for Customer Engagement. Para Dynamics 365 para o Customer Engagement, use a URL completa da organização, como https://orgname.crm.dynamics.com, ou dependendo do 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 URL, consulte MSDN: Serviço de deteção. |
| <FederatedAuthentication>true/false</FederatedAuthentication> | Especifica se as credenciais federadas (Azure Active Directory) são utilizadas para autenticação no Assistente de Configuração. Se especificar false, poderá utilizar credenciais, como user@contoso.onmicrosoft.com. |
| <Organizations></Organizations> | Este é o elemento principal para o seguintes elemento <Organization>. |
| <Organization FriendlyName="O Meu Nome Amigável da Organização" IsPrimary="true"/"false">OrganizationName</Organization> | Especifica o nome da organização a que o cliente irá ligar. FriendlyName. Especifica outro nome a apresentar diferente do nome da organização no Outlook. IsPrimary. Especifica a organização que será configurado como a organização de sincronização em Dynamics 365 for Outlook. Nota:OrganizationName é sensível às maiúsculas e minúsculas. |
| <CEIPNotification>true/false</CEIPNotification> | Especifica se Dynamics 365 for Outlook apresenta a faixa de notificação "Quero aderir ao programa de melhoramento da experiência do cliente”. A predefinição é true e sinalizador de notificação é apresentada. Se especificar false, o sinalizador de notificação não aparece em Dynamics 365 for Outlook. Mais informações: Programa de Melhoramento da Experiência do Cliente da Microsoft |
As credenciais do utilizador quando são necessárias para executar o assistente de configuração
O Assistente de Configuração requer credenciais de utilizador. Durante a configuração silenciosa, utilizando /Q com o ficheiro Microsoft.Crm.Application.Outlook.ConfigWizard.exe, o Assistente de Configuração procurará as credenciais do utilizador no Cofre Windows. Se o Assistente de Configuração não conseguir 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á efetuado para o ficheiro de registo de configuração. Repare que o Assistente de Configuração não suporta a adição de UPN de utilizador ou palavra-passe do ficheiro de configuração XML. Para mais informações sobre o cofre e de credenciais do Windows, consulte Novidades do gestor
Amostra de ficheiro de configuração XML do Dynamics 365 for Outlook XML para configuração
O seguinte ficheiro de configuração de exemplo configura o Dynamics 365 for Outlook para ligar a uma organização primária e chamada Contoso e outra organização chamada AdventureWorksCycle no Dynamics 365 Server que é chamada crmserver.
Nota
Poderá utilizar o mesmo ficheiro que inclui os elementos da instalação e da configuração. A Configuração e o Assistente de Configuração irão ignorar os elementos que não são relevantes para a operação.
Ficheiro de exemplo 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>
Nota
Especifica o exemplo anterior duas organizações diferentes que o utilizador tem acesso a Dynamics 365 for Outlook para configurar e não apresentar “se pretender associar sinalizador de notificação do programa de melhoramento da experiência do cliente”. O valor no elemento de Organization não pode conter caracteres especiais ou espaços. Para o Customer Engagement (on-premises), poderá encontrar o nome exclusivo da organização ao executar o cmdlet Get-CrmOrganization do Windows PowerShell ou ir a Definições>Personalizações>Recursos para Programadores e, em Informações de Referência da Instância, copie o Nome Exclusivo.
Configurar o Dynamics 365 for Outlook com um script
Escrever um script que atualize automaticamente as definições de configuração para utilizadores de Dynamics 365 for Outlook. Pode utilizar linhas, como as seguintes, para efetuar as ações de configuração básica, com base num ficheiro de configuração novo que é armazenado no computador apresentado como <
servername>.O seguinte script, o ficheiro de configuração de cliente predefinido substituídas, as organizações anteriormente são removidas configuradas, as credenciais do utilizador são adicionadas a cofre Windows e, a nova organização está instalado.
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 a executar o script como um script de início de sessão, ou forçando o script para ser executado a uma hora específica, por utilização do Gestor de Configuração do Microsoft System Center 2012.
No script, também poderá pretender incluir lógica de deteção de duplicados que determina se o computador cliente já tiver sido configurado. Se tiver, poderá ter de sair script sem efectuar a ação.
Ficheiro de exemplo Default_Client_Config.xml
<Deployment> <DiscoveryUrl>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>Execute o script em cada computador cliente cujo organização no servidor foi alterado. Pode executar o script em várias formas, incluindo através de Perfil separador da caixa de diálogo propriedades de utilizador em Utilizadores e Computadores do Active Directory (ADUC) ou nos objetos de (GPO) política de grupo.