Share via

Installare Microsoft Dynamics 365 for Outlook mediante un prompt dei comandi

  • Articolo

L'installazione di Microsoft Dynamics 365 for Outlook si svolge in due fasi. In primo luogo è necessario eseguire il programma di installazione per installare i file nel computer. Successivamente, esegui la configurazione guidata di Dynamics 365 for Customer Engagement 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.

Passaggio 1: Installare i file

Nota

Vedi Installare Dynamics 365 for Outlook per istruzioni sul download.

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

Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ path] logfilename.log]"] [/targetdir "[drive:][ path]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Esempi di comandi per l'installazione di Dynamics 365 for Outlook

Gli utenti che viaggiano o che non sono sempre connessi a Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook con accesso offline possono comunque accedere ai propri dati personali. Per installare Dynamics 365 for 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 Dynamics 365 for Microsoft Office Outlook con accesso offline in modalità non interattiva:

SetupClient /x /q

Parametri per l'installazione di Dynamics 365 for Outlook

Parametro Descrzione
Nessuna 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 365 for Outlook.
/A Crea un'installazione amministrativa di Dynamics 365 for Outlook creando un pacchetto di Windows Installer. Il pacchetto consente agli utenti di eseguire la configurazione da una condivisione di rete oppure consente agli utenti che non dispongono dei privilegi di amministratore di eseguire la 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, come \\share\mscrm_client_admin. Importante: se non specifichi una cartella di destinazione utilizzando il parametro /targetdir, la configurazione installa l'installazione amministrativa nella cartella predefinita <drive:> 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 [unità:][[percorso] nomefileregistro.log] Crea un file di registro delle operazioni di installazione. Devi specificare il nome del file di registro e il percorso in cui memorizzarlo, ma non puoi utilizzare un percorso relativo, come %appdata%\CRMLogs.
/LV [unità:][[percorso] nomefileregistro.log] Crea un file di registro dettagliato delle operazioni di installazione. Devi specificare il nome del file di registro e il percorso in cui memorizzarlo, ma non puoi utilizzare un percorso relativo, come %appdata%\CRMLogs.
disableofflinecapability Quando si specifica questo parametro, Dynamics 365 for Outlook viene configurato in modo da nascondere il pulsante per l'accesso offline nell'applicazione. Tale pulsante consente agli utenti di passare a Dynamics 365 for Outlook con funzionalità offline.
ignoreofflinequeue Quando si specifica questo parametro, durante l'installazione non verrà tentata la sincronizzazione degli elementi che possono restare nella coda offline durante l'aggiornamento.
/X Disinstalla Dynamics 365 for 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 Dynamics 365 for Outlook

Il file di configurazione di esempio seguente consente di installare Dynamics 365 for 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 ignoreranno 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 Dynamics 365 for Outlook utilizzando un file di configurazione XML

Dopo aver installato Dynamics 365 for Outlook, è necessario configurarlo. Puoi eseguire questa operazione eseguendo la configurazione guidata di Dynamics 365 for Outlook al prompt dei comandi. Il file Configurazione guidata è denominato Microsoft.Crm.Application.Outlook.ConfigWizard.exe e si trova nella cartella Client\ConfigWizard in cui è stato installato Dynamics 365 for Outlook. La cartella predefinita è C:\Program Files\Microsoft Dynamics CRM.

Nota

Le credenziali dell'utente che eseguirà Dynamics 365 for Outlook vengono utilizzate per l'autenticazione in Dynamics 365 for Customer Engagement. Per eseguire una configurazione invisibile di Dynamics 365 for 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, vedi Le credenziali utente sono necessarie quando si esegue la Configurazione guidata. Per distribuire Dynamics 365 for Outlook utilizzando Criteri di gruppo Microsoft, vedi Distribuire Microsoft Dynamics 365 for Outlook per Outlook tramite Criteri di gruppo.

Se il percorso del file di configurazione non è specificato, la Configurazione guidata cerca il file di configurazione predefinito (default_client_config.xml) nella cartella del profilo non-roaming (%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 365 for Outlook. Per impostazione predefinita, Dynamics 365 for Outlook viene 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 Dynamics 365 for Outlook

Il comando seguente configura Microsoft Dynamics 365 for Outlook con accesso offline utilizzando un file denominato config_client.xml in modalità non interattiva e produce un file di log 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 in 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. Altre informazioni: Le credenziali utente sono necessarie quando si esegue la Configurazione guidata

Il parametro /i [drive:] [[path] configfilename.xml]] command-line fornisce all'installazione di Microsoft Dynamics CRM for Outlook le informazioni necessarie. 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 365 for 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 XMLSetup valido denominato Default_Client_Config.xml che si trova nella cartella dell'utente locale AppData o nella cartella di installazione Client.

Elementi del file di configurazione XML per Dynamics 365 for Outlook

Elemento Descrzione
<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 365 for Outlook. Specificando true verrà effettuata l'installazione di Microsoft Dynamics 365 for Outlook con funzionalità di accesso offline.
<TargetDir>drive:\path</TargetDirectory> Specifica la cartella in cui verranno installati i file di Dynamics 365 for Outlook.
<Deployment></Deployment> Elemento padre di tutti gli elementi seguenti.
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> Specifica l'URL per il servizio Web di individuazione di Dynamics 365 for Customer Engagement

Per Dynamics 365 for Customer Engagement, utilizza l'URL dell'organizzazione completo, ad esempio https://orgname.crm.dynamics.com, o in base al tuo ambiente e posizione online, utilizza l'URL del servizio di individuazione, nel modulo https://disco.crm.dynamics.com. Per un elenco di URL, vedi MSDN: Servizio di individuazione.
<FederatedAuthentication>true/false</FederatedAuthentication> Specifica se le credenziali federate (Azure Active Directory) vengono utilizzate per l'autenticazione in Configurazione guidata. Se specifichi false, puoi utilizzare le credenziali come user@contoso.onmicrosoft.com.
<Organizations></Organizations> È l'elemento padre dell'elemento <Organization> seguente.
<Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</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 365 for Outlook. Nota:OrganizationName distingue tra maiuscole/minuscole.
<CEIPNotification>true/false</CEIPNotification> Specifica se Dynamics 365 for 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 365 for Outlook. Altre informazioni: Programma Analisi utilizzo software Microsoft

Le credenziali utente sono necessarie quando si esegue la Configurazione guidata

La Configurazione guidata richiede le credenziali dell'utente. Durante una configurazione non interattiva, se utilizzi /Q con il file Microsoft.Crm.Application.Outlook.ConfigWizard.exe, 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. La Configurazione guidata non supporta l'aggiunta dell'UPN o della password dell'utente nel file di configurazione XML. Per ulteriori informazioni sull'insieme di credenziali Windows e su Gestione credenziali, vedere Che cos'è Gestione credenziali?

Esempio di file di configurazione XML per Dynamics 365 for Outlook

Nel seguente esempio di file di configurazione Dynamics 365 for Outlook viene configurato per la connessione a un'organizzazione primaria denominata Contoso e a un'ulteriore organizzazione denominata AdventureWorksCycle nel Dynamics 365 Server 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 ignoreranno gli elementi non rilevanti per le rispettive operazioni.

File Default_Client_Config.xml di esempio

<Deployments>
<Deployment>
<DiscoveryUrl>https://crmserver</DiscoveryUrl>
<Organizations>
<Organization IsPrimary='true'>Contoso</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 365 for 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 Customer Engagement (on-premises), è possibile trovare il nome univoco dell'organizzazione eseguendo il cmdlet Get-CrmOrganization di Windows PowerShell o vai a Impostazioni>Personalizzazioni>Risorse per sviluppatori e in Informazioni di riferimento istanza copia il Nome univoco.

Configurare Dynamics 365 for Outlook utilizzando uno script

  1. Scrivere uno script per l'aggiornamento automatico delle impostazioni di configurazione per gli utenti di Dynamics 365 for 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://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"

    Mancia

    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 2012 Configuration Manager.

    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>https://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 Active Directory Users and Computers (ADUC) o tramite oggetti Criteri di gruppo.

Vedere anche

Installare Dynamics 365 for Outlook