Jaa

Pakettien käyttöönotto Dynamics CRM Package Deployerin ja Windows PowerShellin avulla

  • Artikkeli

 

Julkaistu: helmikuu 2017

Koskee seuraavaa: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Huomautus

Nämä tiedoista ovat Dynamics 365n versioille ennen Dynamics 365 (online) -versiota 9.0. Uusin dokumentaatio on kohdassa Pakettien käyttöönotto Dynamics CRM Package Deployer- ja Windows PowerShell -sovelluksen avulla.

Kun Microsoft Dynamics CRM Package Deployer on käytössä, järjestelmänvalvojat voivat ottaa käyttöön paketteja Dynamics 365 (paikallinen)- tai Microsoft Dynamics 365 (online) -ilmentymissä. "Paketti" voi sisältää minkä tahansa tai kaikki seuraavista toimista:

  • Yhden tai useamman Dynamics 365 ratkaisutiedoston.

  • Vakiotiedostoja tai vietyjä datatiedostoja kohteesta Määrityksen siirtotyökalu. Lisätietoja sovelluksesta Määrityksen siirtotyökalu, on kohteessa Määritystietojen hallinta.

  • Mukautettua koodia, joka voidaan suorittaa paketin käyttöönoton aikana tai sen jälkeen Microsoft Dynamics 365.

  • HTML-sisältö, joka sisältyy tiettyyn pakettiin ja joka voidaan näyttää paketin käyttöönoton alussa ja lopussa. Tämä voi olla hyödyllistä, jotta saadaan tarjottua kuvaus ratkaisuista ja tiedostoista, jotka on otettu käyttöön paketissa.

Kehittäjät voivat luoda paketteja käyttämällä paketin käyttöönottomallia sovelluksessa Microsoft Visual Studio.Lisätietoja:MSDN: Pakettien luominen CRM Package Deployer -työkalulla

Kun paketti on luotu, voit ottaa sen joko suorittamalla CRM:n paketin käyttöönottotyökalu tai käyttämälläWindows PowerShell-työkalua cmdlet-komennot.

Tärkeä

Ennen kuin tuot ja suoritat paketin tuotanto-organisaatiossa, testaa paketti tuotanto-organisaation ei-tuotannollisessa peilikuvassa.

Tee aina tuotanto-organisaation varmuuskopio ennen paketin käyttöönottoa.

Tämän ohjeaiheen sisältö

Paketin käyttöönotto Paketin käyttöönottotyökalun avulla

Asenna paketteja Windows PowerShellin avulla

Vianhakupaketin käyttöönotto-ongelmien vianmääritys lokitiedostojen avulla

Pakettien käyttöönoton parhaat käytännöt

Paketin käyttöönotto Paketin käyttöönottotyökalun avulla

Voit ottaa paketit käyttöön Paketin käyttöönottotyökalu -työkalulla (packagedeployer.exe) seuraavilla tavoilla.

Ota paketit käyttöön Paketin käyttöönottotyökalun avulla

Käytä Paketin käyttöönottotyökalua komentorivillä

Ota paketit käyttöön Paketin käyttöönottotyökalun avulla

Tämä Paketin käyttöönottotyökalu työkalu voi käsitellä kerrallaan vain yhden paketin. Kuitenkin se tarjoaa käyttäjille mahdollisuuden valita käyttöön otettavan paketin monista käytettävissä olevista paketeista Paketin käyttöönottotyökalu -kansiossa. Jotkin näytöt ja toiminnot työkalussa eroavat paketin kuvauksen perusteella. Sinun ei tarvitse asentaa Paketin käyttöönottotyökalu -työkalua. Voit vain ladata ja suorittaa sen.

  1. Hanki paketti käyttöön otettavaksi. Paketti on kokoelma tiedostoja ja kansioita, jotka on luotu Visual studio -projektin kansioon (<Projekti >\Bin\Debug\Bin\Debug), kun rakennat paketoidun projektin Visual Studiossa. Kopioi seuraava projektin debug-kansiosta:

    • <PackageName>-kansio: Tämä paketti sisältää ratkaisut, tuontimäärityksen ja paketin sisällön.

    • <PackageName>.dll: Kokoonpano sisältää paketin koodin. Kokoonpanon nimi on oletusarvon mukaan sama kuin Visual Studio projektin nimi.

    Lisätietoja paketin rakentamisesta käyttämällä työkalua Visual Studio, katso MSDN: Pakettien luominen CRM Package Deployer -työkalulla.

    Tässä aiheessa oletetaan, että pakettikansio ja kokoonpano Visual Studio -projektin debug-kansiosta (<Projekti>\Bin\Debug) kopioidaan c:\DeployPackage -kansioon.

  2. Lataa Microsoft Dynamics CRM SDK. Pura sitten paketin sisältö suorittamalla ladattu suoritettava tiedosto.

  3. Siirry SDK\Tools\PackageDeployer-kansioon ja kopio pakettikansio ja kokoonpano c:\DeployPackage-kansiosta SDK\Tools\PackageDeployer-kansioon.

  4. Kun tiedostot on kopioitu, suorita työkalu kaksoisnapsauttamalla PackageDeployer.exe-tiedostoa SDK\Tools\PackageDeployer-kansiossa.

  5. Valitse Jatka työkalun pääikkunassa.

  6. Ilmoita Muodosta yhteys Microsoft Dynamics 365 -sovellukseen -näytössä todennustiedot ja muodosta yhteys Dynamics 365-palvelimeen, johon haluat asentaa paketin. Jos CRM-palvelimella on useita organisaatioita ja haluat valita organisaation, jolle paketti otetaan käyttöön, valitse Näytä aina käytettävissä olevien organisaatioiden luettelo -valintaruutu. Valitse Kirjaudu.

  7. Jo Dynamics 365-palvelimessa on useita organisaatioita, valitse Dynamics 365-organisaatio, johon haluat muodostaa yhteyden.

  8. Valitse käyttöönotettava paketti ja valitse sitten Seuraava.

    Select your package in the Package Deployer Tool

  9. Noudata seuraavien näyttöjen ohjeita paketin käyttöönoton viimeistelemiseksi.

    Näytöt tulevat näkyviin käyttöönottoa varten valitsemasi paketin perusteella. Lisätietoja kokonaisvaltaisesta, Paketin käyttöönottotyökalua käyttävästä paketin käyttöönotosta on Unified Service Desk -pakettien käsittelevässä ohjeaiheessa: Unified Service Desk -mallisovellusten käyttöönotto CRM-palvelimella Package Deployerin avulla

Käytä Paketin käyttöönottotyökalua komentorivillä

Järjestelmänvalvojat ja mukauttajat voivat siirtää parametreja, kuten alueellisen kielikoodin packagedeployer.exe -tiedostoon komentoriviltä. Nämä parametrit voidaan määrittää vain suorittamalla Paketin käyttöönottotyökalu komentorivillä.

Huomautus

Tämä ominaisuus otettiin ensimmäiseksi käyttöön Microsoft Dynamics CRM Online 2016 -päivitys 0.1ssa.

Käytettävät parametrit ovat tässä taulukossa.

Parametri

Kuvaus

Oletusarvo

RuntimePackageSettings

Määrittää packagedeployer.exe -tiedoston hyväksymään komentoriviparametrit kuten LCID ja SkipChecks.

Ei käytettävissä

LCID=localeID

Määrittää aluekohtaisten asetusten tunnusten arvot, kuten 1033, jos kyseessä on englanti – Yhdysvallat tai 1036 ranska – Ranska paketin käytettävissä olevista aluekohtaisen asetusten tunnusten arvosta. Jos tätä ei määritetä, käytetään oletuskieltä.

Käytä oletuskieltä

SkipChecks=true/false

Tätä parametria pitää käyttää vain, kun kohdeympäristö ei sisällä muita ratkaisuja tai mukautuksia. Kun arvo on tosi, ratkaisun tuominen ohittaa joitakin turvallisuustarkistuksia, jotka voivat nopeuttaa tuontia.

Väärin

Seuraava esimerkki ohjaa CRM:n paketin käyttöönottotyökalu -ohjelmaa, joka ohittaa joitain turvallisuustarkistuksia ja määrittää tuotavaksi kieleksi puolan.

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

Huomautus

Erota pystyviivalla | komentorivin useita parametreja suoritettaessa packagedeployer.exe -ohjelma komentorivillä, jolla on useita parametreja.

Saat lisätietoja parametreista ja arvoista, jotka voidaan siirtää packagedeployer.exe -tiedostoon kohdasta MSDN:Pakettien luominen CRM Package Deployer -tyäkalulla.

Asenna paketteja Windows PowerShellin avulla

Myös Paketin käyttöönottotyökalu tarjoaa Windows PowerShell tukea pakettien käyttöönottoa varten.

Suorittamalla seuraavat vaiheet voit käyttää PowerShell cmdlet-komentoja pakettien käyttöönottoa varten:

Edellytykset

Rekisteröi Cmdlet-komentoja

Käytä cmdlet-komentoa hakeaksesi paketit

Ota yhteys Dynamics 365 -ilmentymään cmdlet-komennolla

Käytä cmdlet-komentoa ottaaksesi paketit käyttöön

Cmdlet-komentojen yksityiskohtaisia ohjeita

Edellytykset

Tässä ovat edellytykset PowerShell cmdlet-komentojen käyttöön:

  • PowerShell 3.0 tai uudempi versio tarvitaan paketin käyttöönottoon käyttämällä työkalua PowerShell. Voit tarkistaa oman PowerShell versiosi suorittamalla PowerShell -ikkunan ja suorittamalla seuraavan komennon:$Host

  • Määritä toimeksiantojen toteuttamiskäytännöt suorittaaksesi allekirjoitetut PowerShell komentosarjat. Voit tehdä sen suorittamalla PowerShell-ikkunan järjestelmänvalvojana ja suorittamalla sitten seuraavan komennon: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Rekisteröi Cmdlet-komentoja

Sinun on rekisteröitävä Windows PowerShell cmdlet-komennot Paketin käyttöönottotyökalu ennen kuin niitä voi käyttää. Rekisteröidäksesi Cmdlet-komennot:

  1. Jos et ole jo tehnyt niin, Lataa Dynamics 365-SDK-paketti kohteesta Microsoft Download Center, ja suorita paketti purkaaksesi paketin sisällön. Oletetaan, että olet purkanut paketin tietokoneesi c:\CRM-kansioon.Paketin käyttöönottotyökalu ja muut tarvittavat tiedostot ovat käytettävissä seuraavassa sijainnissa: c:\CRM\SDK\Tools\PackageDeployer.

  2. Aloita Windows PowerShell tietokoneella laajennetuilla oikeuksilla (Suorita järjestelmänvalvojana).

  3. Muuta Windows PowerShell -kehotteessa hakemisto Windows PowerShell-kansioksi. Tämä kansio sijaitsee PackageDeployer -kansiossa. Tässä tapauksessa:

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

  4. Suorita RegisterXRMTooling.ps1-komentosarja, jolla Package Deployer Windows PowerShell -kokoonpano (dll) rekisteröidään, ja asennaPaketin käyttöönottotyökalun Windows PowerShell-lisäosa. Voit tehdä tämän kirjoittamalla seuraavan komennon ja painamalla ENTER:

    .\RegisterXRMTooling.ps1

  5. Lisää Windows PowerShell laajennus XRM-työvälineille. Tämä rekisteröi seuraavat cmdlet-komennot: Get-CrmConnection ja Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Lisää Windows PowerShell laajennus Package Deployer -työvälineille. Tämä rekisteröi seuraavat cmdlet-komennot: Get-CrmPackages ja Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Olet nyt valmis käyttämään näitä Windows PowerShell cmdlet-komentoja. Saadaksesi luettelon Cmdlet-komennoista, jotka on rekisteröity, suorita seuraava komento komentoriville Windows PowerShell -ikkunassa:

Get-Help “Crm”

Käytä cmdlet-komentoa hakeaksesi paketit

Ennen kuin voit käyttää-cmdlet-komentoa, varmista, että olet kopioinut paketin PackageDeployer-kansioon (Tässä tapauksessa c:\CRM\SDK\Tools\PackageDeployer). Paketti on kokoelma tiedostoja ja kansioita, jotka on luotu Visual Studio projektikansioon (<Project>\Bin\Debug), kun teet projektin Visual Studiolla. Kopioi projektin korjauskansion koko sisältö projektin PackageDeployer -kansioon. Lisätietoja paketin luomisesta Visual Studiossa on artikkelissa MSDN: Pakettien luominen CRM Package Deployer -työkalulla.

  1. PowerShell-ikkunassa käytä seuraavia cmdlet-komentoja palauttaaksesi luettelon pakkauksista, jotka voi tuoda määritetystä kansiosta (Tässä tapauksessa c:\CRM\SDK\Tools\PackageDeployer):

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

  2. Jos haluat lisätietoja kansion paketista, voit määrittää Get-CrmPackages cmdlet-komennon yhdessä – PackageName-parametrin kanssa määrittääksesi kokoonpanon nimen pakkauksessa, joka sisältää paketin määritelmän.

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

  3. paketin kokoonpanon sijainti voidaan tallentaa muuttujaan Hae-CrmPackages cmdlet:n avulla. Sitten se voidaan käyttää uudelleen Import-CrmPackage cmdlet:ssä PackageDirectory-parametrin määrittämiseksi. Voi esimerkiksi tallentaa yhden tai usean Get-CrmPackages cmdlet:sta palautetun paketin muuttujaan, jonka nimi on $MyPackages.

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

    Jos haluat näyttää kaikki paketit.

    $MyPackages

    Jos haluat näyttää vain kolmannen paketin.

    $MyPackages[2].PackageAssemblyLocation

    Tällöin voit viitata kuhunkin matriisin pakkaukseen 0:sta n:ään. Esimerkiksi tämä cmdlet tuo ensimmäisen $MyPackagesista löytyvän paketin.

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

    Huomautus

    PackageAssemblyLocation-parametri ja mahdollisuus näyttää kansion sijainti ja pakkauksen nimi oli ominaisuutena ensimmäistä kertaa versiossa Dynamics 365:n joulukuun 2016 päivitys (verkko ja paikallinen).Lisätietoja:Dynamics 365 SDK

Ota yhteys Dynamics 365 -ilmentymään cmdlet-komennolla

  1. Anna tunnistetietosi muodostaaksesi yhteyden omaan Microsoft Dynamics 365 (online) tai Dynamics 365 (paikallinen) laitokseesi. Seuraavan komennon suorittaminen pyytää sinua kirjoittamaan käyttäjänimen ja salasanan muodostaaksesi yhteyden Dynamics 365 esiintymään, ja tallennamme sen $Cred-muuttujaan ja käytämme sitä myöhemmin, jotta voit ottaa yhteyden Dynamics 365 Server -palvelimeen.

    $Cred = Get-Credential

  2. Seuraavalla komennolla saat yhteyden omaan Microsoft Dynamics 365 (online) tai Dynamics 365 (paikallinen) esiintymään. Voimme tallentaa yhteyden tiedot $CRMConn -muuttujaan:

    • Jos olet muodostamassa yhteyttä Dynamics 365 (paikallinen) -esiintymään:

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

    • Jos olet muodostamassa yhteyttä Microsoft Dynamics 365 (online) -palvelimeen:

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

      Huomautus

      DeploymentRegion-parametrin kelvolliset arvot ovat NorthAmerica, EMEA, APACSouthAmerica, Oceania, JPN ja NorthAmerica2.OnlineType-parametrin kelvolliset arvot ovat Office365 ja LiveID.

  3. Kun suoritat komennon vaiheessa 2, vahvistetaan annettuja tunnistetietoja.

Käytä cmdlet-komentoa ottaaksesi paketit käyttöön

Käytä seuraavaksi Dynamics 365-yhteystietoja, jotka on tallennettu $CRMConn-muuttujaan ottamaan pakkaukset käyttöön Dynamics 365-esiintymään. Seuraava komento ottaa käytön paketin, purkaa paketin c:\UnpackedFiles-kansioon kirjaa tiedot lokitiedostoon c:\MyLogFiles-kansioon.

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

Huomautus

  • CrmConnection- PackageDirectory ja PackageName parametrit ovat pakollisia.

  • Sen sijaan, että sen pakettikansio määritetään manuaalisesti, voit käyttää muuttujaa PackageDirectory-parametrin kanssa.Lisätietoja:Käytä cmdlet-komentoa hakeaksesi paketit

  • PackageName -parametria varten on määritettävä nimi kokoonpanolle, joka sisältää paketin määrityksen.

  • Sinun ei tarvitse määrittää UnpackFilesDirectory-parametria, jos pakettisi ei pura tiedostoja paketin käyttöönoton aikana. Kun määrität paketin sovelluksessa Visual Studio, määrität, puretaanko tiedostot käyttämällä agentdesktopzipfile-parametria ImportConfig.xml-tiedostossa.Lisätietoja:MSDN: Pakettien luominen CRM Package Deployer -työkalulla

  • Verbose-parametri on valinnainen, ja sitä käytetään esittämään yksityiskohtainen loki paketti käyttöönottoprosessin aikana suoritetuista toimista.

  • Valinnaista RuntimePackageSettings -parametria voidaan käyttää seuraavien parametrien kanssa:

    • LCID=localeID-parametri määrittää aluekohtaisten asetusten tunnusten arvon, kuten 1033, jos kyseessä on englanti – Yhdysvallat tai 1036 ranska – Ranska, paketin käytettävissä olevista aluekohtaisen asetusten tunnusten arvosta. Jos tätä ei määritetä, käytetään oletuskieltä.

    • &#8209;toimintoa

      SkipChecks=true/false -parametria pitää käyttää vain, kun kohdeympäristö ei sisällä muita ratkaisuja tai mukautuksia. Kun arvo on tosi, ratkaisun tuominen ohittaa joitakin turvallisuustarkistuksia, jotka voivat nopeuttaa tuontia.

  • Kansion, joka määritetään käytettäessä LogWriteDirectory-parametria, on oltava jo olemassa, ja Import-CrmPackage cmdlet -toimintoa suorittavalla käyttäjällä on oltava kirjoitusoikeus kansioon. Lisäksi Verbose-parametri on pakollinen, jos LogWriteDirectory-parametria käytetään.

    LogWriteDirectory-parametri oli käytössä ensimmäistä kertaa Dynamics 365:n joulukuun 2016 päivitys (verkko ja paikallinen):n yhteydessä.Lisätietoja:Dynamics 365 SDK

Seuraava esimerkkikomento tuo paketin, jonka nimi on SampleCRMPackage ja määrittää paketin tuotavaksi kieleksi englanti – Yhdysvallat (1033).

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

Cmdlet-komentojen yksityiskohtaisia ohjeita

PowerShell -ikkunassa käytä Get-Help cmdlet-komentoa cdlet-nimellä tarkastellaksesi yksityiskohtaisia ohjeita cmdlet-komennolle. Esimerkiksi saadaksesi yksityiskohtaisia ohjeita Import-CrmPackage cmdlet-komentoa varten:

Get-Help Import-CrmPackage -full

Lisätietoja cmdlet-komentojen online-ohjeesta on artikkelissa CRM PowerShell -tietolähteet.

Vianhakupaketin käyttöönotto-ongelmien vianmääritys lokitiedostojen avulla

Paketin käyttöönottotyökalulla saa tarkkoja tietoja virheistä, joita on tapahtunut kirjauduttaessa Microsoft Dynamics 365 -esiintymään käyttämällä työkalu- ja käyttöönottopaketteja. Oletusarvoisesti työkalulla luodaan kolme lokitiedostoa, joiden sijainti työkalua käyttävässä tietokoneessa on: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Voit määrittää eri kansion käyttämällä - LogWriteDirectory PowerShell cmdlet -parametriä.Lisätietoja:Käytä cmdlet-komentoa hakeaksesi paketit

  • Login_ErrorLog.log: sisältää tietoja ongelmista, joita tapahtui kirjauduttaessa työkalulla Dynamics 365 -ilmentymään. Jos kirjautumisessa on ongelmia, työkalun kirjautumisikkunaan avautuu sanoma, jossa on linkki tähän kirjautumistiedostoon. Sanoman mukaan kirjautumispyynnön käsittelyn aikana tapahtui virhe, ja käyttäjä voi katsella virhelokia. Voit tarkastella tätä lokitiedostoa viestin linkkiä napsauttamalla. Lokitiedosto luodaan, kun työkalussa ilmenee ensimmäisen kerran ongelmia kirjautumisen aikana. Lokitiedostoa käytetään tämän jälkeen merkitsemään kirjautumisen aikaisia virheitä aina, kun sellaista tapahtuu.

  • PackageDeployer.log: sisältää tarkkoja tietoja kustakin työkalulla pakettien käyttöönoton aikana tehdyistä tehtävistä. Voit tarkastella työkalun lokitiedostoa napsauttamalla Näytä lokitiedosto -linkkiä näytön alareunassa.

  • ComplexImportDetail.log: sisältää tarkkoja tietoja edellisessä käyttöönotossa työkalulla tuoduista tiedoista. Aina kun otat paketin käyttöön työkalulla, lokitiedostossa olevat tiedot siirretään samassa kansiossa olevaan ComplexImportDetail._old.log-tiedostoon. ComplexImportDetail.log-tiedosto sisältää työkalulla viimeksi tehdyn tuontityön tiedot.

Pakettien käyttöönoton parhaat käytännöt

Pakettien käyttöönoton aikana Dynamics 365 järjestelmänvalvojien pitää:

  • Varmistaa paketin kokoonpanon allekirjoitus niin, että he voivat seurata kokoonpanoa takaisin sen lähteeseen.

  • Testata pakettia esituotannon esiintymässä (mieluiten tuotannon esiintymän peilikuvassa) ennen sen suorittamista tuotantopalvelimella.

  • Varmuuskopioida tuotannon esiintymä ennen paketin käyttöönottoa.

Katso myös

MSDN: Pakettien luominen CRM Package Deployer -työkalulla
Dynamics 365:n hallinta

© 2017 Microsoft. Kaikki oikeudet pidätetään. Tekijänoikeudet