Csomagok telepítése a Dynamics CRM Package Deployer eszköz és a Windows PowerShell használatával

 

Közzétéve: 2017. február

Hatókör: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Megjegyzés

Az itt megadott információk a(z) Dynamics 365 Dynamics 365 (online) 9.0-s verzió előtti kiadásokra vonatkoznak. A legújabb dokumentációért lásd: Csomagok telepítése a Dynamics CRM Package Deployer eszköz és a Windows PowerShell használatával.

A Microsoft Dynamics CRM Package Deployer lehetővé teszi rendszergazdák számára a csomagok központi telepítését a Dynamics 365 (helyszíni) vagy a Microsoft Dynamics 365 (online) egyes példányaira. Egy „csomag” összetevői az alábbiak lehetnek:

• Egy vagy több Dynamics 365 megoldásfájl.

• Egyszintű (flat) fájlok vagy a Konfigurációs áttelepítési eszköz eszközből exportált adatfájlok. A Konfigurációs áttelepítési eszköz működésével kapcsolatban további információért lásd: Konfigurációs adatok kezelése.

• A csomag Microsoft Dynamics 365 rendszerbe való telepítése során vagy után futtatható egedi kódok.

• A csomagra jellemző egyedi HTML-tartalom, amely a csomag telepítésének elején vagy végén jeleníthető meg. Ez egy hasznos eszköz a csomagban telepített megoldások és fájlok leírására.

A fejlesztők a Microsoft Visual Studio alkalmazásban található csomagtelepítési sablon használatával hozhatnak létre csomagokat.További információ:MSDN: Csomagok létrehozása a CRM Package Deployer számára

Egy csomag létrehozása után a CRM Csomagtelepítő futtatásával vagy Windows PowerShell parancsmagok eszközzel való használatával telepítheti azt.

Fontos

Mielőtt importálna és lefuttatna egy csomagot egy termelési szervezetben, tesztelje le a csomagot egy termelésen kívüli szervezeten, amely a termelési szervezet pontos mása.

Egy csomag telepítése előtt mindig készítsen biztonsági másolatot a termelési szervezetről.

Jelen témakörben

Csomagok telepítése a Csomagtelepítő eszköz segítségével

Csomagok telepítése a Windows PowerShell segítségével

A csomagtelepítés hibáinak elhárítása a naplófájlok segítségével

Gyakorlati tanácsok a csomagok telepítéséhez

Csomagok telepítése a Csomagtelepítő eszköz segítségével

Használhatja a Csomagtelepítő eszköz (packagedeployer.exe) csomagok telepítésére az alábbi módon.

Csomagok telepítése a Csomagtelepítő eszköz segítségével

A Csomagtelepítő eszköz használata a parancssorból:

Csomagok telepítése a Csomagtelepítő eszköz segítségével

A Csomagtelepítő eszköz egyszerre csak egy csomagot tud feldolgozni. Azonban lehetővé teszi af elhasználó számára, hogy a Csomagtelepítő eszköz tárban elérhető több csomagból telepítő csomagot válasszon ki. Az eszközben található egyes képernyők és műveletek a csomagdefiníciótól függően eltérőek lehetnek. Nem szükséges telepítenie a Csomagtelepítő eszköz eszközt. Elég ha letölti és futtatja.

1. Szerezze be a telepíteni kívánt csomagot. A csomag mappák és fájlok készlete, amely saját Visual Studio projektmappájában jön létre (<Project>\Bin\Debug), amikor csomagját felépíti a Visual Studio alkalmazásban. Másolja át hibakeresési mappájának tartalmából a következő elemeket:

   • <PackageName> mappa: Ez a mappa tartalmazza csomagja megoldásait, importálási konfigurációt, és tartalmát.

   • <PackageName>.dll: A szerelvény tartalmazza csomagjának kódját. Alapértelmezés szerint a szerelvény neve megegyezik Visual Studio projektjének nevével.

   A csomagok Visual Studio használatával való létrehozásáról részletesebb információért lásd: MSDN: Csomag létrehozása a Package Deployer eszközzel.

   Ehhez a témakörhöz, tételezzük fel, hogy a csomagmappa és a szerelvény a Visual Studio projekt hibakeresési mappájából(<Projekt>\Bin\Debug) át lett másolva a c:\DeployPackage mappába.

2. A Microsoft Dynamics CRM SDK letöltése. Majd futtassa a letöltött végrehajtható fájlt a csomag tartalmának kibontásához.

3. Keresse meg a SDK\Tools\PackageDeployer mappát, és másolja át a csomagmappát és a szerelvényt a c:\DeployPackage mappából a SDK\Tools\PackageDeployer mappába.

4. A fájlok átmásolása után, az eszköz futtatásához kattintson duplán a SDK\Tools\PackageDeployer mappában található PackageDeployer.exe fájlra.

5. Az eszköz fő képernyőjén kattintson a Tovább gombra.

6. A Csatlakozás a Microsoft Dynamics 365 alkalmazáshoz képernyőn adja meg a hitelesítő adatokat annak érdekében, hogy csatlakozhasson azon Dynamics 365 szerveréhez, amelyen központilag telepíteni kívánja a csomagot. Ha több szervezete van, és ezek közül ki szeretné választani azt, ahol a csomagot telepíteni kívánja, akkor jelölje meg Az elérhető szervezetek listájának mindenkori megjelenítése jelölőmezőt. Kattintson a Bejelentkezés gombra.

7. Ha több szervezete is van Dynamics 365 kiszolgálóján, jelölje ki azt a Dynamics 365 szervezetet, amelyhez kapcsolódni kíván.

8. Jelölje ki a telepíteni kívánt csomagot, majd kattintson a Tovább lehetőségre.

   

9. A következő képernyőkön kövesse az utasításokat a csomag telepítésének befejezéséhez.

   A képernyők a telepítésre kiválasztott csomag definíciója alapján jelennek meg. A Csomagtelepítő eszköz eszközzel való teljeskörű csomagtelepítéshez lásd a Unified Service Desk csomagok központi telepítéséről szóló témakört: Egységes ügyfélszolgálati példaalkalmazás központi telepítése a CRM szerverre a Package Deployer segítségével

A Csomagtelepítő eszköz használata a parancssorból:

A rendszergazdák és a testreszabók a parancssorból is megadhatnak paramétereket (pl. régió nyelvi kódja) a packagedeployer.exe számára. Ezeket a paraméterek csak a Csomagtelepítő eszköz parancssorból történő futtatása esetén konfigurálhatók.

Megjegyzés

Ez a szolgáltatás először a Microsoft Dynamics CRM Online 2016 0.1. frissítés verzióban jelent meg.

A rendelkezésre álló paraméterek megtalálhatók ebben a táblázatban.

Paraméter	Leírás	Alapértelmezett érték
RuntimePackageSettings	Utasítja a packagedeployer.exe alkalmazást, hogy fogadjon el parancssori paramétereket, mint az LCID és a SkipChecks.	Nem alkalmazható
LCID=localeID	Megadja a területi azonosítót (például az 1033 az angol-Egyesült Államok, az 1036 a francia-Franciaország) a csomagban elérhető területi azonosítók közül. Ha nincs megadva, az alapértelmezett nyelvet használja az alkalmazás.	Az alapértelmezett nyelv használata
SkipChecks=true/false	Ezt a paramétert csak akkor használja, ha a célkörnyezet nem tartalmaz semmilyen más megoldást vagy testreszabást. Ha az értéke „igaz”, a megoldásimportálás kihagy néhány biztonsági ellenőrzést, így javítva az importálás teljesítményét.	Hamis

A következő példa arra utasítja a CRM Csomagtelepítő alkalmazást, hogy hagyjon ki néhány biztonsági ellenőrzést, és hogy a lengyel nyelvet importálja.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

Megjegyzés

Használja a függőleges vonás karaktert | a paraméterek elválasztásához, ha a parancssorból futtatja a packagedeployer.exe alkalmazást, és több paramétert is megad.

További információk a packagedeployer.exe paramétereiről és a megadhat értékekről: MSDN: Csomagok létrehozása a CRM Package Deployer segítségével.

Csomagok telepítése a Windows PowerShell segítségével

A Csomagtelepítő eszköz a Windows PowerShell alkalmazást is támogatja a csomagok telepítéséhez.

A következő lépésekkel használhatja a PowerShell parancsmagokat csomagok telepítésére:

Előfeltételek

A parancsmagok regisztrálása

Csomagok beolvasása parancsmag használatával

Kapcsolódás a Dynamics 365-példányhoz parancsmag segítségével

Csomagok telepítése parancsmag használatával

Parancsmagok részletes súgója

Előfeltételek

A PowerShell parancsmagok használatának előfeltételei:

• A PowerShell 3.0 vagy későbbi verziója szükségs a csomagok PowerShell alkalmazással történő telepítéséhez. A PowerShell verziószám ellenőrzéséhet futtasson egy PowerShell ablakot, majd futtassa rajta a következő parancsot: $Host

• A végrehajtási házirendet állítsa be a regisztrált PowerShell parancsfájlok futtatására. Ehhez futtasson egy PowerShell ablakot rendszergazdaként, majd futtassa a következő parancsot: Set-ExecutionPolicy -ExecutionPolicy AllSigned

A parancsmagok regisztrálása

A Windows PowerShell parancsmagokat használat előtt regisztrálnia kell a Csomagtelepítő eszköz számára. A parancsmagok regisztrálása:

1. Ha még nem tette meg, töltse le a Dynamics 365 SDK-csomagot a Microsoft letöltőközpont tárából, majd futtassa a csomagfájlt a csomag tartalmának kitömörítéséhez. Tegyük fel, hogy kibontotta a csomagot a c:\CRM mappába a számítógépén. A Csomagtelepítő eszköz és a többi szükséges fájl elérhető az alábbi helyen: c:\CRM\SDK\Tools\PackageDeployer.

2. Indítsa el a Windows PowerShell alkalmazást számítógépén, emelt szintű jogokkal (futtatás rendszergazdaként).

3. A Windows PowerShell ablak parancssorában módosítsa az elérési könyvtárat a Windows PowerShell mappára, amely a PackageDeployer mappán belül található. Ebben az esetben:

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

4. Futtassa a RegisterXRMTooling.ps1 parancsfájlt a Package Deployer Windows PowerShell szerelvényének (dll) regisztrációjához, majd telepítse a Windows PowerShell beépülő modult a Csomagtelepítő eszköz számára. Ehhez gépelje be a következő parancsot, majd nyomja le az Enter billentyűt:

   .\RegisterXRMTooling.ps1
   

5. Adja hozzá az XRM-tooling Windows PowerShell beépülő modulját. Ezzel a következő parancsmagokat regisztrálja: Get-CrmConnection és Get-CrmOrganizations.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

6. Adja hozzá a Package Deployer Windows PowerShell beépülő modulját. Ezzel a következő parancsmagokat regisztrálja: Get-CrmPackages és Import-CrmPackage.

   Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment
   

Ezzel készen is áll ezen Windows PowerShell parancsmagok használatára. A regisztrált parancsmagok listázásához futtassa a következő parancsot a Windows PowerShell ablak parancssorában:

Get-Help “Crm”

Csomagok beolvasása parancsmag használatával

A parancsmag használata előtt ellenőrizze, hogy átmásolta csomagját a PackageDeployer mappába (ebben az esetben, c:\CRM\SDK\Tools\PackageDeployer). A csomag mappák és fájlok olyan készlete, amelyet saját Visual Studio projektmappájában hozhat létre (<Projekt>\Bin\Debug), amikor projektjét felépíti a Visual Studio alkalmazásban. Másolja át projektjének teljes hibakeresési mappáját a PackageDeployer mappába. A csomagok Visual Studio használatával való összeállításáról szóló részletesebb információkért lásd: MSDN: Csomagok létrehozása a CRM Package Deployer eszközzel.

1. A PowerShell ablakban a következő parancsmag segítségével hívható be azon csomagok listája, amelyek rendelkezésre állnak a megadott mappába való importáláshoz (ebben az esetben, c:\CRM\SDK\Tools\PackageDeployer):

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

2. Ha információt szeretne egy mappa valamely csomagjával kapcsolatban, akkor a Get-CrmPackages parancsmag és a –PackageName paraméter használatával határozhatja meg a szerelvény nevét a csomagdefiníciót tartalmazó mappában.

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

3. A csomagok összeállítási helyét a Get-CrmPackages parancsmag segítségével tárolhatja a változó. Ez felhasználható az Importálás-CrmPackage parancsmagban a PackageDirectory paraméter értékének meghatározásához. Például egy vagy több csomag a Get-CrmPackages parancsmagból lekérdezett információját a $MyPackages nevű változóban tárolhatja.

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

   Minden csomag megjelenítéséhez.

   $MyPackages
   

   A harmadik csomag megjelenítéséhez.

   $MyPackages[2].PackageAssemblyLocation
   

   Majd 0-tól n-ig a tömbön belüli minden csomagra is hivatkozhatnak. Példáulez a parancsmag importálja a $MyPackages részben található első csomagot importálja.

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

   Megjegyzés

   A PackageAssemblyLocation paraméter és a mappa elérhetősége és a csomag neve megjelenítésének képessége elsőként itt került bemutatásra: 2016 decemberi frissítés a Dynamics 365 rendszerhez (online és helyszíni).További információ:Dynamics 365 SDK

Kapcsolódás a Dynamics 365-példányhoz parancsmag segítségével

1. Adja meg a hitelesítő adatokat saját Microsoft Dynamics 365 (online) vagy Dynamics 365 (helyszíni) példányához való kapcsolódáshoz. A következő parancs futtatásával a rendszer elkéri a felhasználónevet és a jelszót, amellyel a Dynamics 365 példányhoz csatlakozhat, és azokat a $Cred változóban tárolja, ahonnan később felhasználhatja majd a Dynamics 365-szervezhez való csatlakozáshoz.

   $Cred = Get-Credential
   

2. A következő paranccsal létesíthet kapcsolatot a Microsoft Dynamics 365 (online) vagy Dynamics 365 (helyszíni) példánnyal. A kapcsolati információit a $CRMConn változóban tároljuk:

   • Ha a Dynamics 365 (helyszíni) példányhoz kapcsolódik:

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

   • Ha a Microsoft Dynamics 365 (online) szerverhez kapcsolódik:

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

     Megjegyzés

     A DeploymentRegion paraméter érvényes értékei: NorthAmerica, EMEA, APACSouthAmerica, Oceania, JPN és NorthAmerica2. A OnlineType paraméter érvényes értékei: Office365 and LiveID.

3. A megadott hitelesítő adatait a rendszer a 2. lépésben található parancs futtatásakor ellenőrzi.

Csomagok telepítése parancsmag használatával

Ezután a $CRMConn változóban tárolt Dynamics 365 kapcsolati információk használatával telepítse a csomagokat a Dynamics 365 példányon. A következő parancs telepít egy csomagot, visszafejti a csomagot az c:\UnpackedFiles mappára, és a bejegyzések információit a naplófájlban a c:\MyLogFiles mappába.

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

Megjegyzés

• A CrmConnection, PackageDirectory, és PackageName paraméterek kötelezőek.

• Ahelyett, hogy manuálisan adná meg a csomag mappáját, használhatja a PackageDirectory paraméter változóját is.További információ:Csomagok beolvasása parancsmag használatával

• A PackageName paraméterhez meg kell adnia a csomag definícióját tartalmazó szerelvény nevét.

• Ha a csomag a telepítés során nem csomagol ki fájlokat, akkor nem kell megadni a UnpackFilesDirectory paramétert. A csomag Visual Studio alkalmazásban való definiálása során megadhatja, hogy a rendszer az ImportConfig.xml fájlban található agentdesktopzipfile paramétert használja-e a kicsomagoláshoz.További információ:MSDN: Csomagok létrehozása a CRM Package Deployer számára

• A Verbose paraméter, amely a csomag telepítési folyamata során végzett tevékenységek részletes naplójának megjelenítésére szolgál, nem kötelező elem.

• A választható RuntimePackageSettings paraméter az alábbi paraméterekkel együtt használható:

  • Az LCID=localeID paraméter megadja a területi azonosítót (például az 1033 az angol-Egyesült Államok, az 1036 a francia-Franciaország) a csomagban elérhető területi azonosítók közül. Ha nincs megadva, az alapértelmezett nyelvet használja az alkalmazás.

  • A

    A SkipChecks=true/false paramétert csak akkor szabad használni ha a célkörnyezet nem tartalmaz semmilyen más megoldást vagy testreszabást. Ha az értéke „igaz”, a megoldás-importálás kihagy néhány biztonsági ellenőrzést, így javítva az importálási teljesítményt.

• A LogWriteDirectory paraméter használatakor megadott mappának már léteznie kell, és az Importálás-CrmPackage parancsmagot futtató felhasználónak pedig írási jogosultsággal kell rendelkeznie a mappába. Emellett - Részletes paraméter szükséges, ha a LogWriteDirectory paramétert használja.

  A LogWriteDirectory paraméter először itt jelent meg: 2016 decemberi frissítés a Dynamics 365 rendszerhez (online és helyszíni).További információ:Dynamics 365 SDK

Az alábbi példaparancs importálja a SampleCRMPackage nevű csomagot, és megadja, hogy az angol-Egyesült Államok (1033) legyen az importált nyelv.

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

Parancsmagok részletes súgója

Ha a PowerShell ablakban a Get-Help parancsmagot egy parancsmag nevével használja, megtekintheti annak részletes súgóját. Például az Import-CrmPackage parancsmag részletes súgójához:

Get-Help Import-CrmPackage -full

A parancsmagokkal kapcsolatos online súgó megtekintéséhez, lásd: CRM PowerShell referencia.

A csomagtelepítés hibáinak elhárítása a naplófájlok segítségével

A Csomagtelepítő eszköz naplózási támogatásával részletes információt kaphat az olyan hibákról, amelyek akkor lépnek fel, ha valaki az eszköz segítségével jelentkezik be a Microsoft Dynamics 365 példányba és csomagokat központilag telepít. Alapértelmezés szerint, az eszköz három naplófájlt generál, amelyek az alábbi útvonalon érhetők el az eszközt futtató számítógépen: c:\Users\<Felhasználónév\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Verziószám>. Egy másik mappa megadásához használja a - LogWriteDirectory PowerShell parancsmag paramétert.További információ:Csomagok beolvasása parancsmag használatával

• Login_ErrorLog.log: azon problémák adatait tartalmazza, amelyek akkor léptek fel, amikor az eszköz használatával jelentkezett be a Dynamics 365 példányába. Ha a bejelentkezés során hiba lép fel, egy üzenet figyelmezteti erre az eszköz bejelentkezési képernyőjén, amely egy linket is tartalmaz a naplófájlhoz. Az üzenet jelzi, hogy hiba lépett fel a bejelentkezési kérelem feldolgozása közben, és a felhasználó megtekintheti a hibanaplót. Az üzenetben található linkre kattintva nyithatja meg a naplófájlt. A naplófájl akkor jön létre, amikor először merülnek fel bejelentkezési problémák az eszközzel kapcsolatban. Ezt követően folyamatosan naplózza a bejelentkezési hibákat, bármikor is lépnek fel.

• PackageDeployer.log: A csomagok központi telepítése során az eszközben végzett feladatokról nyújt részletes információkat. Az eszköz naplófájlját a képernyő alján található Naplófájl megjelenítése linken nézheti meg.

• ComplexImportDetail.log: A legutóbbi központi telepítés során importált adatokról nyújt részletes információkat. Valahányszor csomagot telepít az eszközzel, a naplófájl már meglevő adatai átkerülnek az ugyanabban a mappában található ComplexImportDetail._old.log nevű fájlba, a ComplexImportDetail.log fájl pedig mindig a legutóbb végrehajtott importálás információit fogja tartalmazni.

Gyakorlati tanácsok a csomagok telepítéséhez

Csomagok központi telepítése során a Dynamics 365 rendszergazdáknak az alábbiakat kell kötelezően megtenniük:

• Ragaszkodni egy aláírt csomagszerelvényt biztosításához, hogy később visszakövethessék a szerelményt egészen a forrásáig.

• Előkészítő környezetben (lehetőleg az üzemi példánnyal teljesen megegyező rendszerben) tesztelni a csomagot, mielőtt üzemi szerveren futtatnák.

• A csomat telepítése előtt biztonsági másolatot készíteni az üzemi példányról.

Lásd még

MSDN: Csomagok létrehozása a CRM Package Deployer számára
A Dynamics 365 felügyelete

© 2017 Microsoft. Minden jog fenntartva. Szerzői jogi tájékoztató