Installere Microsoft Dynamics 365 for Outlook ved hjælp af en kommandoprompt
Installation af Microsoft Dynamics 365 for Outlook er en procedure i to trin. Først skal du køre installationsprogrammet for at installere filerne på computeren. Derefter skal du køre guiden Dynamics 365 for Customer EngagementConfiguration for at konfigurere programmet og fuldføre installationen.
Vigtigt
Hvis der er en konflikt mellem en værdi i konfigurationsfilen og en værdi i kommandolinjeparametrene, har kommandolinjeparameteren første prioritet.
Trin 1: Installation af filer
Bemærk
Se Installere Dynamics 365 for Outlook for at få oplysninger om download.
I følgende kommando vises de tilgængelige indstillinger til kørsel af installation af Microsoft Dynamics CRM for Outlook ved kommandoprompten:
Setupclient.exe [/A] [/Q] [/X] [/L eller /LV "[drev:][[ sti] logfilename.log]"] [/targetdir "[drev:][ sti]"] [/installofflinecapability] [/disableofflinecapability] [/ignoreofflinequeue]
Eksempler på kommandoer til Dynamics 365 for Outlook-installation
For brugere, der rejser, eller som ikke altid har forbindelse til Dynamics 365 Server, Dynamics 365 for Microsoft Office Outlook med Offline adgang, giver adgang til kundedataene. Sådan installeres Dynamics 365 for Microsoft Office Outlook med offlineadgang uden brugerinput:
Setupclient /Q /l c:\clientinstalllog.txt /installofflinecapability /targetdir "c:\Program Files\Microsoft Dynamics CRM Client"
Sådan fjernes Dynamics 365 for Microsoft Office Outlook med offlineadgang uden brugerinput:
SetupClient /x /q
Parametre til Dynamics 365 for Outlook-installation
| Parameter | Description |
|---|---|
| Ingen | Hvis der ikke bruges parametre, køres Setupclient.exe med alle skærme. |
| installofflinecapability | Angiver, om der installeres offlinefunktioner. Når du inkluderer denne parameter, installeres der offlinefunktioner og -komponenter. Hvis du ikke angiver denne parameter, installeres klienten, der kun er online. |
| /targetdir <"drev:\path"> | Angiver den mappe, hvor Dynamics 365 for Outlook-filerne installeres. |
| /A | Opretter en administrativ installation af Dynamics 365 for Outlook ved at oprette en Windows Installer-pakke. Med denne pakke kan brugere køre installation fra et netværks-share, eller brugere, der ikke er administratorer, kan køre installation, der er baseret på en gruppepolitik. Denne parameter skal bruges sammen med parameteren /targetdir, som beskrevet tidligere. Når du bruger denne parameter, behøver værdien af /targetdir ikke at være til stede på den lokale computer. Der kan bruges et tilknyttet drev eller et tilknyttet netværks-share som f.eks. \\share\mscrm_client_admin.
Vigtigt: Hvis du ikke angiver en destinationsmappe ved hjælp af parameteren /targetdir, installeres den administrative installation i standardmappen <drev:> Programfiler\Microsoft Dynamics CRM. For eksempel kommandoen: Setupclient /Q /A /targetdir "\\share\mscrm_client_admin" |
| /Q | Installation uden brugerinput. Der kræves en konfigurationsfil i XML-format til denne parameter. Parameteren /i indeholder navnet på XML-konfigurationsfilen. Der vises ingen dialogbokse eller fejlmeddelelser på skærmen. Hvis du vil hente oplysninger via fejlmeddelelser, skal du inkludere parameteren for logfilen (/L eller /LV). |
| /L [drev:][[sti] logfilename.log] | Opretter en logfil over installationsaktiviteter. Du skal angive filnavnet på logfilen, og hvor den skal gemmes, men stien må ikke være en relativ sti, som f.eks. %appdata%\CRMLogs. |
| /LV [drev:][[sti] logfilename.log] | Opretter en detaljeret logfil over installationsaktiviteter. Du skal angive filnavnet på logfilen, og hvor den skal gemmes, men stien må ikke være en relativ sti, som f.eks. %appdata%\CRMLogs. |
| disableofflinecapability | Når du angiver denne parameter, konfigureres Dynamics 365 for Outlook til at skjule knappen "skift til offline" i programmet. Med denne knap kan brugere nemt skifte til Dynamics 365 for Outlook med offlinefunktioner. |
| ignoreofflinequeue | Når du angiver denne parameter, forsøger Installation ikke at synkronisere elementer, der forbliver i offlinekøen under opgraderingen. |
| /X | Fjerner Dynamics 365 for Outlook. Det er en indstilling for vedligeholdelsestilstand, der kun er tilgængelig, når programmet allerede er installeret. |
Eksempel på Dynamics 365 for Outlook XML-konfigurationsfil til installation
Du kan bruge følgende eksempel på en konfigurationsfil til at installere Dynamics 365 for Outlook uden offlineadgangsegenskaber til mappen Programmer.
Bemærk
Du kan bruge den samme fil, der både indeholder installations- og konfigurationselementerne. Installation og guiden Konfiguration ignorerer de elementer, der ikke er relevante for handlingen.
<Deployments>
<TargetDir>c:\program files\Microsoft Dynamics CRM\Client</TargetDir>
<InstallOfflineCapability>false</InstallOfflineCapability>
</Deployments>
Trin 2: Konfiguration af Dynamics 365 for Outlook ved hjælp af en XML-konfigurationsfil
Når du har installeret Dynamics 365 for Outlook, skal du konfigurere det. Det kan du gøre ved at køre guiden Dynamics 365 til OutlookConfiguration fra en kommandoprompt. Filen til Guiden Konfiguration hedder Microsoft.Crm.Application.Outlook.ConfigWizard.exe, og den findes i mappen Client\ConfigWizard, hvor Dynamics 365 for Outlook er installeret. Mappen er som standard C:\Programmer\Microsoft Dynamics CRM.
Bemærk
Legitimationsoplysningerne for den bruger, der kører Dynamics 365 for Outlook, bruges til at godkende Dynamics 365 for Customer Engagement. Så hvis du vil udføre en uovervåget konfiguration af Dynamics 365 for Outlook, skal du køre Guiden Konfiguration i brugerens kontekst, f.eks. ved at køre en batchfil, der er aktiveret af brugeren, eller som en engangsindtastning i et logonscript. Se Brugerlegitimationsoplysninger kræves, når du kører guiden Konfiguration for at få flere oplysninger. Hvis du vil installere Dynamics 365 for Outlook ved hjælp af Microsoft gruppepolitik, kan du gå til emnet Installation af Microsoft Dynamics 365 for Outlook ved hjælp af gruppepolitik.
Hvis der ikke er angivet en sti til konfigurationsfilen, søger Guiden Konfiguration efter standardkonfigurationsfilen (default_client_config.xml) i mappen med ikke-globale profiler (%localappdata%\Microsoft\MSCRM\). Hvis filen ikke findes i mappen med ikke-globale profiler, søger Guiden Konfiguration efter den mappe, hvor Dynamics 365 for Outlook er installeret. Som standard installeres Dynamics 365 for Outlook i mappen C:\programmer\Microsoft Dynamics CRM\.
Hvis konfigurationsfilen findes på den globale placering, der bruges af andre programmer (AppData\Roaming\Microsoft\MSCRM\), accepteres den ikke.
Eksempler på kommandoer til konfiguration af Dynamics 365 for Outlook
Følgende kommando konfigurerer Microsoft Dynamics 365 for Outlook med Offline-adgang ved hjælp af en fil med navnet config_client.xml uden brugerinput, og der oprettes en logfil med navnet clientinstall.log:
Microsoft.Crm.Application.Outlook.ConfigWizard.exe /Q /i c:\config_client.xml /xa /l c:\clientinstall.log
Når konfigurationsparameteren /Q (uden brugerinput) anvendes, skal der angives en konfigurationsfil i XML-format. Der vises ingen dialogbokse eller fejlmeddelelser på skærmen. Hvis du vil registrere fejlmeddelelser, skal du medtage logfilparameteren (/L) eller detaljeret logføring (/LV).
Vigtigt
Der kræves gyldige brugerlegitimationsoplysninger lagret i Windows Vault for at køre Guiden Konfiguration uden brugerinput. Flere oplysninger: Brugerlegitimationsoplysninger kræves, når du kører guiden Konfiguration
Kommandolinjeparameteren /i [drev:] [[sti] configfilename.xml]] angiver de krævede oplysninger til opsætning af Microsoft Dynamics CRM for Outlook. Det er de samme oplysninger, som kræves til hvert enkelt installationsskærmbillede. XML-elementerne skal være på engelsk (US), og der må ikke benyttes specialtegn eller udvidede tegn. En XML-konfigurationsfil med lokaliserede XML-elementer virker ikke korrekt. Nedenfor finder du en forklaring på hvert enkelt XML-element og et eksempel på en XML-fil:
Når parameteren /xa bruges sammen med parameteren /q, fjernes alle de organisationer, der er konfigureret til Dynamics 365 for Outlook.
Parameteren/ R parameter kan bruges til at undertrykke brugergrænsefladen og Guiden Konfiguration kun vise dialogboksen status. Denne parameter kræver en gyldig XMLSetup-fil, der hedder Default_Client_Config. xml og skal være placeret i den lokale brugers AppData-mappe eller klientinstallationsmappen.
XML-konfigurationsfilelementer til Dynamics 365 for Outlook
| Element | Description |
|---|---|
| <Installationer></Installationer> | Konfigurationsfilen skal være en gyldig XML-fil, der bruger <Installation> som rodelement. |
| <InstallOfflineCapability>true/false</InstallOfflineCapability> | Angiver typen af Dynamics 365 for Outlook-installation. Hvis du angiver true, installeres Microsoft Dynamics 365 for Outlook med mulighed for offline-adgang. |
| <TargetDir>drive:\path</TargetDirectory> | Angiver den mappe, hvor Dynamics 365 for Outlook-filerne installeres. |
| <Deployment></Deployment> | Overordnet element for alle de følgende elementer. |
| <DiscoveryUrl>https://website:portnumber</DiscoveryUrl> | Angiver webadressen til Dynamics 365 for Customer EngagementDiscovery-webtjenesten. I forbindelse med Dynamics 365 for Customer Engagement skal du bruge den fulde URL-adresse til organisationen, f.eks. https://orgname.crm.dynamics.com. eller afhængigt af dit onlinemiljø og din placering skal du bruge URL-adressen til registreringstjenesten i formularen https://disco.crm.dynamics.com. Du kan få vist en liste over URL-adresser under MSDN: Registreringstjeneste. |
| <FederatedAuthentication>true/false</FederatedAuthentication> | Angiver, om der skal bruges (Azure Active Directory) legitimationsoplysninger i organisationsnetværket til godkendelse i Guiden Konfiguration. Hvis du angiver false, kan du bruge legitimationsoplysninger som user@contoso.onmicrosoft.com. |
| <Organizations></Organizations> | Dette er det overordnede element for følgende <Organization>-element. |
| <Organization FriendlyName="My Friendly Organization Name" IsPrimary="true"/"false">OrganizationName</Organization> | Angiver navnet på den organisation, klienten opretter forbindelse til. FriendlyName. Angiver et andet vist navn end organisationsnavnet i Outlook. IsPrimary. Angiver den organisation, der skal konfigureres som den organisation, der synkroniseres, i Dynamics 365 for Outlook. Bemærk: I OrganizationName skelnes der mellem store og små bogstaver. |
| <CEIPNotification>true/false</CEIPNotification> | Angiver, om Dynamics 365 for Outlook viser meddelelsesbanneret "Jeg vil gerne tilmelde mig programmet til forbedring af kundeoplevelsen". Standardindstillingen er true, og meddelelsesbanneret vises. Hvis du angiver false, vises meddelelsesbanneret ikke i Dynamics 365 for Outlook. Flere oplysninger: Microsofts program til forbedring af kundeoplevelsen |
Brugerlegitimationsoplysninger kræves, når du kører guiden Konfiguration
Brugerlegitimationsoplysninger kræves, når du kører guiden Konfiguration Under en uovervåget konfiguration ved hjælp af filen /Q med Microsoft. Crm. program. Outlook. ConfigWizard.exe vil Guiden Konfiguration søge efter brugerens legitimationsoplysninger i Windows Vault. Hvis Guiden Konfiguration ikke kan finde legitimationsoplysningerne, eller legitimationsoplysningerne ikke har det krævede format, bliver konfigurationen ikke færdig, og der registreres en fejl i konfigurationens logfil. Bemærk, at Guiden Konfiguration ikke understøtter tilføjelse af bruger-UPN eller adgangskode i XML-konfigurationsfilen. Du kan finde flere oplysninger om Windows Vault og Credential Manager i Hvad er Credential Manager
Eksempel på Dynamics 365 for Outlook XML-konfigurationsfil til konfiguration
Følgende eksempel på en konfigurationsfil bruges til at konfigurere Dynamics 365 for Outlook til at oprette forbindelse til en primær organisation, der hedder Contoso, og en anden organisation, der hedder AdventureWorksCycle, på den Dynamics 365 Server, der hedder crmserver.
Bemærk
Du kan bruge den samme fil, der både indeholder installations- og konfigurationselementerne. Installation og guiden Konfiguration vil ignorere de elementer, der ikke er relevante for handlingen.
Eksempel på filen 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>
Bemærk
Det foregående eksempel angiver to forskellige organisationer, som brugeren har adgang til, og konfigurerer Dynamics 365 for Outlook til ikke at vise meddelelsesbanneret "Jeg vil gerne tilmelde mig programmet til forbedring af kundeoplevelsen". Værdien i elementet Organization må ikke indeholde specialtegn eller mellemrum. For Customer Engagement (on-premises) kan du finde organisationens entydige navn ved at køre Get-CrmOrganization Windows PowerShell-cmdlet eller gå til Indstillinger>Tilpasninger>Udviklerressourcer og under Referenceoplysninger for forekomst kopiere Entydigt navn.
Konfigurere Dynamics 365 for Outlook ved hjælp af et script
Skriv et script, der automatisk opdaterer konfigurationsindstillingerne for brugere af Dynamics 365 for Outlook. Du kan bruge linjer som de følgende til at udføre de grundlæggende konfigurationshandlinger, der er baseret på en ny konfigurationsfil, som er gemt på den computer, der er angivet som <
servername>.I følgende script overskrives standardkonfigurationsfilen for klienten, de organisationer, der er konfigureret tidligere, fjernes, brugerlegitimationsoplysninger føjes til Windows Vault, og den nye organisation installeres.
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"Tip
Overvej at køre scriptet som et logonscript eller at gennemtvinge scriptet til at køre på et bestemt tidspunkt, f.eks. ved hjælp af administration af Microsoft System Center 2012-konfiguration.
I scriptet kan du også inkludere registreringslogik, der angiver, om klientcomputeren allerede er konfigureret. Hvis den er det, kan scriptet afsluttes, uden at du foretager dig noget.
Eksempel på filen Default_Client_Config.xml
<Deployment> <DiscoveryUrl>https://CrmDiscoveryUrl</DiscoveryUrl> <Organizations> <Organization IsPrimary='true'>Organization1</Organization> </Organizations> </Deployment>Kør scriptet på alle klientcomputere i den organisation, hvis server er ændret. Du kan køre scriptet på mange måder, herunder via fanen Profil i dialogboksen med brugeregenskaber i Active Directory Users and Computers (ADUC) eller via GPO'er (gruppepolitikobjekter).