Condividi tramite

Installare Microsoft Dynamics CRM per Outlook mediante un prompt dei comandi

  • Articolo

 

Data di pubblicazione: luglio 2016

Si applica a: Dynamics CRM 2015

L'installazione di Microsoft Dynamics CRM per Outlook si svolge in due fasi. In primo luogo è necessario eseguire il programma di installazione per installare i file nel computer. Successivamente, eseguire la Microsoft Dynamics CRMConfigurazione guidata per configurare l'applicazione e completare l'installazione.

Importante

In caso di conflitto tra un valore specificato nel file di configurazione e un valore specificato nei parametri della riga di comando, quest'ultimo assume la precedenza.

In questo argomento

Passaggio 1: Installare i file

Passaggio 2: Configurare CRM per Outlook utilizzando un file di configurazione XML

Esempi di comandi per la configurazione di CRM per Outlook

CRM per gli elementi del file di configurazione XML di Outlook

Le credenziali utente sono necessarie quando si esegue la Configurazione guidata.

Esempio di file di configurazione XML per la configurazione di CRM per Outlook

Passaggio 1: Installare i file

Il comando seguente consente di visualizzare le opzioni disponibili per eseguire Installazione di Microsoft Dynamics CRM per Outlook al prompt dei comandi:

Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[unità:][[ percorso] nomefileregistro.log]"] [/targetdir "[unità:][ percorso]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Esempi di comandi per l'installazione di CRM per Outlook

Con Microsoft Dynamics CRM per Microsoft Office Outlook con accesso offline gli utenti che viaggiano o che non sono sempre connessi al Server Microsoft Dynamics CRM possono comunque accedere ai propri dati personali. Per installare Microsoft Dynamics CRM per Microsoft Office Outlook con accesso offline in modalità non interattiva:

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

Per disinstallare Microsoft Dynamics CRM per Microsoft Office Outlook con accesso offline in modalità non interattiva:

SetupClient /x /q

Parametri per l'installazione di CRM per Outlook

Parametro

Descrizione

Nessuno

Utilizzato senza parametri, Setupclient.exe verrà eseguito con tutte le schermate.

installofflinecapability

Determina se installare le funzionalità per l'accesso offline. Quando si specifica questo parametro, vengono installate le funzionalità e i componenti per l'accesso offline. Se questo parametro non viene specificato, verrà installato solo il client online.

/targetdir <"drive:\path">

Specifica la cartella in cui verranno installati i file di Dynamics CRM per Outlook.

/A

Crea un'installazione amministrativa di Dynamics CRM per Outlook creando un pacchetto di Windows Installer. Il pacchetto consente agli utenti di eseguire il programma di Configurazione da una condivisione di rete oppure consente agli utenti che non dispongono dei privilegi di amministratore di eseguire il programma di Configurazione in base ai Criteri di gruppo. Questo parametro deve essere utilizzato con il parametro /targetdir descritto in precedenza. Quando si utilizza questo parametro, il valore di /targetdir non deve trovarsi nel computer locale. È possibile utilizzare un'unità mappata o una condivisione di rete, ad esempio \\condivisione\mscrm_client_admin.

Importante

Se non si specifica una cartella di destinazione utilizzando il parametro /targetdir, l'Configurazione amministrativa verrà installata nella cartella predefinita <unità:> Program Files\Microsoft Dynamics CRM.

Ad esempio, il comando:

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

/Q

Installazione in modalità non interattiva. Questo parametro richiede un file di configurazione in formato XML. Il parametro /i contiene il nome del file di configurazione XML. Non vengono visualizzate finestre di dialogo o messaggi di errore. Per acquisire le informazioni dei messaggi di errore, includere il parametro per il file di registro (/L o /LV).

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

Crea un file di registro delle operazioni di installazione. È necessario specificare il nome del file di registro e il percorso in cui memorizzarlo, ma non è possibile utilizzare un percorso relativo, come %appdata%\CRMLogs.

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

Crea un file di registro dettagliato delle operazioni di installazione. È necessario specificare il nome del file di registro e il percorso in cui memorizzarlo, ma non è possibile utilizzare un percorso relativo, come %appdata%\CRMLogs.

disableofflinecapability

Quando si specifica questo parametro, Dynamics CRM per Outlook viene configurato in modo da nascondere il pulsante per l'accesso offline nell'applicazione. Tale pulsante consente agli utenti di passare a Dynamics CRM per Outlook con funzionalità offline.

ignoreofflinequeue

Quando si specifica questo parametro, durante l'Configurazione non verrà tentata la sincronizzazione degli elementi che possono restare nella coda offline durante l'aggiornamento.

/X

Disinstalla Dynamics CRM per Outlook. Questa è un'opzione della modalità di manutenzione ed è disponibile solo quando l'applicazione è già installata.

Esempio di file di configurazione XML per l'installazione di CRM per Outlook

Il file di configurazione di esempio seguente consente di installare Dynamics CRM per Outlook senza funzionalità per l'accesso offline nella cartella Programmi.

Nota

È possibile utilizzare uno stesso file contenente sia gli elementi di installazione che quelli di configurazione. Il programma di Configurazione e la Configurazione guidata ignorano gli elementi non rilevanti per le rispettive operazioni.

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

Passaggio 2: Configurare CRM per Outlook utilizzando un file di configurazione XML

Dopo aver installato Dynamics CRM per Outlook, è necessario configurarlo. A questo scopo è possibile eseguire la Dynamics CRM per OutlookConfigurazione guidata al prompt dei comandi. Il file per la Configurazione guidata è denominato Microsoft.Crm.Application.Outlook.ConfigWizard.exe ed è ubicato nella cartella Client\ConfigWizard in cui è stato installato Dynamics CRM per Outlook. Per impostazione predefinita, la cartella è C:\Program Files\Microsoft Dynamics CRM.

Nota

Le credenziali dell'utente che eseguirà Dynamics CRM per Outlook vengono utilizzate per l'autenticazione in Microsoft Dynamics CRM. Per eseguire una configurazione invisibile di Dynamics CRM per Outlook, è necessario eseguire Configurazione guidata nel contesto dell'utente, ad esempio utilizzando un file batch richiamato dall'utente o come voce una tantum in uno script di accesso. Per ulteriori informazioni, vedere Le credenziali utente sono necessarie quando si esegue la Configurazione guidata.. Per distribuire Dynamics CRM per Outlook utilizzando Criteri di gruppo Microsoft, vedere Distribuire Microsoft Dynamics CRM per Outlook tramite Criteri di gruppo.

Se il percorso del file di configurazione non viene specificato, la Configurazione guidata cerca il file di configurazione predefinito (default_client_config.xml) nella cartella del profilo non mobile (%localappdata%\Microsoft\MSCRM\). Se il file non è presente nella cartella del profilo non mobile, nella Configurazione guidata verrà effettuata la ricerca della cartella di installazione di Dynamics CRM per Outlook. Per impostazione predefinita, il Dynamics CRM per Outlook è installato nella cartella C:\Program Files\Microsoft Dynamics CRM.

Se il file di configurazione si trova nel percorso di roaming utilizzato da altre applicazioni (AppData\Roaming\Microsoft\MSCRM\), non verrà considerato.

Esempi di comandi per la configurazione di CRM per Outlook

Il comando seguente configura Microsoft Dynamics CRM per Outlook con accesso offline utilizzando un file denominato config_client.xml in modalità non interattiva e produce un file di registro denominato clientinstall.log:

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

Il parametro /Q per la configurazione della modalità non interattiva richiede un file di configurazione in formato XML. Non vengono visualizzate finestre di dialogo o messaggi di errore. Per acquisire le informazioni dei messaggi di errore, includere il parametro per il file di registro (/L) o per la registrazione dettagliata(/LV).

Importante

Le credenziali utente valide archiviate nell'insieme di credenziali Windows sono necessarie per l'esecuzione di Configurazione guidata in modalità non interattiva.Ulteriori informazioni:Le credenziali utente sono necessarie quando si esegue la Configurazione guidata.

Il parametro della riga di comando /i [unità:] [[percorso] configfilename.xml]] fornisce le informazioni necessarie a Installazione di Microsoft Dynamics CRM per Outlook. Sono le stesse informazioni che vengono richieste nelle singole schermate di installazione. Gli elementi XML devono essere in inglese (USA) e non possono contenere caratteri estesi o speciali. Un file di configurazione XML con elementi XML tradotti non funziona correttamente. Di seguito vengono descritti i singoli elementi XML e viene illustrato un file XML di esempio:

Se utilizzato con il parametro /q, il parametro /xa rimuove tutte le organizzazioni configurate per Dynamics CRM per Outlook.

È possibile utilizzare il parametro /R per eliminare l'interfaccia utente della Configurazione guidata e visualizzare solo la finestra di dialogo stato. Questo parametro richiede un file ConfigurazioneXML valido denominato Default_Client_Config.xml che si trova nella cartella dell'utente locale AppData o nella cartella di installazione Client.

CRM per gli elementi del file di configurazione XML di Outlook

Elemento

Descrizione

<Deployments> </Deployments>

Il file di configurazione deve essere un file XML valido che utilizza <Deployment> come elemento radice.

<InstallOfflineCapability>true/false</InstallOfflineCapability>

Specifica il tipo di installazione di Dynamics CRM per Outlook. Se si specifica true, verrà installata la funzionalità Microsoft Dynamics CRM per Outlook con accesso offline.

<TargetDir>drive:\path</TargetDirectory>

Specifica la cartella in cui verranno installati i file di Dynamics CRM per Outlook.

<Deployment> </Deployment>

Elemento padre di tutti gli elementi seguenti.

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

Specifica l'URL del di Microsoft Dynamics CRMServizio Web di individuazione.

Per una distribuzione locale di Server Microsoft Dynamics CRM, le associazioni supportate possono essere HTTPS o HTTP. Se il Servizio Web di individuazione utilizza una porta diversa da quella predefinita (80 per l'HTTP o 443 per l'HTTPS), sarà necessario specificare il numero di porta. Se si esegue una distribuzione di server completo di Server Microsoft Dynamics CRM, l'URL del Servizio Web di individuazione è lo stesso di quello dell'applicazione Web, ad esempio http://crmserver .

Per Microsoft Dynamics CRM Online, utilizzare l'URL dell'organizzazione completo, ad esempio https://orgname.crm.dynamics.com, o in base al proprio ambiente e posizione online, utilizzare l'URL del servizio di individuazione, nel modulo https://disco.crm.dynamics.com. Per un elenco di URLs, vedere MSDN: Servizio di individuazione.

<Organizations> </Organizations>

È l'elemento padre dell'elemento <Organization> seguente.

<Organization FriendlyName="Nome descrittivo dell'organizzazione" IsPrimary="true"/"false">NomeOrganizzazione</Organization>

Specifica il nome dell'organizzazione a cui si connetterà il client.

FriendlyName. Specifica un nome visualizzato diverso dal nome dell'organizzazione in Outlook.

IsPrimary. Specifica l'organizzazione che verrà configurata come organizzazione di sincronizzazione in Dynamics CRM per Outlook.

Nota

In NomeOrganizzazione è rilevante la distinzione tra maiuscole e minuscole.

<CEIPNotification>true/false</CEIPNotification>

Specifica se Dynamics CRM per Outlook visualizzerà il banner di notifica "Desidero partecipare al programma Analisi utilizzo software". Il valore predefinito è true e il banner di notifica viene visualizzato. Se si specifica false, il banner di notifica non viene visualizzato in Dynamics CRM per Outlook.Ulteriori informazioni:Programma Analisi utilizzo software Microsoft

Le credenziali utente sono necessarie quando si esegue la Configurazione guidata.

Configurazione guidata richiede le credenziali utente. Durante una configurazione non interattiva, se si utilizza /Q con il file Microsoft.Crm.Application.Outlook.ConfigWizard.exe, la Configurazione guidata eseguirà la ricerca delle credenziali utente nell'insieme di credenziali Windows. Se Configurazione guidata non è in grado di trovare le credenziali o se le credenziali non sono nel formato richiesto, la configurazione non verrà completata e un errore verrà registrato nel file di registro di configurazione. Si noti che la Configurazione guidata non supporta l'aggiunta del nome UPN o della password dell'utente nel file di configurazione XML. Per informazioni su come aggiungere le credenziali utente in uno script di comando all'insieme di credenziali Windows, vedere il post di blog relativo alla configurazione non interattiva di CRM per il client Outlook in ambienti abilitati alle attestazioni di CRM 2011. Per ulteriori informazioni sull'insieme di credenziali Windows e su Gestione credenziali, vedere Che cos'è Gestione credenziali?

Esempio di file di configurazione XML per la configurazione di CRM per Outlook

Nel seguente esempio di file di configurazione Dynamics CRM per Outlook viene configurato per la connessione a un'organizzazione primaria denominata Contoso e a un'ulteriore organizzazione denominata AdventureWorksCycle nel Server Microsoft Dynamics CRM denominato crmserver.

Nota

È possibile utilizzare uno stesso file contenente sia gli elementi di installazione che quelli di configurazione. Il programma di Configurazione e la Configurazione guidata ignorano gli elementi non rilevanti per le rispettive operazioni.

File Default_Client_Config.xml di esempio

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

Nota

L'esempio precedente include due diverse organizzazioni a cui l'utente ha accesso e configura Dynamics CRM per Outlook per non visualizzato il banner di notifica "Desidero partecipare al programma Analisi utilizzo software". Il valore contenuto negli elementi Organization non può contenere caratteri speciali o spazi. Per Microsoft Dynamics CRM (locale), è possibile individuare il nome univoco dell'organizzazione eseguendo il cmdlet Get-CrmOrganization di Windows PowerShell o nella colonna Nome dell'area Organizzazioni di Gestione distribuzione.

Configurare CRM per Outlook utilizzando uno script

  1. Scrivere uno script per l'aggiornamento automatico delle impostazioni di configurazione per gli utenti di Dynamics CRM per Outlook. È possibile utilizzare righe come quelle seguenti per eseguire le azioni di configurazione di base, avvalendosi di un nuovo file di configurazione archiviato nel computer indicato come <servername>.

    Nello script seguente la configurazione client predefinita viene sovrascritta, le organizzazioni configurate in precedenza vengono rimosse, le credenziali utente vengono aggiunte all'insieme di credenziali Windows e viene installata la nuova organizzazione.

    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"

    Suggerimento

    Considerare la possibilità di eseguire lo script come script di accesso o di forzarne l'esecuzione a un'ora specifica, ad esempio utilizzando Microsoft System Center Configuration Manager 2012.

    Nello script è inoltre possibile includere una logica di rilevamento per determinare se il computer client è già stato configurato. In caso affermativo, è possibile impostare lo script in modo che termini senza eseguire alcuna azione.

    File Default_Client_Config.xml di esempio

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

  2. Eseguire lo script in ogni computer client dell'organizzazione il cui server è cambiato. È possibile eseguire lo script in vari modi, ad esempio tramite la scheda Profilo della finestra di dialogo delle proprietà utente in Utenti e computer di Active Directory o tramite oggetti Criteri di gruppo.

Vedere anche

Configurare CRM per Outlook
Installare il Server Microsoft Dynamics CRM mediante un prompt dei comandi
CRM per Outlook

© 2016 Microsoft Corporation. Tutti i diritti sono riservati. Copyright