Dela via


Installera Microsoft Dynamics 365 for Outlook via en kommandotolk

Installera Microsoft Dynamics 365 for Outlook är ett förfarande i två steg. Först måste du köra installationsprogrammet för att installera filerna på datorn. Kör sedan konfigurationsguiden Dynamics 365 för Customer Engagement för att konfigurera programmet och slutföra installationen.

Viktigt!

Om det finns en konflikt mellan ett värde i konfigurationsfilen och ett värde i kommandoradsparametrar, har kommandoradsparametern företräde.

Steg 1: Installera filer

Kommentar

Se Installera Dynamics 365 for Outlook för anvisningar om hämtning.

Följande kommando visar de tillgängliga alternativen för att köra konfiguration av Microsoft Dynamics CRM for Outlook vid kommandotolken:

Setupclient.exe [/A] [/Q] [/X] [/L or /LV "[drive:][[ sökväg] logfilename.log]"] [/targetdir "[enhet:][ sökväg]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]

Exempel på kommandon för Dynamics 365 for Outlook-installation

För användare som reser eller som inte alltid är ansluten till Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook med offlineåtkomst ger åtkomst till kunddata. Så här installerar du Dynamics 365 for Microsoft Office Outlook med offlineåtkomst i lugnt läge:

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

Så här avinstallerar du Dynamics 365 for Microsoft Office Outlook med offlineåtkomst i lugnt läge:

SetupClient /x /q

Parametrar för Dynamics 365 for Outlook-installation

Parameter Beskrivning
Ingen Om kommandot används utan parametrar, Setupclient.exe kommer att köras med alla bildskärmar.
installofflinecapability Avgör om offlinekapacitet kommer att installeras. När du inkluderar parametern installeras offlinekapacitet och komponenter. Om du inte anger den här parametern installeras bara onlineklienten.
/targetdir <"drive:\path"> Anger mappen där Dynamics 365 for Outlook-filer installeras.
/A Skapar en administratörsinstallation av Dynamics 365 for Outlook genom att skapa ett Windows Installer-paket. Det här paketet låter användare köra konfigurationen från en nätverksresurs eller låter icke-administratörer köra konfigurationen som drivs från en grupprincip. Den här parametern måste användas tillsammans med parametern /targetdir som beskrivs ovan. När du använder den här parametern behöver inte /targetdir-värdet finnas på den lokala datorn. En mappad enhet eller nätverksresurs som \\share\mscrm_client_admin, kan användas. Viktigt: Om du inte anger en målmapp med hjälp av parametern /targetdir administratörsinstallationen i standardmappen <drive:> Program Files\Microsoft Dynamics CRM.

Till exempel följande kommando:

Setupclient /Q /A /targetdir "\\share\mscrm_client_admin"
/Q Installation i tyst läge. Den här parametern kräver en konfigurationsfil i XML-format. Parametern /i innehåller namnet på XML-konfigurationsfilen. Inga dialogrutor eller felmeddelanden visas på bildskärmen. För att samla in information om felmeddelanden, ta med loggfilsparametern (/L eller /LV).
/L [enhet:][[sökväg] logfilename.log] Skapar en loggfil för installationens aktivitet. Du måste ange filnamnet på loggfilen och var du vill placera den, men sökvägen får inte vara en relativ sökväg, t.ex. %appdata%\CRMLogs.
/LV [enhet:][[sökväg] logfilename.log] Skapar en utförlig loggfil för installationens aktivitet. Du måste ange filnamnet på loggfilen och var du vill placera den, men sökvägen får inte vara en relativ sökväg, t.ex. %appdata%\CRMLogs.
disableofflinecapability När du anger den här parametern konfigureras Dynamics 365 for Outlook för att dölja knappen "Arbeta offline" i programmet. Med den här knappen kan användare växla till Dynamics 365 for Outlook med offlinefunktion.
ignoreofflinequeue När du anger den här parametern kommer konfiguration inte att försöka synkronisera objekt kan finnas kvar i offlinekön under uppgraderingen.
/X Avinstallerar Dynamics 365 for Outlook. Detta är ett alternativ i underhållläge som bara är tillgängligt när programmet har installerats.

Exemelkonfigurationsfil för installation av Dynamics 365 for Outlook XML

I följande konfigurationsfilexempel installerar Dynamics 365 for Outlook utan offlineåtkomstfunktion i mappen Program.

Kommentar

Du kan använda samma fil som innehåller både installations- och konfigurationselement. Konfiguration och konfigurationsguiden kommer att ignorera de element som inte är relevanta för åtgärden.

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

Steg 2: Konfigurera Dynamics 365 for Outlook med hjälp av en XML-konfigurationsfil

När du har installerat Dynamics 365 for Outlook måste du konfigurera det. Det gör du genom att köra konfigurationsguiden Dynamics 365 för Outlook från kommandotolken. Konfigurationsguide-filen heter Microsoft.Crm.Application.Outlook.ConfigWizard.exe och finns i Client\ConfigWizard där Dynamics 365 for Outlook är installerad. Som standard installeras mappen i C:\Program Files\Microsoft Dynamics CRM.

Kommentar

Autentiseringsuppgifter för användare som ska köra Dynamics 365 for Outlook används för att verifiera till Dynamics 365 for Customer Engagement. För att utföra en tyst konfiguration av Dynamics 365 for Outlook, måste du därför köra Konfigurationsguiden under användarens kontext, t.ex genom att köra en användarinitierad batch-fil eller som en enstaka post i ett inloggningsskript. För mer information, se Användarens autentiseringsuppgifter krävs när du kör konfigurationsguiden. Distribuera Dynamics 365 for Outlook genom att använda Microsofts grupprincip, distribuera Microsoft Dynamics 365 for Outlook med hjälp av grupprincip.

Om en sökväg till konfigurationsfilen har angetts letar Konfigurationsguiden efter standardkonfigurationsfilen (default_client_config.xml) i icke-roaming profilmappen (%localappdata%\Microsoft\MSCRM\). Om filen inte finns i icke-roaming profilmappen söker Konfigurationsguiden efter mappen där Dynamics 365 for Outlook är installerad. Som standard installeras Dynamics 365 for Outlook i mappen C:\Program Files\Microsoft Dynamics CRM.

Om konfigurationsfilen finns på roaming-platsen som används av andra program (AppData\Roaming\Microsoft\MSCRM\), kommer den inte att gälla.

Kommandoexempel för Dynamics 365 for Outlook-konfigurationen

Följande kommando konfigurerar Microsoft Dynamics 365 for Outlook med offlineåtkomst med hjälp av en fil med namnet config_client.xml i tyst läge och skapar en loggfil med namnet clientinstall.log:

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

Konfigurationsparametern /Q för tyst läge kräver en konfigurationsfil i XML-format. Inga dialogrutor eller felmeddelanden visas på bildskärmen. För att samla in information om felmeddelanden, ta med loggfilsparametern (/L) eller utförlig loggning (/LV).

Viktigt!

Giltiga användaruppgifter lagrade i Windows-valvet krävs för att köra Konfigurationsguiden i tyst läge. För mer information, se Användarens autentiseringsuppgifter krävs när du kör konfigurationsguiden

Parametern /i [drive:] [[path] configfilename.xml]] command-line ger konfiguration av Microsoft Dynamics CRM for Outlook den information som krävs. Det är samma information som varje installationsskärm kräver. XML-elementen måste vara på engelska (USA); särskilda eller utökade tecken kan inte användas. En XML-konfigurationsfil som har lokaliserade XML-element kommer inte att fungera korrekt. En förklaring av alla XML-element och ett prov på XML-filen finns här:

/xa-parametern, när det används med parametern /q, tar bort alla organisationer som har konfigurerats för Dynamics 365 for Outlook.

Parametern /R kan användas för att förhindra att Konfigurationsguiden användargränssnittet visas och endast visa förloppsdialogrutan. Den här parametern kräver en giltig XMLSetup-fil som heter Default_Client_Config.xml och måste finnas i den lokala användarens AppData eller klientens installationsmapp.

Element i Dynamics 365 for Outlook XML-konfigurationsfilen

Element Beskrivning
<Distributioner></Distributioner> Konfigurationsfilen måste vara en giltig XML-fil som använder <Distributioner> som rotelementet.
<InstallOfflineCapability>true/false</InstallOfflineCapability> Anger typen av Dynamics 365 for Outlook-installation. Om du anger true installeras Microsoft Dynamics 365 for Outlook med offlineåtkomst.
<TargetDir>drive:\path</TargetDirectory> Anger mappen där Dynamics 365 for Outlook-filer installeras.
<Deployment></Deployment> Överordnat element för alla följande element.
<DiscoveryUrl>https://website:portnumber</DiscoveryUrl> Anger URL:en för webbtjänst för identifiering Dynamics 365 för Customer Engagement.

För Dynamics 365 for Customer Engagement, använd hela organisationens URL såsom https://orgname.crm.dynamics.com, eller beroende på din onlinemiljö och plats använd identifieringstjänstens URL i formuläret https://disco.crm.dynamics.com. För en lista med URL, se MSDN: Identifieringstjänst.
<FederatedAuthentication>true/false</FederatedAuthentication> Anger om federerade (Azure Active Directory) autentiseringsuppgifter används för autentisering i Konfigurationsguide. Om du anger false, kan du använda referenser som user@contoso.onmicrosoft.com.
<Organisationer></Organisationer> Det här är det överordnade elementet för följande <Organisation>-element.
<Organization FriendlyName="Mitt eget organisationsnamn" IsPrimary="true"/"false">OrganizationName</Organization> Anger namnet på den organisation som klienten ansluter till.

FriendlyName. Anger ett annat visningsnamn än organisationsnamnet i Outlook.

IsPrimary. Anger den organisation som konfigureras som synkroniseringsorganisation i Dynamics 365 for Outlook. Obs!OrganizationName är skiftlägeskänsligt.
<CEIPNotification>true/false</CEIPNotification> Anger om Dynamics 365 for Outlook ska visa meddelandebanderollen "Jag vill registrera mig för Customer Experience Improvement Program". Standardinställningen är true och banderollen visas. Om du anger false visas banderollen inte i Dynamics 365 for Outlook. Mer information: Microsofts förbättringsprogram via kundupplevelser

Användarens autentiseringsuppgifter krävs när du kör konfigurationsguiden

Konfigurationsguiden kräver autentiseringsuppgifter. Under en tyst konfiguration med /Q med Microsoft.Crm.Application.Outlook.ConfigWizard.exe-filen, kommer Konfigurationsguiden att leta efter användarens autentiseringsuppgifter i Windows-valvet. Om Konfigurationsguiden inte kan hitta autentiseringsuppgifter eller autentiseringsuppgifter inte finns i formatet som krävs, kommer konfigurationen inte att slutföras och ett fel registreras i loggfilen för konfiguration. Lägg märke till att Konfigurationsguiden inte har stöd för att lägga till användar-UPN eller lösenord i XML-konfigurationsfilen. Mer information om Windows-valv och Credential Manager finns i Vad är Credential Manager

Exemelkonfigurationsfil för Dynamics 365 for Outlook XML för konfiguration

Följande exempel på en konfigurationsfil konfigurerar Dynamics 365 for Outlook att ansluta till en primär organisation som heter Contoso och en annan organisation som heter AdventureWorksCycle på Dynamics 365 Server som heter crmserver.

Kommentar

Du kan använda samma fil som innehåller både installations- och konfigurationselement. Konfiguration och konfigurationsguiden kommer att ignorera de element som inte är relevanta för åtgärden.

Exempel på Default_Client_Config.xml-fil

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

Kommentar

I föregående exempel anges två olika organisationer som användaren har åtkomst till och konfigurerar Dynamics 365 for Outlook till att inte visa meddelandet "Jag vill registrera mig för Customer Experience Improvement Program". Värdet i Organization-elementet får inte innehålla specialtecken eller blanksteg. För Customer Engagement (on-premises), hittar du organisationens unika namn genom att köra cmdleten Get-CrmOrganization Windows PowerShell eller gå till Inställningar>Anpassningar>Utvecklingsresurser och under Instansreferensinformation kopiera Unikt namn.

Konfigurera Dynamics 365 for Outlook med hjälp av ett skript

  1. Skriv ett skript som automatiskt uppdaterar konfigurationsinställningar för användare av Dynamics 365 for Outlook. Du kan exempelvis använda rader som följande för att utföra åtgärder för grundläggande konfiguration, baserat på en ny konfigurationsfil som lagras på datorn anges som <servername>.

    I följande skript skrivs standardklientkonfigurationsfilen över, tidigare konfigurerade organisationer tas bort, användarreferenser läggs till i Windows-valvet och den nya organisationen installeras.

    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"
    

    Dricks

    Kör skriptet som ett inloggningsskript eller tving skriptet att köras vid en viss tid, t.ex. med hjälp av Konfigurationshanteraren för Microsoft System Center 2012.

    I skriptet kanske du också vill inkludera identifieringslogiken som bestämmer om klientdatorn har redan konfigurerats. Om den har det kan du göra så att skriptet avslutas utan att åtgärder vidtas.

    Exempel på Default_Client_Config.xml-fil

    <Deployment>
    <DiscoveryUrl>https://CrmDiscoveryUrl</DiscoveryUrl>
    <Organizations>
    <Organization IsPrimary='true'>Organization1</Organization>
    </Organizations>
    </Deployment>
    
  2. Kör skriptet på varje klientdator i organisationen vars server har ändrats. Du kan köra skriptet på olika sätt, bland annat via fliken Profil i dialogrutan med användaregenskaper i Active Directory-användare och datorer (ADUC) eller via grupprincipobjekt (GPO).

Se även

Installera Dynamics 365 for Outlook