Sdílet prostřednictvím

Nasazení balíčků pomocí nástroje Dynamics CRM Package Deployer a prostředí Windows PowerShell

  • Článek

 

Publikováno: únor 2017

Platí pro: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Poznámka

Informace uvedené zde platí pro verze Dynamics 365 před Dynamics 365 (online) verze 9.0. Nejnovější dokumentaci naleznete v části Nasazení balíčků pomocí nástroje Dynamics CRM Package Deployer a prostředí Windows PowerShell.

Microsoft Dynamics CRM Package Deployer umožňuje správcům nasadit balíčky na instance Dynamics 365 (místní) nebo Microsoft Dynamics 365 (online). „Balíček“ může být tvořen jakoukoli nebo všemi následujícími položkami:

  • Jeden nebo více souborů řešení aplikace Dynamics 365.

  • Ploché soubory nebo soubory exportovaných dat z nástroje Nástroj pro migraci konfigurace. Další informace o nástroji Nástroj pro migraci konfigurace naleznete v tématu Správa dat konfigurace.

  • Vlastní kód, který lze spustit během nebo po nasazení balíčku do aplikace Microsoft Dynamics 365.

  • Obsah HTML specifický pro balíček, který lze zobrazit na začátku a na konci procesu nasazení balíčku. To může být užitečné pro poskytnutí popisu řešení a souborů, které jsou nasazeny v balíčku.

Vývojáři vytváří balíčky pomocí šablony pro nasazení balíčku v aplikaci Microsoft Visual Studio.Další informace:MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer

Po vytvoření balíčku jej lze nasadit buď spuštěním nástroje Nástroj pro nasazení balíčků CRM, nebo pomocí rutin prostředí Windows PowerShell pro nástroj.

Důležité

Před importem a spuštěním balíčku ve výrobní organizaci otestujte balíček v nevýrobní organizaci, která je zrcadlovým obrazem výroby.

Před nasazením balíčku vždy zálohujte výrobní organizaci.

V tomto tématu

Nasazení balíčků pomocí Nástroj pro nasazení balíčků

Použití prostředí Windows PowerShell k nasazení balíčků

Řešení problémů s nasazením balíčků pomocí souborů protokolů

Osvědčené postupy pro nasazení balíčků

Nasazení balíčků pomocí Nástroj pro nasazení balíčků

Nástroj pro nasazení balíčků (packagedeployer.exe) lze použít k nasazení balíčků následujícími způsoby.

Použití Nástroj pro nasazení balíčků k nasazení balíčků

Použití Use Nástroj pro nasazení balíčků na příkazovém řádku

Použití Nástroj pro nasazení balíčků k nasazení balíčků

Nástroj Nástroj pro nasazení balíčků může zpracovat pouze jeden balíček najednou. Poskytuje však uživatelům možnost vybrat balíček k nasazení z několika balíčků, které jsou k dispozici v adresáři nástroje Nástroj pro nasazení balíčků. Některé obrazovky a akce v nástroji se liší v závislosti na definici balíčku. Nástroj Nástroj pro nasazení balíčků není třeba instalovat. Stačí jej stáhnout a spustit.

  1. Získejte balíček k nasazení. Balíček je kolekce souborů a složek vytvořená ve složce projektu aplikace Visual studio (<Projekt>\Bin\Debug) při sestavování projektu balíčku v aplikaci Visual Studio. Ze složky ladění projektu zkopírujte následující:

    • Složka <název balíčku>: Tato složka obsahuje řešení, konfiguraci importu a obsahu balíčku.

    • <název balíčku>.dll: Sestavení obsahuje kód vašeho balíčku. Výchozí název sestavení je stejný jako název projektu v Visual Studio.

    Podrobné informace o vytvoření balíčku pomocí aplikace Visual Studio naleznete v tématu MSDN: Vytvoření balíčku pro nástroj Package Deployer.

    K tomuto tématu předpokládejme, že složka balíčku a sestavení ze složky ladění projektu Visual Studio (<Projekt>\Bin\Debug) jsou zkopírovány do složky c:\DeployPackage.

  2. Stáhnout sadu Microsoft Dynamics CRM SDK. Spusťte stažený spustitelný soubor a extrahujte obsah balíčku.

  3. Přejděte do složky SDK\Tools\PackageDeployer a zkopírujte složku balíčku a sestavení z c:\DeployPackage do složky SDK\Tools\PackageDeployer.

  4. Po zkopírování souborů spusťte nástroj dvojitým kliknutím na soubor PackageDeployer.exe ve složce SDK\Tools\PackageDeployer.

  5. Klikněte na tlačítko Pokračovat na hlavní obrazovce nástroje.

  6. Na obrazovce Připojit k aplikaci Microsoft Dynamics 365 zadejte přihlašovací údaje pro připojení k serveru Dynamics 365, na který chcete nasadit balíček. Pokud máte více organizací a chcete vybrat organizaci, do které chcete nasadit balíček, zaškrtněte políčko Vždy zobrazit seznam dostupných organizací. Klikněte na tlačítko Přihlášení.

  7. Pokud máte na serveru aplikace Dynamics 365 více organizací, vyberte organizaci aplikace Dynamics 365, ke které se chcete připojit.

  8. Vyberte balíček, který chcete nasadit, a klikněte na tlačítko Další.

    Select your package in the Package Deployer Tool

  9. Postupujte podle pokynů na následujících obrazovkách a dokončete nasazení balíčku.

    Obrazovky se zobrazí v závislosti na definici balíčku, který jste vybrali pro nasazení. Informace o uceleném nasazení balíčku s využitím nástroje Nástroj pro nasazení balíčků naleznete v tématu pro nasazení balíčků Unified Service Desk: Nasazení ukázkových aplikací Unified Service Desk na CRM Server pomocí nástroje Package Deployer

Použití Use Nástroj pro nasazení balíčků na příkazovém řádku

Správci a úpravci systému mohou předávat parametry, jako jsou místní a jazykové kódy do nástroje packagedeployer.exe z příkazového řádku. Tyto parametry mohou být konfigurovány pouze spuštěním Nástroj pro nasazení balíčků na příkazovém řádku.

Poznámka

Tato funkce byla poprvé zavedena v aplikaci Microsoft Dynamics CRM Online 2016 – aktualizace 0.1.

V této tabulce najdete dostupné parametry.

Parametr

Popis

Výchozí hodnota

RuntimePackageSettings

Instruuje nástroj packagedeployer.exe, že má přijímat parametry příkazového řádku, například LCID a SkipChecks.

Nelze použít

LCID=localeID

Určuje ID národního prostředí, například 1033 pro americkou angličtinu nebo 1036 pro Francouzštinu, z dostupných ID národního prostředí v balíčku. Pokud není zadán, bude použit výchozí jazyk.

Použití výchozího jazyka

SkipChecks=true/false

Tento parametr lze používat pouze tehdy, když cílové prostředí neobsahuje žádná jiná řešení nebo vlastní nastavení. Pokud je parametr nastaven na hodnotu true, import řešení obejde některé bezpečnostní kontroly, což může zlepšit výkon importu.

Nepravda

Následující příklad instruuje Nástroj pro nasazení balíčků CRM, že má obejít některé bezpečnostní kontroly a nastaví jazyk, který chcete importovat, na polštinu.

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

Poznámka

Pomocí svislé čáry | lze oddělovat parametry při spuštění nástroje packagedeployer.exe na příkazovém řádku s více parametry.

Další informace o parametrech a hodnotách, které mohou být předány nástroji packagedeployer.exe, najdete v části MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer.

Použití prostředí Windows PowerShell k nasazení balíčků

Nástroj Nástroj pro nasazení balíčků také poskytuje podporu prostředí Windows PowerShell k nasazení balíčků.

Proveďte následující kroky pro použití rutin prostředí PowerShell k nasazení balíčků:

Předpoklady

Registrace rutin

Použití rutiny k získání balíčků

Použití rutiny pro připojení k instanci serveru Dynamics 365

Použití rutiny k nasazení balíčků

Získání podrobné nápovědy k rutinám

Předpoklady

Zde jsou požadavky pro použití rutin prostředí PowerShell:

  • Pro nasazení balíčku s využitím prostředí PowerShell je vyžadováno prostředí PowerShell verze 3.0 nebo vyšší. Chcete-li zkontrolovat svou verzi prostředí PowerShell, otevřete okno prostředí PowerShell a spusťte následující příkaz: $Host

  • Nastavte zásady spouštění, aby byly spuštěny podepsané skripty prostředí PowerShell. Chcete-li to provést, otevřete okno prostředí PowerShell jako správce a spusťte následující příkaz: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrace rutin

Musíte zaregistrovat rutiny prostředí Windows PowerShell pro nástroj Nástroj pro nasazení balíčků před jeho použitím. Registrace rutin:

  1. Pokud jste tak již neučinili, stáhněte balíček SDK aplikace Dynamics 365 z centra Stažení softwaru a spuštěním souboru balíčku extrahujte obsah balíčku. Předpokládejme, že jste extrahovali balíček do složky c:\CRM v počítači. Nástroj Nástroj pro nasazení balíčků a ostatní požadované soubory budou k dispozici v následujícím umístění: c:\CRM\SDK\Tools\PackageDeployer.

  2. Spusťte prostředí Windows PowerShell v počítači se zvýšenými oprávněními (jako správce).

  3. Při zobrazení výzvy v okně prostředí Windows PowerShell změňte adresář na složku prostředí Windows PowerShell ve složce PackageDeployer. V tomto případě:

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

  4. Spuštěním skriptu RegisterXRMTooling.ps1 proveďte registraci sestavení nástroje Package Deployer Windows PowerShell (soubor .dll) a nainstalujte modul snap-in prostředí Windows PowerShell pro nástroj Nástroj pro nasazení balíčků. Chcete-li to provést, zadejte následující příkaz a stiskněte klávesu ENTER:

    .\RegisterXRMTooling.ps1

  5. Přidejte modul snap-in prostředí Windows PowerShell pro nástroje XRM. Tím budou zaregistrovány následující rutiny: Get-CrmConnection a Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Přidejte modul snap-in prostředí Windows PowerShell pro nástroj Package Deployer. Tím budou zaregistrovány následující rutiny: Get-CrmPackages a Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Nyní jste připraveni používat tyto rutiny prostředí Windows PowerShell. Chcete-li zobrazit seznam rutin, které jste zaregistrovali, spusťte při zobrazení výzvy následující příkaz v okně prostředí Windows PowerShell:

Get-Help “Crm”

Použití rutiny k získání balíčků

Dříve než můžete použít rutiny, ujistěte se, že jste zkopírovali balíček do složky PackageDeployer (v tomto případě c:\CRM\SDK\Tools\PackageDeployer). Balíček je kolekce souborů a složek vytvořená ve složce projektu aplikace Visual Studio (<Projekt>\Bin\Debug) při sestavování projektu v aplikaci Visual Studio. Zkopírujte celý obsah složky ladění projektu do složky PackageDeployer. Podrobné informace o vytvoření balíčku pomocí aplikace Visual Studio naleznete v tématu MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer.

  1. V okně prostředí PowerShell použijte následující rutinu k navrácení seznamu balíčků, které jsou k dispozici pro import v zadané složce (v tomto případě c:\CRM\SDK\Tools\PackageDeployer):

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

  2. Pokud chcete informace o balíčku ve složce, můžete použít rutinu Get-CrmPackages spolu s parametrem –PackageName k zadání názvu sestavení ve složce, která obsahuje definici balíčku.

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

  3. Umístění sestavení balíčku mohou být uložena v proměnné pomocí rutiny Get-CrmPackages. Pak může být opětovně použito v rutině Import-CrmPackage k zadání hodnoty pro parametr PackageDirectory. Můžete například ukládat informace o jednom nebo více balíčcích, které jsou vráceny z rutiny Get-CrmPackages v proměnné s názvem $MyPackages.

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

    Chcete-li zobrazit všechny balíčky.

    $MyPackages

    Chcete-li zobrazit pouze třetí balíček.

    $MyPackages[2].PackageAssemblyLocation

    Potom můžete odkazovat na každý balíček v poli od 0 do n. Například tato rutina importuje první balíček nalezený v $MyPackages.

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

    Poznámka

    Parametr PackageAssemblyLocation a možnost zobrazení umístění složky a názvu balíčku byly poprvé představeny spolu s Aktualizace z prosince 2016 pro Dynamics 365 (online a místní edici).Další informace:Dynamics 365 SDK

Použití rutiny pro připojení k instanci serveru Dynamics 365

  1. Zadejte přihlašovací údaje pro připojení k aplikaci Microsoft Dynamics 365 (online) nebo instanci aplikace Dynamics 365 (místní). Po spuštění následujícího příkazu se zobrazí výzva k zadání vašeho uživatelského jména a hesla pro připojení k instanci aplikace Dynamics 365. Tyto údaje budou uloženy v proměnné $Cred a použity později pro připojení k serveru Dynamics 365.

    $Cred = Get-Credential

  2. Pomocí následujícího příkazu můžete vytvořit připojení k aplikaci Microsoft Dynamics 365 (online) nebo instanci aplikace Dynamics 365 (místní). Informace o připojení budou uloženy v proměnné $CRMConn:

    • Pokud se připojujete k instanci aplikace Dynamics 365 (místní):

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

    • Pokud se připojujete k serveru Microsoft Dynamics 365 (online):

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

      Poznámka

      Pro parametr DeploymentRegion jsou platné hodnoty NorthAmerica, EMEA, APACSouthAmerica, Oceania, JPN a NorthAmerica2. Pro parametr OnlineType jsou platné hodnoty Office365 a LiveID.

  3. Zadané přihlašovací údaje budou ověřeny při spuštění příkazu v kroku 2.

Použití rutiny k nasazení balíčků

Dále použijte informace o připojení k aplikaci Dynamics 365 uložené v proměnné $CRMConn pro nasazení balíčků do instance aplikace Dynamics 365. Následující příkaz nasadí balíček, provede rozložení balíčku ve složce c:\UnpackedFiles a zaznamená informace do souboru protokolu ve složce c:\MyLogFiles.

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

Poznámka

  • Parametry CrmConnection, PackageDirectory a PackageName jsou povinné.

  • Místo ručního určení složky balíčku můžete použít proměnnou s parametrem PackageDirectory.Další informace:Použití rutiny k získání balíčků

  • U parametru PackageName je nutné zadat název sestavení, které obsahuje definici balíčku.

  • Parametr UnpackFilesDirectory není nutné zadat v případě, že balíček během svého nasazení nerozbaluje soubory. Při definování balíčku v aplikaci Visual Studio určete, zda mají být rozbaleny soubory pomocí parametru agentdesktopzipfile v souboru ImportConfig.xml.Další informace:MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer

  • Parametr Verbose je nepovinný a slouží k zobrazení podrobného protokolu činností prováděných během procesu nasazení balíčku.

  • Nepovinný parametr RuntimePackageSettings lze použít společně s následující parametry:

    • Parametr LCID=localeID určuje ID národního prostředí, například 1033 pro americkou angličtinu nebo 1036 pro Francouzštinu, z dostupných ID národního prostředí v balíčku. Pokud není zadán, bude použit výchozí jazyk.

    • &#160;

      Parametr SkipChecks=true/false lze používat pouze tehdy, když cílové prostředí neobsahuje žádná jiná řešení nebo vlastní nastavení. Pokud je parametr nastaven na hodnotu true, import řešení obejde některé bezpečnostní kontroly, což může zlepšit výkon importu.

  • Složka, kterou zadáte při použití parametru LogWriteDirectory, musí již existovat a uživatel, který spouští rutinu Import-CrmPackage, musí mít oprávnění k zápisu do složky. Navíc je vyžadován parametr Verbose při použití parametru LogWriteDirectory.

    Parametr LogWriteDirectory byl poprvé představen v systému Aktualizace z prosince 2016 pro Dynamics 365 (online a místní edici).Další informace:Dynamics 365 SDK

Příkaz v následujícím příkladu importuje balíček s názvem SampleCRMPackage a jako jazyk importu balíčku určuje americkou angličtinu (1033).

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

Získání podrobné nápovědy k rutinám

V okně prostředí PowerShell použijte rutinu Get-Help s názvem rutiny k zobrazení podrobné nápovědy pro rutinu. Chcete-li například získat podrobnou nápovědu pro rutinu Import-CrmPackage:

Get-Help Import-CrmPackage -full

Online nápovědy pro rutiny naleznete v tématu CRM PowerShell odkaz.

Řešení problémů s nasazením balíčků pomocí souborů protokolů

Nástroj Nástroj pro nasazení balíčků poskytuje podporu protokolování a umožňuje získat podrobné informace o chybách, které se mohou vyskytnout, pokud se někdo přihlásí k instanci aplikace Microsoft Dynamics 365 pomocí nástroje a provádí nasazení balíčků. Nástroj ve výchozím nastavení generuje tři soubory protokolu, které jsou k dispozici v následujícím umístění v počítači, kde jste spustili nástroj: c:\Users\<uživatelské_jméno>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<verze>. Chcete-li zadat jinou složku, použijte parametr rutiny -LogWriteDirectory PowerShell.Další informace:Použití rutiny k získání balíčků

  • Login_ErrorLog.log: Poskytuje informace o problémech, k nimž došlo při použití nástroje pro přihlášení k instanci aplikace Dynamics 365. Pokud se vyskytnou nějaké problémy při přihlášení, zobrazí se zpráva na přihlašovací obrazovce nástroje s odkazem na tento soubor protokolu. Zpráva uvádí, že došlo k chybě při zpracování žádosti o přihlášení a uživatel může zobrazit protokol chyb. Kliknutím na odkaz v této zprávě můžete zobrazit soubor protokolu. Soubor protokolu je vytvořen, když v nástroji poprvé narazíte na jakýkoli problém s přihlášením. Poté se soubor protokolu používá k protokolování informací o problému s přihlášením vždy, když k němu dojde.

  • PackageDeployer.log: Poskytuje podrobné informace o jednotlivých úkolech provedených v nástroji během nasazování balíčků. Soubor protokolu můžete zobrazit z nástroje kliknutím na odkaz Zobrazit soubor protokolu v dolní části obrazovky.

  • ComplexImportDetail.log: Poskytuje podrobné informace o datech importovaných v posledním nasazení pomocí nástroje. Pokaždé, když pomocí tohoto nástroje nasadíte balíček, existující podrobnosti ze souboru protokolu jsou přesunuty do souboru s názvem ComplexImportDetail._old.log ve stejném adresáři a soubor ComplexImportDetail.log zobrazí informace o posledním importu provedeném pomocí nástroje.

Osvědčené postupy pro nasazení balíčků

Při nasazování balíčků musí správci aplikace Dynamics 365:

  • Trvat na sestavení podepsaného balíčku tak, aby mohli sledovat sestavení zpět k jeho zdroji.

  • Otestovat balíček na předprodukční instanci (nejlépe zrcadlový obraz produkční instance) před jeho spuštěním na produkčním serveru.

  • Zálohovat produkční instanci před nasazením balíčku.

Viz také

MSDN: Vytvoření balíčků pro nástroj CRM Package Deployer
Správa aplikace Dynamics 365

© 2017 Microsoft. Všechna práva vyhrazena. Autorská práva