Instalar o Microsoft Dynamics CRM para Outlook utilizando uma linha de comandos
Publicado: julho de 2016
Aplica-se A: Dynamics CRM 2015
Instalar procedimentos Microsoft Dynamics CRM para Outlook é um procedimento de dois passos. Primeiro, tem de executar a configuração para instalar os ficheiros para o computador. Em seguida, execute o Microsoft Dynamics CRMAssistente de Configuração para configurar a aplicação e concluir 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.
Neste Tópico
Passo 1: Instalar ficheiros
Passo 2: Configurar CRM para Outlook utilizando um ficheiro de configuração XML
Exemplos de comandos para configuração do CRM para Outlook
Elementos do ficheiro de configuração XML do CRM para Outlook
As credenciais do utilizador quando são necessárias para executar o assistente de configuração
Ficheiro de configuração de exemplo do CRM para Outlook
Passo 1: Instalar ficheiros
O comando seguinte apresenta as opções disponíveis para efetuar Configuração do Microsoft Dynamics CRM para Outlook na linha de comandos:
Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[unidade:][[ caminho] logfilename.log]"] [/targetdir "[unidade:][ caminho]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Exemplos de comandos para instalação do CRM para Outlook
Para os utilizadores que viajam ou que não são sempre ligados a Microsoft Dynamics CRM Server, Microsoft Dynamics CRM para Microsoft Office Outlook com Acesso Offline fornece acesso aos dados dos clientes. 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 instalação do CRM para 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 CRM para Outlook serão instalados. |
/A |
Criar uma instalação administrativa de Dynamics CRM para 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 parte da unidade mapeada ou de rede, tal como \\share\mscrm_client_admin pode ser utilizada. Importante Se não especificar uma pasta de destino utilizando o parâmetro de /targetdir, o Configuração instala a instalação administrativa para a pasta predefinida <drive: > Program Files\Microsoft Dynamics CRM. Por exemplo, o comando:
|
/Q |
Instalação no modo silencioso. Este parâmetro requer um ficheiro de configuração no formato XML. O parâmetro de /i contiver o nome XML do ficheiro de configuração. 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 de registo e o colocar no caminho, mas não pode ser um caminho relacionado, 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 de registo e o colocar no caminho, mas não pode ser um caminho relacionado, tal como %appdata%\CRMLogs. |
disableofflinecapability |
Quando especifica o parâmetro, Dynamics CRM para Outlook está configurado para ocultar “trabalhar offline” botão na aplicação. Este botão mudar permite aos utilizadores a Dynamics CRM para Outlook com capacidade offline. |
ignoreofflinequeue |
Quando especifica o parâmetro, Configuração não irá tentar sincronizar os itens que podem permanecer na fila offline durante a atualização. |
/X |
Desinstalar o Dynamics CRM para Outlook. Esta é uma opção de modo de manutenção que só estão disponíveis quando a aplicação já está instalada. |
Exemplo de CRM para o ficheiro de configuração XML da configuração para Outlook
O seguinte exemplo configuração- ficheiro de instalação Dynamics CRM para 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. O Configuração e o Assistente de Configuração ignoram 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 CRM para Outlook utilizando um ficheiro de configuração XML
Depois de instalar o Dynamics CRM para Outlook, tem de o configurar. Poderá efetuar este passo ao executar o Assistente de Configuração do Dynamics CRM para Outlookna linha de comandos. O ficheiro de Assistente de Configuração é denominado Microsoft.Crm.Application.Outlook.ConfigWizard.exe e localizado na Client\ConfigWizard pasta onde Dynamics CRM para Outlook está instalado. Por predefinição, a pasta é C:\Program Files\Microsoft Dynamics CRM.
Nota
As credenciais do utilizador que execute Dynamics CRM para Outlook são utilizadas para autenticar a Microsoft Dynamics CRM. Consequentemente, efetuar uma configuração de Dynamics CRM para Outlooksilenciosa, tem de executar Assistente de Configuração no contexto de utilizador, como efectuar um ficheiro do que invocado ou como um único entrada num script de início de sessão. Para mais informações, consulte As credenciais do utilizador quando são necessárias para executar o assistente de configuração. Para distribuir através do Microsoft Dynamics CRM para Outlook agrupar a política, consulte Implementar o Microsoft Dynamics CRM para Outlook utilizando a Política de Grupo.
Se um caminho para o ficheiro de configuração não for especificado, Assistente de Configuração procura o ficheiro de configuração predefinido (default_client_config.xml) na pasta não itinerante de perfil (%localappdata%\Microsoft\MSCRM\). Se o ficheiro não está localizado na pasta não vagueando de perfil, Assistente de Configuração procura a pasta onde Dynamics CRM para Outlook está instalado. Por predefinição, o Dynamics CRM para 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 CRM para Outlook
O comando seguinte configura o Microsoft Dynamics CRM para 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 efetuar Assistente de Configuração no modo quieto.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 ao Configuração do Microsoft Dynamics CRM para 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 CRM para Outlook.
O parâmetro /R pode ser utilizado para eliminar uma interface de utilizador de Assistente de Configuração e apresentar apenas a caixa de diálogo progresso. Este parâmetro requer um ficheiro de ConfiguraçãoXML válido denominado Default_Client_Config.xml e tem de ser localizado nos AppData do utilizador local ou na pasta de instalação do Cliente.
Elementos do ficheiro de configuração XML do CRM para Outlook
Elemento |
Descrição |
---|---|
<Deployments> </Deployments> |
O ficheiro de configuração tem de ser um ficheiro válido XML <Deployment > como o elemento raiz. |
<InstallOfflineCapability>true/false</InstallOfflineCapability> |
Especifica o tipo de instalação do Dynamics CRM para Outlook. Especificar true instalar a capacidade de Microsoft Dynamics CRM para Outlook com Acesso Offline. |
<TargetDir>drive:\path</TargetDirectory> |
Especifica a pasta onde os ficheiros de Dynamics CRM para Outlook serão instalados. |
<Deployment> </Deployment> |
Elemento principal para os elementos de monitorização. |
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> |
Especifica o URL do Microsoft Dynamics CRMServiço Web de Deteção. Para uma implementação no local de Microsoft Dynamics CRM Server, o vínculo suportado pode ser HTTP ou HTTPS. Se o Serviço Web de Deteção estiver a utilizar uma porta diferente das portas 80 (HTTP) ou 443 (HTTPS) predefinidas, tem de especificar um número de porta. Se esta for uma implementação de servidor completa de Microsoft Dynamics CRM Server, o URL de Serviço Web de Deteção é o mesmo que o para a aplicação web, como http://crmserver . Para Microsoft Dynamics CRM Online, utilize a organização completa URLcomo https://orgname.crm.dynamics.com, ou, dependendo do ambiente e a localização online, utilize o serviço de deteção URL, no formulário https://disco.crm.dynamics.com. Para obter uma lista de URLs, consulte MSDN: Serviço de deteção. |
<Organizations> </Organizations> |
Este é o elemento principal para os seguintes elementos <Organization > |
<Organization FriendlyName="Nome Amigável da Minha 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 em Outlook. IsPrimary. Especifica a organização que será configurado como a organização de sincronização em Dynamics CRM para Outlook. Nota OrganizationName é sensível às maiusculas e minúsculas. |
<CEIPNotification>true/false</CEIPNotification> |
Especifica se Dynamics CRM para 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 CRM para 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
Assistente de Configuração exige credenciais de utilizador. Durante a configuração silenciosa, utilizando /Q com Microsoft.Crm.Application.Outlook.ConfigWizard.exe o ficheiro, 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 Assistente de Configuração não suporta a adição de UPN utilizador ou palavra-passe do XML ficheiro de configuração. Para obter informações sobre como adicionar credenciais de utilizador de um script de comandos para cofre Windows, consulte a A configuração do CRM automática do cliente do Outlook para o CRM 2011 para o ambiente reivindicaçõesmensagem no blogue. Para mais informações sobre o cofre e de credenciais do Windows, consulte Novidades do gestor
Ficheiro de configuração de exemplo do CRM para Outlook
O seguinte exemplo do ficheiro de configuração para configurar Dynamics CRM para Outlook ligar a uma organização primária e chamada Contoso a outra organização em Microsoft Dynamics CRM Server chamada AdventureWorksCycle que é chamada crmserver.
Nota
Poderá utilizar o mesmo ficheiro que inclui os elementos da instalação e da configuração. O 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>http://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Constoso</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 CRM para 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 Microsoft Dynamics CRM (local), pode localizar o nome exclusivo da organização executar o cmdlet de Windows PowerShell de introdução - CrmOrganization ou na coluna de Nome na área de Organizações de Gestor de Implementação.
Configurar CRM para Outlook utilizando um script
Escrever um script que atualize automaticamente as definições de configuração para utilizadores de Dynamics CRM para Outlook. Pode utilizar itens como o seguinte 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://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 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 de 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>http://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.
Consulte Também
Configurar o CRM para Outlook
Install Microsoft Dynamics CRM Server by using a command prompt
CRM para Outlook
© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos de Autor