Jaa

Asenna paketteja CRM Package Deployer- ja Windows PowerShell -työvälineiden avulla

  • Artikkeli

 

Julkaistu: marraskuu 2016

Koskee seuraavaa: Dynamics CRM 2015

Kun Microsoft Dynamics CRM Package Deployer on käytössä, järjestelmänvalvojat voivat ottaa käyttöön paketteja Microsoft Dynamics CRM (paikallinen)- tai Microsoft Dynamics CRM 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ässä ohjeaiheessa

Pakettien käyttöönotto CRM Package Deployer -työ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

Pakettien käyttöönotto CRM Package Deployer -työ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), kun rakennat paketin 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 (<Project>\Bin\Debug) kopioidaan c:\DeployPackage -kansioon.

  2. Lataa Microsoft Dynamics CRM SDK -paketti. 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 CRM -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. Jos Dynamics 365 palvelimellasi on useita organisaatioita ja valitsit Näytä aina käytettävissä olevien organisaatioiden luettelo -valintaruudun, seuraavassa näytössä voit valita organisaation, johon otat yhteyden. Valitse Dynamics 365-organisaatio, johon otat yhteyden.

  8. Seuraavassa näytössä sinua pyydetään valitsemaan paketti käyttöön otettavaksi. Valitse pakettisi nimi ja napsauta Seuraava.

    Valitse paketti Package Deployer -työkalussa

  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: Yhtenäisen tukipalvelun mallisovellusten ottaminen käyttöön CRM Serverissä paketin käyttöönottotyö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 CRM-palvelimeen 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 paketin käyttöönottotyökalun 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 työvälineellä Visual Studio. 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ä – PaketinNimi-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

Ota yhteys CRM-palvelimeen cmdlet-komennolla

  1. Anna tunnistetietosi muodostaaksesi yhteyden omaan Microsoft Dynamics CRM Online tai Microsoft Dynamics CRM (paikallinen) laitokseesi. Seuraavan komennon suoritttaminen 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 CRM-palvelimeen.

    $Cred = Get-Credential

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

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

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

    • Jos olet muodostamassa yhteyttä Microsoft Dynamics CRM Online -palvelimeen:

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

      Huomautus

      DeploymentRegion-parametrin kelvolliset arvot ovat NorthAmerica, EMEA ja APAC.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

Seuraavaksi käytä CRM-yhteystietoja, jotka on tallennettu $CRMConn-muuttujaan ottamaan pakkaukset Dynamics 365-esiintymään. Suorita seuraava komento asentaaksesi paketin:

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

Huomautus

  • CrmConnection- PackageDirectory ja PackageName parametrit ovat pakollisia.

  • 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.

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 CRM -esiintymään käyttämällä työkalu- ja käyttöönottopaketteja. Työkalulla luodaan kolme lokitiedostoa, joiden sijainti työkalua käyttävässä tietokoneessa on: c:\Users\<UserName>\AppData\Roaming\Microsoft\PackageDeployer\<versio>.

  • 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
CRM 2015 -järjestelmän hallinta

© 2016 Microsoft Corporation. Kaikki oikeudet pidätetään. Tekijänoikeudet