Megosztás a következőn keresztül:

Csomagok telepítése a CRM csomagtelepítő és a Windows PowerShell használatával

  • Cikk

 

Közzétéve: 2016. november

Hatókör: Dynamics CRM 2015

A Microsoft Dynamics CRM Package Deployer lehetővé teszi rendszergazdák számára a csomagok központi telepítését a Microsoft Dynamics CRM (helyszíni) vagy a Microsoft Dynamics CRM 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 csomagtelepítő 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.

Jelen témakörben

Csomagok telepítése a CRM csomagtelepítő eszközzel

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 CRM csomagtelepítő eszközzel

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 olyan készlete, amelyet saját Visual Studio projektmappájában (<Projekt>\Bin\Debug) hozhat létre, amikor csomagprojektjé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 csomagtelepítő eszközzel.

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

  2. Töltse le a Microsoft Dynamics CRM SDK csomagot! 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 CRM 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 Login gombra.

  7. Ha több szervezete van a Dynamics 365 szerverén, és bejelölte Az elérhető szervezetek listájának mindenkori megjelenítése jelölőnégyzetet, akkor a következő képernyőn lehetősége nyílik kiválasztani azt a szervezetet, amelyhez csatlakozni szeretne. Válasszon egy Dynamics 365-szervezetet, amelyhez csatlakozni szeretne.

  8. A következő képernyő megkéri, hogy válassza ki a telepítendő csomagot. Jelölje meg a kívánt csomag nevét, és kattintson a Tovább gombra.

    Válassza ki a csomagját a Package Deployer eszközben

  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 csomagtelepítő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 CRM-szerveréhez 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 csomagtelepítő 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 csomagtelepítő 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 csomagtelepítő 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 könyvtár valamely csomagjával kapcsolatban, akkor a Get-CrmPackages parancsmagot és a – PackageName paraméter használatával határozhatja meg a szerelvény nevét a csomagdefiníciót tartalmazó könyvtárban.

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

Kapcsolódás CRM-szerveréhez parancsmag segítségével

  1. Adja meg a hitelesítő adatokat saját Microsoft Dynamics CRM Online vagy Microsoft Dynamics CRM (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 CRM-szervezhez való csatlakozáshoz.

    $Cred = Get-Credential

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

    • Ha a Microsoft Dynamics CRM (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 CRM 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 vagy APAC. Az OnlineType paraméter érvényes értékei: Office365 vagy 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 CRM-kapcsolati információk használatával telepítse a csomagokat a Dynamics 365 példányon. A csomag központi telepítéséhez a következő parancsot futtassa:

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

Megjegyzés

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

  • 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 csomagtelepítő 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.

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 CRM példányba és csomagokat központilag telepít. 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\PackageDeployer\<verziószám>.

  • 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 csomagtelepítő számára
A CRM 2015 felügyelete

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