Udrulle pakker ved hjælp af CRM Package Deployer og Windows PowerShell

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Microsoft Dynamics CRM Package Deployer gør det muligt for administratorer at udrulle pakker på en forekomst af Microsoft Dynamics CRM (i det lokale miljø) eller Microsoft Dynamics CRM Online. En "pakke" kan bestå af en eller flere af følgende:

• En eller flere Dynamics 365-løsningsfiler.

• Flade filer eller eksporterede datafiler fra Værktøj til konfigurationsoverførsel. Du kan finde oplysninger om Værktøj til konfigurationsoverførsel i Administrere konfigurationsdata.

• Brugerdefineret kode, der kan køre, mens eller efter at pakken er installeret på Microsoft Dynamics 365.

• HTML-indhold er specifik for pakken, der kan vises i begyndelsen og slutningen af pakkeinstallationsprocessen. Dette kan være nyttigt for at give en beskrivelse af de løsninger og filer, der installeres i pakken.

Udviklere opretter pakker ved hjælp af pakkeinstallationsskabelonen i Microsoft Visual Studio.Flere oplysninger:MSDN: Oprette pakker til CRM Package Deployer

Når en pakke er blevet oprettet, kan du installere den enten ved at køre CRM-pakkeimplementationsværktøj eller ved hjælp af Windows PowerShell-cmdletterne til værktøjet.

Dette emne indeholder

Brug Værktøj til pakkeimplementation for CRM til at installere pakker

Bruge Windows PowerShell til at installere pakker

Foretag fejlfinding af problemer med installation af pakken ved hjælp af logfiler

Bedste praksis for installation af pakker

Brug Værktøj til pakkeimplementation for CRM til at installere pakker

Pakkeimplementationsværktøj kan kun afvikle én pakke ad gangen. Men den giver brugerne mulighed for at vælge en pakke til at installere fra flere pakker, der er tilgængelige i biblioteket Pakkeimplementationsværktøj. Nogle af skærmbillederne og handlingerne i værktøjet varierer efter pakkedefinitionen. Du behøver ikke installere Pakkeimplementationsværktøj. Bare hent og kør den.

1. Hente den pakke, der skal installeres. En pakke er en samling af filer og mapper, der oprettes i Visual studio-projektmappen (<projekt>\Bin\Debug) når du opbygger et pakkeprojekt i Visual Studio. Kopiér det følgende fra dit projekts debugmappe:

   • Mappen <PackageName>: Denne mappe indeholder løsningerne, importkonfigurationen og indholdet i din pakke.

   • <PackageName>.dll: Assemblyet indeholder koden til pakken. Som standard er er navnet på assemblyen det samme som dit Visual Studio-projektnavn.

   Yderligere oplysninger om oprettelse af en pakke ved hjælp af Visual Studio findes i MSDN: Oprette en pakke til Værktøj til pakkeudrulning.

   Lad os i dette emneantage, at alt indhold fra pakkemappen og assemblyet fra Visual Studio-projekts debugmappe (<Project>\Bin\Debug) kopieres til mappen c:\DeployPackage.

2. Hent SDK-pakken til Microsoft Dynamics CRM. Kør derefter den hentede eksekverbare fil for at pakke indholdet af pakken ud.

3. Gå til mappen SDK\Tools\PackageDeployer, og kopier pakkemappen og assemblyet fra mappen c:\DeployPackage til mappen SDK\Tools\PackageDeployer.

4. Når filerne er kopieret, skal du køre værktøjet ved at dobbeltklikke på filen PackageDeployer.exe i mappen SDK\Tools\PackageDeployer.

5. Klik på Fortsæt på hovedskærmbilledet i værktøjet.

6. På skærmbilledet Opret forbindelse til Microsoft Dynamics CRM skal du angive oplysninger om godkendelse til at oprette forbindelse til din Dynamics 365-server, hvor du vil installere pakken. Hvis du har flere organisationer og du vil vælge den organisation, hvor du vil installere pakken, skal du markere afkrydsningsfeltet Vis altid en liste over tilgængelige organisationer. Klik på Log på.

7. Hvis du har flere organisationer på Dynamics 365-serveren, og du markerede afkrydsningsfeltet Vis altid en liste over tilgængelige organisationer, kan du vælge den organisation, du vil oprette forbindelse til, på det næste skærmbillede. Vælg en Dynamics 365-organisation, der skal oprettes forbindelse til.

8. På det næste skærmbillede bedes dig om at vælge en pakke, der skal installeres. Vælg navnet på pakken, og klik på Næste.

   

9. Følg vejledningen på de efterfølgende skærmbilleder for at fuldføre installationen af pakken.

   Skærmen vises på baggrund af definitionen af den pakke, du valgte til installation. Oplysninger om en komplet pakkeudrulning, som anvender Pakkeimplementationsværktøj, findes i emnet for udrulning af Unified Service Desk-pakker: Udrul Unified Service Desk-eksempelprogrammer til CRM Server ved hjælp af Package Deployer

Bruge Windows PowerShell til at installere pakker

Pakkeimplementationsværktøj har også Windows PowerShell-understøttelse til installation af pakker.

Udfør følgende trin for at bruge PowerShell-cmdletterne til at installere pakker:

Forudsætninger

Registrere cmdletterne

Brug cmdletten til at hente pakker

Bruge cmdletten til at oprette forbindelse til CRM-serveren

Brug cmdletten til at installere pakker

Få detaljeret hjælp til cmdletter

Forudsætninger

Her er forudsætningerne for at bruge PowerShell-cmdlets:

• Der kræves PowerShell 3.0 eller nyere for at installere en pakke ved hjælp af PowerShell. Kontrollér din PowerShell-version ved at køre et PowerShell-vindue og derefter køre følgende kommando: $Host

• Angiv, at udførelsespolitikken skal køre de signerede PowerShell-scripts. Det gøres ved at køre et PowerShell-vindue som administrator og derefter køre kommandoen: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrere cmdletterne

Du skal registrere Windows PowerShell-cmdletterne for Pakkeimplementationsværktøj, før du kan bruge den. Sådan registreres cmdletterne:

1. Hvis du ikke allerede har gjort det, kan du hente Dynamics 365 SDK-pakken fra Microsoft Download Center og køre pakkefilen for at pakke indholdet af pakken ud. Lad os antage, at du har pakket pakken ud i mappen c:\CRM på din computer.Pakkeimplementationsværktøj og de øvrige nødvendige filer bliver tilgængelige på følgende placering: c:\CRM\SDK\Tools\PackageDeployer.

2. Start Windows PowerShell på computeren med administratorrettigheder (kør som administrator).

3. Ved prompten i Windows PowerShell-vinduet skal du ændre mappen til mappen Windows PowerShell under mappen PackageDeployer. I dette tilfælde:

   cd c:\CRM\SDK\Tools\PackageDeployer\PowerShell
   

4. Kør scriptet RegisterXRMTooling.ps1 for at registrere Package Deployer for Windows PowerShell (dll), og installer Windows PowerShell-snap-in'en for Pakkeimplementationsværktøj. Gør det ved at skrive følgende kommando og trykke på ENTER:

   .\RegisterXRMTooling.ps1
   

5. Tilføj Windows PowerShell-snap-in'en for XRM-værktøjet. Dermed registreres følgende cmdletter: Get-CrmConnection og Get-CrmOrganizations.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

6. Tilføj Windows PowerShell-snap-in'en for pakkeudrulningen. Dermed registreres følgende cmdletter: Get-CrmPackages og Import-CrmPackage.

   Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment
   

Du er nu klar til at bruge disse Windows PowerShell-cmdletter. Kør følgende kommando ved prompten i Windows PowerShell-vinduet for at få vist de cmdletter, du har registreret:

Get-Help “Crm”

Brug cmdletten til at hente pakker

Før du kan bruge cmdletten, skal du sikre, at du har kopieret pakken til mappen PackageDeployer (i dette tilfælde: c:\CRM\SDK\Tools\PackageDeployer). En pakke er en samling af filer og mapper, der oprettes i Visual Studio-projektmappen (<projekt>\Bin\Debug), når du opbygger et projekt i Visual Studio. Kopiér hele indholdet af projekts debugmappe til mappen PackageDeployer. Yderligere oplysninger om oprettelse af en pakke ved hjælp af Visual Studio findes i MSDN: Oprette pakker til CRM Package Deployer.

1. I PowerShell-vinduet skal du bruge følgende cmdlet til at returnere en liste over pakker, der kan importeres i den angivne mappe (i dette tilfælde: c:\CRM\SDK\Tools\PackageDeployer):

   Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer
   

2. Hvis du vil have oplysninger om en pakke i en mappe, kan du bruge cmdletten Get-CrmPackages sammen med den parameteren –PackageName til at angive navnet på assemblyen i den mappe, der indeholder pakkedefinitionen.

   Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll
   

Bruge cmdletten til at oprette forbindelse til CRM-serveren

1. Angiv dine legitimationsoplysninger for at oprette forbindelse til din Microsoft Dynamics CRM Online- eller Microsoft Dynamics CRM (i det lokale miljø)-forekomst. Når du kører følgende kommando, bliver du bedt om at skrive dit brugernavn og din adgangskode for at oprette forbindelse til Dynamics 365-forekomsten, og vi gemmer den i variablen $Cred og bruger den senere til at oprette forbindelse til CRM-serveren.

   $Cred = Get-Credential
   

2. Brug følgende kommando til at få forbindelse til din Microsoft Dynamics CRM Online- eller Microsoft Dynamics CRM (i det lokale miljø)-forekomst. Vi gemmer forbindelsesoplysningerne i variablen $CRMConn:

   • Hvis du opretter forbindelse til Microsoft Dynamics CRM (i det lokale miljø)-forekomsten:

     $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred
     

   • Hvis du opretter forbindelse til Microsoft Dynamics CRM Online-serveren:

     $CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Cred
     

     Bemærk

     For parameteren DeploymentRegion er de gyldige værdier NorthAmerica, EMEA og APAC. For parameteren OnlineType er de gyldige værdier Office365 og LiveID.

3. Dine angivne legitimationsoplysninger valideres, når du kører kommandoen i trin 2.

Brug cmdletten til at installere pakker

Brug derefter de CRM-forbindelsesoplysninger, der er gemt i variablen $CRMConn til at installere pakker til Dynamics 365-forekomsten. Kør følgende kommando for at installere pakken:

Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -Verbose

Få detaljeret hjælp til cmdletter

I vinduet PowerShell skal du bruge Get-Help-cmdletten med et cmdlet-navn til at få vist detaljeret hjælp for cmdletten. Gør følgende f.eks. for at få detaljeret hjælp til Import-CrmPackage-cmdletten:

Get-Help Import-CrmPackage -full

Du kan se onlinehjælpen til cmdletterne i CRM PowerShell Reference.

Foretag fejlfinding af problemer med installation af pakken ved hjælp af logfiler

Pakkeimplementationsværktøj understøtter logføring for at få detaljerede oplysninger om fejl, der kan opstå, når en person logger på Microsoft Dynamics CRM-forekomsten ved hjælp af værktøjet og installerer pakker. Værktøjet genererer tre logfiler, der er tilgængelige på følgende placering på computeren, hvor du kører værktøjet: c:\brugere\<brugernavn>\AppData\Roaming\Microsoft\PackageDeployer\<version>.

• Login_ErrorLog.log: Indeholder oplysninger om de problemer, der opstod, da du brugte værktøjet til at logge på Dynamics 365-forekomsten. Hvis der er problemer under logon, vises der en meddelelse på værktøjets logonskærmen med et hyperlink til denne logfil. Meddelelsen angiver, at der opstod en fejl under behandlingen af logonanmodningen, og at brugeren kan få vist fejlloggen. Du kan klikke på hyperlinket i meddelelsen for at få vist denne logfil. Logfilen oprettes, første gang du har logonproblemer i værktøjet. Logfilen bruges derefter til at logge oplysninger om et logonproblem, når det opstår.

• PackageDeployer.log: Indeholder detaljerede oplysninger om hver opgave, der udføres i værktøjet under udrulning af pakkerne. Du kan få vist logfilen fra værktøjet ved at klikke på hyperlinket Vis logfil i bunden af skærmen.

• ComplexImportDetail.log: Indeholder detaljerede oplysninger om de data, der er importeret i den seneste udrulning ved hjælp af værktøjet. Hver gang du installerer en pakke ved hjælp af dette værktøj, flyttes de eksisterende oplysninger fra logfilen til en fil med navnet ComplexImportDetail._old.log i den samme mappe, og filen ComplexImportDetail.log angiver oplysninger om den seneste import, der er udført ved hjælp af værktøjet.

Bedste praksis for installation af pakker

Under installation af pakker skal Dynamics 365-administratorer:

• Insistere på i en signeret pakkeassembly, så de kan spore en assembly tilbage til kilden.

• Teste pakken på en forproduktionsforekomst (helst et spejlbillede af produktionsforekomsten), før du kører den på en produktionsserver.

• Sikkerhedskopiere produktionsforekomsten, før der installeres en pakke.

Se også

MSDN: Oprette pakker til CRM Package Deployer
Administrere CRM 2015

© 2016 Microsoft Corporation. Alle rettigheder forbeholdes. Ophavsret