Uvajanje paketov z orodjem Dynamics CRM Package Deployer in lupino Windows PowerShell

Velja za: Dynamics 365 (v spletu), različica 9.x
Velja za: Dynamics 365 (v spletu), različica 8.x

Storitev Microsoft Dynamics CRM Package Deployer skrbnikom omogoča uvajanje paketov pri primerkih Dynamics 365 (on-premises) ali Dynamics 365 (online). »Paket« je lahko sestavljen iz nekaterih ali vseh naslednjih elementov:

  • Ena ali več datotek z rešitvijo Dynamics 365.

  • Datoteke z nestrukturiranimi podatki ali datoteke s podatki, izvoženimi iz orodja Configuration Migration. Če želite več informacij o orodju Configuration Migration, glejte Upravljanje konfiguracijskih podatkov.

  • Koda po meri, ki se lahko izvaja med ali po uvedbi paketa v program Dynamics 365.

  • Vsebina HTML, značilna za paket, ki se lahko prikažete na začetku in ob koncu procesa uvajanja paketa. To je lahko koristno za zagotavljanje opisa rešitev in datotek, ki se uvedejo v paketu.

    Razvijalci ustvarijo pakete z uporabo predloge za uvajanje paketov v programu Visual Studio. Več informacij: Ustvarjanje paketov za Dynamics 365 Package Deployer

    Ko ustvarite paket, ga lahko uvedete z orodjem CRM Package Deployer ali uporabo lupine Windows PowerShell.

Pomembno

Preden uvozite in zaženete paket v produkcijski organizaciji, paket preskusite na neprodukcijski zrcalni sliki produkcijske organizacije.

Preden uvedete paket, produkcijsko organizacijo vedno varnostno kopirajte.


Uvajanje paketov z orodjem Package Deployer

Orodje Package Deployer (packagedeployer.exe) lahko uporabite na naslednja načina za uvajanje paketov.

Uporaba orodja CRM Package Deployer za uvajanje paketov

Uporaba orodja CRM Package Deployer prek ukazne vrstice

Uporaba orodja Package Deployer za uvajanje paketov

Package Deployer lahko obdela samo en paket hkrati. Vendar uporabnikom ponuja možnost izbire paketa za uvedbo med več paketi, ki so na voljo v imeniku orodja Package Deployer. Nekateri zasloni in dejanja v orodju se razlikujejo glede na definicijo paketa. Namestitev orodja Package Deployer ni potrebna. Preprosto ga prenesete in zaženete.

  1. Pridobite paket, ki ga želite uvesti. Paket je zbirka datotek in map, ki se ustvari v projektni mapi Visual studio (<Project> \Bin\Debug), ko ustvarite paketni projekt v programu Visual Studio. Kopirajte naslednje elemente iz projektne mape za iskanje napak:

    • Mapa <ImePaketa>: v tej mapi so rešitve, konfiguracije uvoza in vsebine za vaš paket.

    • <ImePaketa>.dll: v zbiru je koda vašega paketa. Privzeto je ime zbira enako kot ime projekta Visual Studio.

      Za podrobne informacije o ustvarjanju paketa s programom Visual Studio glejte Ustvarjanje paketov z orodjem Package Deployer.

      V tej temi predvidevamo, da sta mapa s paketom in zbir v projektni mapi za iskanje napak Visual Studio (<Project> \Bin\Debug) kopirana v mapo c:\DeployPackage.

  2. Pridobite orodje Package Deployer. Orodje Package Deployer je na voljo v obliki paketa NuGet. Če želite uporabiti orodje Package Deployer, ga prenesite in z datoteko nuget.exe datoteke izvlecite v lokalni računalnik.

    Z mesta https://www.nuget.org/downloads prenesite datoteko nuget.exe in jo shranite v računalnik, na primer na lokacijo d:\. Nato po ukaznem pozivu izvedite naslednji ukaz, da v računalnik v mapo (na primer PD) izvlečete vsebino paketa:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    Ko izvlečete datoteke za orodje Package Deployer, pojdite v mapo [ExtractedLocation]\tools in poiščite datoteko PackageDeployer.exe.

  3. Kopirajte mapo s paketom in zbir iz mape c:\DeployPackage v mapo [ExtractedLocation]\tools.

  4. Ko so datoteke kopirane, zaženite orodje z dvoklikom datoteke PackageDeployer.exe v mapi [ExtractedLocation]\tools.

  5. Kliknite Nadaljuj na glavnem zaslonu orodja.

  6. Na zaslonu Vzpostavljanje povezave s programom Microsoft Dynamics 365 vnesite podrobnosti za preverjanje pristnosti za strežnik Dynamics 365, v katerega želite uvesti paket. Če imate več organizacij in želite izbrati organizacijo, v katero želite uvesti paket, izberite potrditveno polje Vedno prikaži seznam organizacij, ki so na voljo. Kliknite Prijava.

  7. Če imate v strežniku Dynamics 365 več organizacij, izberite organizacijo Dynamics 365, s katero se želite povezati.

  8. Izberite paket, ki ga želite uvesti, in kliknite Naprej.

    Izbira želenega paket v orodju Package Deployer

  9. Sledite navodilom na naslednjih zaslonih, da zaključite uvedbo paketa.

    Zasloni se prikažejo glede na definicijo paketa, ki ste jo izbrali za uvajanje. Za celovito uvajanje paketa, ki uporablja orodje Package Deployer, glejte temo za uvajanje paketov Unified Service Desk: Uvajanje vzorčnih programov središča za storitve Unified Service Desk v strežnik CRM z orodjem Package Deployer.

Uporaba orodja Package Deployer prek ukazne vrstice

Skrbniki sistema in prilagojevalci lahko orodju packagedeployer.exe posredujejo parametre, kot so regionalne jezikovne kode, prek ukazne vrstice. Te parametre lahko konfigurirate samo tako, da orodje Package Deployer zaženete prek ukazne vrstice.

Opomba

Ta funkcija je bila prvič predstavljena v paketu posodobitev Paket posodobitev 0.1 za Dynamics CRM Online 2016.

V naslednji tabeli so navedeni parametri, ki so na voljo.

Parameter Opis Privzeta vrednost
RuntimePackageSettings Orodju packagedeployer.exe da navodilo, da sprejme parametre ukazne vrstice, npr. LCID in SkipChecks. Ni na voljo
LCID=localeID Določi območno nastavitev, npr. 1033 za angleščino – ZDA ali 1036 za francoščino – Francija, iz območnih nastavitev, ki so na voljo v paketu. Če območna nastavitev ni določena, bo uporabljen privzeti jezik. Uporabi privzeti jezik
SkipChecks=true/false Ta parameter uporabite le, ko ciljno okolje ne vsebuje drugih rešitev ali prilagoditev. Ko ima parameter vrednost »false«, bo uvoz rešitev obšel nekatera varnostna preverjanja, kar lahko izboljša učinkovitost uvoza. Ne drži

Naslednji primer da orodju CRM Package Deployer navodilo, da obide nekatera varnostna preverjanja in kot jezik za uvoz nastavi poljščino.

packagedeployer.exe RuntimePackageSettings SkipChecks=true | lcid=1045  

Opomba

Uporabite navpičnico | za ločevanje parametrov, ko packagedeployer.exe izvajate prek ukazne vrstice z več parametri.

Če želite več informacij o parametrih in vrednostih, ki jih je mogoče posredovati za packagedeployer.exe, glejte Ustvarjanje paketov z orodjem CRM Package Deployer.

Uporaba lupine Windows PowerShell za uvajanje paketov

Orodje Package Deployer pri uvajanju paketov zagotavlja tudi podporo lupine Windows PowerShell.

Po naslednjih navodilih uporabite ukaze »cmdlet« PowerShell za uvajanje paketov.

Zahteve

Uvoz modula lupine PowerShell za Package Deployer

Uporaba ukazov »cmdlet« za pridobivanje paketov

Uporabite ukaz »cmdlet« za povezavo s strežnikom Dynamics 365 Server

Uporaba ukazov »cmdlet« za uvajanje paketov

Prikažite podrobno pomoč za ukaze »cmdlet«

Zahteve

To so zahteve za uporabo ukazov »cmdlet« PowerShell:

  • Za uvajanje paketov z lupino PowerShell potrebujete PowerShell različice 3.0 ali novejšo različico. Preverite nameščeno različico PowerShell, tako da zaženete okno PowerShell in zaženete naslednji ukaz: $Host

  • Nastavite, da pravilnik za zagon zažene podpisane skripte PowerShell. To storite tako, da zaženete okno PowerShell kot skrbnik in nato zaženete naslednji ukaz: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Uvoz modula lupine PowerShell za Package Deployer

Modul lupine Windows PowerShell za orodje Package Deployer morate registrirati, preden ga lahko uporabite. Uvozite tako:

  1. Pridobite datoteke PowerShell za Package Deployer. Datoteke lupine PowerShell za orodje Package Deployer so na voljo v obliki paketa NuGet. Če jih želite uporabiti, prenesite paket in z datoteko nuget.exe datoteke izvlecite v lokalni računalnik.

    Z mesta https://www.nuget.org/downloads prenesite datoteko nuget.exe in jo shranite v računalnik, na primer na lokacijo d:\. Nato po ukaznem pozivu izvedite naslednji ukaz, da v računalnik v mapo (na primer PD-PowerShell) izvlečete vsebino paketa:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.PowerShell -Version [VERSION] -O d:\PD-PowerShell

    Ko izvlečete datoteke lupine PowerShell za orodje Package Deployer, pojdite v mapo [ExtractedLocation]\tools in poiščite zahtevane datoteke.

  2. Zaženite Windows PowerShell v računalniku z zvišanimi pravicami (zaženite kot skrbnik).

  3. Po pozivu v oknu Windows PowerShell spremenite imenik v mapo, kjer ste razširili datoteke. V tem primeru:

    cd [ExtractedLocation]\tools\  
    
  4. Zaženite skript RegisterXRMPackageDeployment.ps1, na voljo v mapi [ExtractedLocation]\tools, tako da zaženete naslednji ukaz:

    .\RegisterXRMPackageDeployment.ps1  
    

    Zdaj ste pripravljeni za uporabo ukazov »cmdlet« Windows PowerShell. Če želite prikazati ukaze »cmdlet«, ki ste jih registrirali, zaženite naslednji ukaz ob pozivu v oknu Windows PowerShell:

Get-Help “Crm”  

Uporaba ukazov »cmdlet« za pridobivanje paketov

Preden uporabite ukaz »cmdlet«, zagotovite, da ste kopirali paket v mapo orodja PackageDeployer (v tem primeru [ExtractedLocation]\tools). Paket je zbirka datotek in map, ki se ustvari v projektni mapi Visual Studio (<Project> \Bin\Debug), ko ustvarite projekt v programu Visual Studio. Kopirajte celotno vsebino projektne mape za razhroščevanje v mapo PackageDeployer. Za podrobne informacije o ustvarjanju paketa z uporabo programa Visual Studio glejte Ustvarjanje paketov z orodjem CRM Package Deployer.

  1. V oknu PowerShell uporabite naslednji ukaz »cmdlet«, da prikažete seznam paketov, ki so na voljo za uvoz v navedeno mapo, (v tem primeru c:\CRM\SDK\Tools\PackageDeployer):

    Get-CrmPackages –PackageDirectory [ExtractedLocation]\tools  
    
  2. Če želite informacije o paketu v mapi, lahko uporabite ukaz »cmdlet« Get-CrmPackages skupaj s parametrom –PackageName, da določite ime zbira v mapi, ki vsebuje definicijo paketa.

    Get-CrmPackages –PackageDirectory [ExtractedLocation]\tools –PackageName SampleCRMPackage.dll  
    
    
  3. Mesto zbira paketa lahko shranite v spremenljivki z ukazom »cmdlet« Get-CrmPackages. Nato ga lahko znova uporabite z ukazom »cmdlet« Import-CrmPackage in določite vrednost za parameter PackageDirectory. Primer: podatke enega ali več paketov, ki jih vrne ukaz »cmdlet« Get-CrmPackages, lahko shranite v spremenljivki z imenom $MyPackages.

    $MyPackages = Get-CrmPackages –PackageDirectory [ExtractedLocation]\tools   
    

    Če želite prikazati vse pakete.

    $MyPackages  
    

    Če želite prikazati samo tretji paket.

    $MyPackages[2].PackageAssemblyLocation  
    

    Nato lahko določite sklice za vsak paket v naboru od 0 do n. Primer: ta ukaz »cmdlet« uvozi prvi paket, najden v imeniku $MyPackages.

    Import-CrmPackage -CrmConnection $CRMConn -PackageDirectory $MyPackages[0].PackageAssemblyLocation  
    

Uporabite ukaz »cmdlet« za povezavo s primerkom Dynamics 365

  1. Zagotovite poverilnice za povezavo s primerkom Dynamics 365 (online) ali Dynamics 365 (on-premises). Po zagonu naslednjega ukaza se bo prikazal poziv za vnos uporabniškega imena in gesla za povezavo s primerkom Dynamics 365, ki ju bomo shranili v spremenljivki $Cred in pozneje uporabili za povezovanje v strežnik Dynamics 365 Server.

    $Cred = Get-Credential  
    
  2. Uporabite naslednji ukaz za vzpostavitev povezave s primerkom Dynamics 365 (online) ali Dynamics 365 (on-premises). Informacije o povezavi bomo shranili v spremenljivki $CRMConn:

    • Če vzpostavljate povezavo s primerkom Dynamics 365 (on-premises):

      $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred  
      
    • Če vzpostavljate povezavo s strežnikom Dynamics 365 (online):

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

      Opomba

      Veljavne vrednosti za parameter DeploymentRegion so NorthAmerica, EMEA, APACSouthAmerica, Oceania, JPN in NorthAmerica2. Veljavne vrednosti za parameter OnlineType so Office365 in LiveID.

  3. Navedene poverilnice se preverijo, ko zaženete ukaz v 2. koraku.

Uporaba ukazov »cmdlet« za uvajanje paketov

Nato uporabite informacije o povezavi Dynamics 365, shranjene v spremenljivki $CRMConn, za uvajanje paketov v primerek programa Dynamics 365. Naslednji ukaz uvede paket, razstavi paket v mapi c:\UnpackedFiles in zapiše podatke v dnevniško datoteko v mapi c:\MyLogFiles.

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

Opomba

  • Parametri CrmConnection, PackageDirectory in PackageName so obvezni.

  • Namesto ročnega določanja mape za paket lahko uporabite spremenljivko s parametrom PackageDirectory. Več informacij: Uporaba ukazov »cmdlet« za pridobivanje paketov

  • Za parameter PackageName morate navesti ime zbira, ki vsebuje definicijo paketa.

  • Parametra UnpackFilesDirectory vam ni treba določiti, če paket med uvajanjem paketa ne razpakira datotek. Ko definirate paket v programu Visual Studio, določite, ali se datoteke odpakirajo z uporabo parametra agentdesktopzipfile v datoteki ImportConfig.xml. Več informacij: Ustvarjanje paketov z orodjem CRM Package Deployer

  • Parameter Verbose je neobvezen in se uporablja za prikaz podrobnega dnevnika dejavnosti, ki se izvajajo v procesu uvajanja paketa.

  • Izbirni parameter RuntimePackageSettings je mogoče uporabljati skupaj z naslednjimi parametri:

    • Parameter LCID=localeID določi območno nastavitev, npr. 1033 za angleščino – ZDA ali 1036 za francoščino – Francija, iz območnih nastavitev, ki so na voljo v paketu. Če območna nastavitev ni določena, bo uporabljen privzeti jezik.
    • Parameter SkipChecks=true/false uporabite le, ko ciljno okolje ne vsebuje drugih rešitev ali prilagoditev. Ko ima parameter vrednost »false«, bo uvoz rešitev obšel nekatera varnostna preverjanja, kar lahko izboljša učinkovitost uvoza.
  • Mapa, ki jo navedete, ko uporabljate parameter LogWriteDirectory, mora že obstajati, uporabnik, ki izvaja ukaz »cmdlet« Import-CrmPackage pa mora imeti dovoljenje za pisanje v mapo. Poleg tega pri uporabi parametra LogWriteDirectory potreben tudi parameter -Verbose.

    Parameter LogWriteDirectory je bil predstavljen v različici Dynamics 365 (v spletu), različica 9.0. Več informacij: Priročnik za razvijalce za Dynamics 365 Customer Engagement

Naslednji primer ukaza uvozi paket z imenom SampleCRMPackage in za jezik uvoza paketa določi angleščino – ZDA (1033).

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

Prikažite podrobno pomoč za ukaze »cmdlet«

V oknu PowerShell uporabite ukaz »cmdlet« Get-Help z imenom ukaza »cmdlet« za ogled podrobne pomoči za ukaz »cmdlet«. Če želite na primer prikazati podrobno pomoč za ukaz »cmdlet« Import-CrmPackage:

Get-Help Import-CrmPackage -full  

Če si želite ogledati spletno pomoč za ukaze »cmdlet«, glejte Priročnik za Dynamics 365 PowerShell.

Odpravljanje težav pri uvajanju paketov z dnevniškimi datotekami

Orodje Package Deployer zagotavlja podporo beleženja za pridobivanje podrobnih informacij o napakah, ki se lahko pojavijo, ko se oseba prijavi v primerek programa Microsoft Dynamics 365 z orodjem in uvaja pakete. Orodje privzeto ustvari tri dnevniške datoteke, ki so na voljo na naslednjem mestu v računalniku, v katerem zaženete orodje: c:\Users\<UserName\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Če želite določiti drugo mapo, uporabite parameter -LogWriteDirectory PowerShell ukaza »cmdlet«. Več informacij: Uporaba ukazov »cmdlet« za pridobivanje paketov

  • Login_ErrorLog.log: Zagotavlja informacije o težavah, ki so se pojavile, ko ste uporabili orodje za vpis v primerek Dynamics 365. Če obstajajo težave pri prijavi, se na zaslonu za prijavo v orodju prikaže sporočilo s povezavo do te dnevniške datoteke. Sporočilo navaja, da je prišlo do napake med obdelavo zahteve za prijavo in da si lahko uporabnik ogleda dnevnik napak. Kliknete lahko povezavo v sporočilu, da prikažete to dnevniško datoteko. Dnevniška datoteka se ustvari, ko prvič naletite na težavo pri prijavi v orodje. Nato se dnevniška datoteka uporabi za beleženje informacij o težavah pri vpisu, kadar se pojavijo.

  • PackageDeployer.log: Zagotavlja podrobne informacije o vsakem opravilu, izvedenem v orodju med uvajanjem paketov. Dnevniško datoteko si lahko ogledate v orodju, tako da kliknete povezavo Prikaz dnevniške datoteke na dnu zaslona.

  • ComplexImportDetail.log: Zagotavlja podrobne informacije o podatkih, uvoženih v zadnjem uvajanju z uporabo orodja. Ob vsakem uvajanju paketa z uporabo tega orodja se obstoječe podrobnosti iz dnevniške datoteke premaknejo v datoteko z imenom ComplexImportDetail._old.log v istem imeniku in datoteka ComplexImportDetail.log prikazuje informacije o zadnjem uvozu, opravljenem z orodjem.

Najboljše prakse za uvajanje paketov

Med uvajanjem paketov Dynamics 365 morajo skrbniki:

  • Vztrajati pri podpisanem zbiru paketov, da lahko poiščejo vir zbira.

  • Preskusiti paket na predprodukcijskem primerku (po možnosti zrcalni sliki produkcijskega primerka) pred zagonom na produkcijskem strežniku.

  • Varnostno kopirati produkcijski primerek pred uvedbo paketa.

Glejte tudi

Ustvarjanje paketov z orodjem CRM Package Deployer