Pakketten installeren met CRM Package Deployer en Windows PowerShell

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Met Microsoft Dynamics CRM Package Deployer kunnen beheerders pakketten implementeren op een Microsoft Dynamics CRM (on-premises)- of Microsoft Dynamics CRM Online-exemplaar. Een "pakket" kan bestaan uit enkele of alle van de volgende:

• Een of meer Dynamics 365-oplossingsbestanden.

• Vlakke bestanden of geëxporteerde gegevensbestanden van Hulpprogramma voor configuratiemigratie. Voor meer informatie over Hulpprogramma voor configuratiemigratie raadpleegt u Configuratiegegevens beheren.

• Aangepaste code die kan worden uitgevoerd tijdens of nadat het pakket is geïmplementeerd naar Microsoft Dynamics 365.

• HTML-inhoud specifiek voor het pakket die aan het begin en het einde van de pakketinstallatie kan worden weergeven. Dit kan handig zijn als u een beschrijving wilt geven van de oplossingen en bestanden die in het pakket worden geïnstalleerd.

Ontwikkelaars maken pakketten met de sjabloon voor pakketinstallatie in Microsoft Visual Studio.Meer informatie:MSDN: Pakketten maken voor CRM Package Deployer

Nadat het pakket is gemaakt, kunt u het distribueren door Pakketinstallatie voor CRM uit te voeren of door de Windows PowerShell-cmdlets voor het hulpprogramma te gebruiken.

In dit onderwerp

Het hulpprogramma CRM Pakketinstallatie gebruiken om pakketten te installeren

Windows PowerShell gebruiken om pakketten te distribueren

Problemen met pakketinstallatie oplossen met behulp van logboekbestanden

Aanbevolen procedures voor het implementeren van pakketten

Het hulpprogramma CRM Pakketinstallatie gebruiken om pakketten te installeren

Het Hulpmiddel Pakketimplementatie kan slechts één pakket tegelijk verwerken. Het biedt gebruikers echter de mogelijkheid een te installeren pakket te selecteren uit meerdere pakketten die beschikbaar zijn in de map Hulpmiddel Pakketimplementatie. Enkele van de schermen en acties in de tool variëren afhankelijk van de pakketdefinitie. U hoeft het Hulpmiddel Pakketimplementatie niet te installeren. Download het en voer het uit.

1. Zorg dat u beschikt over het te installeren pakket. Een pakket is een verzameling bestanden en mappen die is gemaakt in uw Visual Studio-projectmap (<Project>\Bin\Debug) wanneer u uw pakketproject in Visual Studio maakt. Kopieer het volgende uit uw projectdebugmap:

   • <Pakketnaam>-map: Deze map bevat de oplossingen, importconfiguratie en de inhoud voor uw pakket.

   • <Pakketnaam>.dll: De assembly bevat de code voor het pakket. Standaard is de naam van de assembly hetzelfde als de Visual Studio-projectnaam.

   Voor gedetailleerde informatie over het maken van een pakket met Visual Studio raadpleegt u MSDN: Een pakket maken voor het hulpmiddel Package Deployer.

   In dit onderwerp wordt ervan uitgegaan dat de pakketmap en de assembly uit de projectdebugmap Visual Studio (<Project>\Bin\Debug) worden gekopieerd naar de map c:\DeployPackage.

2. Download het Microsoft Dynamics CRM SDK-pakket. Voer het pakketbestand uit om de inhoud van het pakket uit te pakken.

3. Ga naar de map SDK\Tools\PackageDeployer en kopieer de pakketmap en de assembly van de map c:\DeployPackage naar de map SDK\Tools\PackageDeployer.

4. Nadat alle bestanden zijn gekopieerd, voert u het hulpprogramma uit door op het bestand PackageDeployer.exe te dubbelklikken in de map SDK\Tools\PackageDeployer.

5. Klik op Doorgaan in het hoofdscherm van het hulpmiddel.

6. Geef in het scherm Verbinding maken met Microsoft Dynamics CRM verificatiedetails op om verbinding te maken met uw Dynamics 365-server waar u het pakket wilt implementeren. Als u meer organisaties hebt, en de organisatie wilt selecteren waar u het pakket wilt implementeren, schakelt u het selectievakje Altijd de lijst met beschikbare organisaties weergeven in. Klik op Aanmelden.

7. Als u meer organisaties op uw Dynamics 365-server hebt en u het selectievakje Altijd de lijst met beschikbare organisaties weergeven hebt ingeschakeld, kunt u in het volgende scherm de organisatie kiezen waarmee u verbinding wilt maken. Selecteer een Dynamics 365-organisatie om verbinding mee te maken.

8. In het volgende scherm wordt u gevraagd een te installeren pakket te selecteren. Selecteer uw pakketnaam, en klik op Volgende.

   

9. Volg de instructies in de volgende schermen om de installatie van pakket te voltooien.

   De schermen worden weergegeven op basis van de definitie van het pakket die u hebt geselecteerd voor de installatie. Voor een complete pakketinstallatie die Hulpmiddel Pakketimplementatie gebruikt, raadpleegt u het onderwerp voor de installatie van Unified Service Desk-pakketten: Voorbeelden van Unified Service Desk-toepassingen op CRM-server implementeren met behulp van Package Deployer

Windows PowerShell gebruiken om pakketten te distribueren

Hulpmiddel Pakketimplementatie biedt ook Windows PowerShell-ondersteuning voor de installatie van pakketten.

Voer de volgende stappen uit om de Powershell-cmdlets te gebruiken om pakketten te distribueren:

Vereisten

De cmdlet registreren

De cmdlets gebruiken om pakketten op te halen

De cmdlet gebruiken om verbinding te maken met uw CRM-server

De cmdlets gebruiken om pakketten te installeren

Gedetailleerde Help krijgen over cmdlets

Vereisten

Dit zijn de vereisten voor het gebruik van de Powershell-cmdlets:

• Powershell 3.0 of later is vereist om een pakket te distribueren met Powershell. Als u uw versie van Powershell wilt controleren, opent u een Powershell-venster en voert u de volgende opdracht uit: $Host.

• Stel het uitvoeringsbeleid zo in dat het de ondertekende Powershell-scripts uitvoert. Als u dit wilt, opent u een Powershell-venster als beheerder en voert u de volgende opdracht uit: Set-ExecutionPolicy -ExecutionPolicy AllSigned

De cmdlet registreren

U moet de Windows PowerShell-cmdlets voor Hulpmiddel Pakketimplementatie registreren voordat u ze kunt gebruiken. De cmdlets registreren:

1. Download als u dat nog niet hebt gedaan het Dynamics 365 SDK-pakket uit het Microsoft Downloadcentrum en voer het pakketbestand uit om de inhoud van het pakket uit te pakken. Stel dat u het pakket hebt uitgepakt in de map c:\CRM op uw computer.Hulpmiddel Pakketimplementatie en de overige vereiste bestanden zijn dan beschikbaar op de volgende locatie: c:\CRM\SDK\Tools\PackageDeployer.

2. Start Windows PowerShell op uw computer met extra bevoegdheden (uitvoeren als beheerder).

3. Wijzig achter de prompt in het Windows PowerShell-venster de map in de map Windows PowerShell onder de map PackageDeployer. In dit geval:

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

4. Voer het script RegisterXRMTooling.ps1 uit om de Package Deployer Windows PowerShell-assembly (dll) te registreren en installeer de Windows PowerShell-module voor Hulpmiddel Pakketimplementatie. Hiervoor typt u de volgende opdracht en drukt u op ENTER:

   .\RegisterXRMTooling.ps1
   

5. Voeg de Windows PowerShell-module voor XRM tooling toe. Hierdoor worden de volgende cmdlets geregistreerd: Get-CrmConnection en Get-CrmOrganizations.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

6. Voeg de Windows PowerShell-module voor Pakketinstallatie toe. Hierdoor worden de volgende cmdlets geregistreerd: Get-CrmPackages en Import-CrmPackage.

   Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment
   

U bent nu klaar om deze Windows PowerShell-cmdlets te gebruiken. Als u de cmdlets die u hebt geïnstalleerd, wilt weergeven, voert u de volgende opdracht uit bij de prompt in het venster Windows PowerShell:

Get-Help “Crm”

De cmdlets gebruiken om pakketten op te halen

Voordat u de cmdlet kunt gebruiken, moet u het pakket hebben gekopieerd naar de map PackageDeployer (in dit geval c: \CRM\SDK\Tools\PackageDeployer). Een pakket is een verzameling bestanden en mappen die is gemaakt in uw Visual Studio-projectmap (<Project>\Bin\Debug) wanneer u uw project in Visual Studio maakt. Kopieer de volledige inhoud van uw projectdebugmap naar de map PackageDeployer. Voor gedetailleerde informatie over het maken van een pakket met Visual Studio raadpleegt u MSDN: Pakketten maken voor CRM Package Deployer.

1. In het venster Powershell gebruikt u de volgende cmdlet om een lijst te krijgen van pakketten die beschikbaar zijn voor import in de opgegeven map (in dit geval, c: \CRM\SDK\Tools\PackageDeployer):

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

2. Als u informatie over een pakket in een map wilt, kunt u de cmdlet Get-CrmPackages met de parameter - PackageName gebruiken om de naam van de assembly op te geven in de map die de pakketdefinitie bevat.

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

De cmdlet gebruiken om verbinding te maken met uw CRM-server

1. Geef de referenties op om verbinding te maken met uw Microsoft Dynamics CRM Online- of Microsoft Dynamics CRM (on-premises)-exemplaar. Als u de volgende opdracht uitvoert, wordt u gevraagd om uw gebruikersnaam en wachtwoord te typen om verbinding te maken met het Dynamics 365-exemplaar. Het wordt opgeslagen in de variabele $Cred en later gebruikt om verbinding te maken met uw CRM-server.

   $Cred = Get-Credential
   

2. Gebruik de volgende opdracht om verbinding te maken met uw Microsoft Dynamics CRM Online- of Microsoft Dynamics CRM (on-premises)-exemplaar. De verbindingsinformatie wordt opgeslagen in de variabele $CRMConn:

   • Als u verbinding maakt met het Microsoft Dynamics CRM (on-premises)-exemplaar:

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

   • Als u verbinding maakt met de Microsoft Dynamics CRM Online-server:

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

     Notitie

     Voor de parameter DeploymentRegion zijn geldige waarden NorthAmerica, EMEA en APAC. Voor de parameter OnlineType zijn geldige waarden Office365 en LiveID.

3. Uw opgegeven referenties worden gevalideerd wanneer u de opdracht in stap 2 uitvoert.

De cmdlets gebruiken om pakketten te installeren

Vervolgens gebruikt u de CRM-verbindingsinformatie die is opgeslagen in de variabele $CRMConn om pakketten te installeren op het Dynamics 365-exemplaar. Voer de volgende opdracht uit om het pakket te distribueren:

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

Gedetailleerde Help krijgen over cmdlets

In het Powershell-venster moet u de cmdlet Get-Help met een cmdlet-naam gebruiken om gedetailleerde Help voor de cmdlet weer te geven. U kunt bijvoorbeeld Help krijgen voor de cmdlet Import-CrmPackage:

Get-Help Import-CrmPackage -full

Als u de online help wilt zien voor de cmdlets, raadpleegt u CRM PowerShell-referentie.

Problemen met pakketinstallatie oplossen met behulp van logboekbestanden

Hulpmiddel Pakketimplementatie biedt logboekregistratieondersteuning om gedetailleerde informatie te krijgen over fouten die kunnen optreden wanneer iemand zich bij het Microsoft Dynamics CRM-exemplaar aanmeldt met het hulpmiddel en installatiepakketten. Het hulpmiddel genereert drie logboekbestanden die vanaf de volgende locatie beschikbaar zijn op de computer waarop u het hulpprogramma uitvoert: c: \Users\<UserName>\AppData\Roaming\Microsoft\PackageDeployer\<Versie>.

• Login_ErrorLog.log: Biedt informatie over de problemen die optreden als u het hulpmiddel gebruikt om u aan te melden bij het Dynamics 365-exemplaar. Als er tijdens de aanmelding problemen zijn, wordt een bericht weergegeven op het aanmeldingsscherm van het hulpmiddel met een koppeling naar dit logboekbestand. Het bericht stelt dat er een fout is opgetreden tijdens het verwerken van de aanmeldingsaanvraag en dat de gebruiker het foutlogboek kan bekijken. U kunt op de koppeling in het bericht klikken om dit logboekbestand weer te geven. Het logboekbestand wordt gemaakt de eerste keer dat er aanmeldproblemen in het hulpprogramma zijn. Daarna wordt het logboekbestand gebruikt om informatie vast te leggen over volgende aanmeldproblemen als die optreden.

• PackageDeployer.log: Biedt meer informatie over elke taak die in het hulpprogramma wordt uitgevoerd tijdens de installatie van de pakketten. U kunt het logboekbestand weergeven vanuit het hulpprogramma door te klikken op de link Logboekbestand weergeven, onder in het scherm.

• ComplexImportDetail.log: Biedt meer informatie over de gegevens die in de afgelopen installatie zijn geïmporteerd met het hulpprogramma. Telkens als u met dit hulpprogramma een pakket installeert, worden de bestaande gegevens van het logboekbestand verplaatst naar een bestand genaamd ComplexImportDetail._old.log in dezelfde map en bevat het bestand ComplexImportDetail.log informatie over de laatste import die met het hulpprogramma is uitgevoerd.

Aanbevolen procedures voor het implementeren van pakketten

Bij de distributie van pakketten moeten Dynamics 365-beheerders het volgende doen:

• Op een ondertekende pakketassembly aandringen zodat ze een assembly terug kunnen volgen naar de bron.

• Voordat u het pakket op een productie-exemplaar implementeert, moet u het pakket controleren op een pre-productie-exemplaar, bij voorkeur een spiegelbeeld van het productie-exemplaar.

• Maak een back-up van het productie-exemplaar voordat u het pakket implementeert.

Zie ook

MSDN: Pakketten maken voor CRM Package Deployer
CRM 2015 beheren

© 2016 Microsoft Corporation. Alle rechten voorbehouden. Auteursrecht