Udostępnij za pośrednictwem

Wdróż pakiety korzystając z narzędzia Package Deployer Dynamics CRM i Windows PowerShell

  • Artykuł

 

Data opublikowania: luty 2017

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

Uwaga

Poniższe informacje dotyczą Dynamics 365 przed Dynamics 365 (online), wersja 9.0. Aby zapoznać się z najnowszą dokumentacją, zobacz Wdrażanie pakietów przy użyciu narzędzia Package Deployer Dynamics CRM i Windows PowerShell.

Microsoft Dynamics CRM Package Deployer umożliwia administratorom wdrażanie pakietów na wystąpieniu Dynamics 365 (wersja lokalna) lub Microsoft Dynamics 365 (online). "Pakiet" może składać się z dowolnych lub wszystkich następujących elementów:

  • Jeden lub kilka plików rozwiązań Dynamics 365.

  • Płaskie pliki lub wyeksportowane pliki z danymi z Narzędzie do konfiguracji migracji. Aby uzyskać więcej informacji o Narzędzie do konfiguracji migracji, zobacz Zarządzanie danymi konfiguracji.

  • Kod niestandardowy, który można uruchomić w trakcie lub po wdrożeniu pakietu do Microsoft Dynamics 365.

  • Zawartość HTML charakterystyczna dla pakietu, wyświetlana na początku lub na końcu procesu wdrażania pakietu. Może to być przydatne w celu podania opisu rozwiązań i plików, które są wdrażane w pakiecie.

Deweloperzy tworzą pakiety przy użyciu szablonu wdrażania pakietu w Microsoft Visual Studio.Więcej informacji:MSDN: Tworzenie pakietów dla narzędzia Package Deployer programu CRM

Po utworzeniu pakietu, można wdrożyć go uruchamiając Narzędzie do wdrażania pakietów programu CRM lub za pomocą poleceń cmdlet Windows PowerShell dla narzędzia.

Ważne

Przed zaimportowaniem i uruchomieniem pakietu w organizacji produkcyjnej, przetestuj pakiet na organizacji spoza środowiska produkcyjnego, która jest obrazem lustrzanym organizacji produkcyjnej.

Zawsze twórz kopię zapasową organizacji produkcyjnej zanim wdrożysz pakiet.

W tym temacie

Wdrażaj pakiety przy użyciu Narzędzie do wdrażania pakietów

Korzystanie z Windows PowerShell podczas wdrażania pakietów

Rozwiązywanie problemów dotyczących wdrażania pakietu za pomocą plików dziennika

Najważniejsze wskazówki dotyczące wdrażania pakietów

Wdrażaj pakiety przy użyciu Narzędzie do wdrażania pakietów

Możesz użyć Narzędzie do wdrażania pakietów (packagedeployer.exe) do wdrażania pakietów w następujący sposób.

Użyj Narzędzie do wdrażania pakietów do wdrażania pakietów

Użyj Narzędzie do wdrażania pakietów w wierszu polecenia

Użyj Narzędzie do wdrażania pakietów do wdrażania pakietów

Narzędzie do wdrażania pakietów może przetwarzać w danym momencie tylko jeden pakiet. Narzędzie to zapewnia użytkownikom możliwość wyboru pakietu do wdrożenia z wielu pakietów dostępnych w katalogu Narzędzie do wdrażania pakietów. Niektóre ekrany i akcje w narzędziu różnią się w zależności od definicji pakietu. Narzędzia Narzędzie do wdrażania pakietów nie trzeba instalować. Wystarczy je pobrać i uruchomić.

  1. Uzyskaj pakiet, który ma zostać wdrożony. Pakiet jest kolekcją plików i folderów tworzoną w folderze projektu programu Visual studio (<Projekt>\Bin\Debug) podczas budowania projektu pakietu w programie Visual Studio. Skopiuj z folderu debugowania projektu:

    • Folder <PackageName>: Ten folder zawiera rozwiązania, konfigurację importowania oraz zawartość pakietu.

    • <PackageName>.dll: Zestaw zawiera kod dla pakietu. Domyślnie, nazwa zestawu jest taka sama jak nazwa projektu Visual Studio.

    Aby uzyskać szczegółowe informacje na temat tworzenia pakietu za pomocą Visual Studio, zobacz MSDN: Tworzenie pakietu dla narzędzia Package Deployer.

    Dla tego tematu, załóżmy, że folder pakietu i zestaw z folderu debugowania projektu Visual Studio (<Project>\Bin\Debug) są kopiowane do folderu c:\DeployPackage.

  2. Pobierz Microsoft Dynamics CRM SDK. Następnie uruchom pobrany plik wykonywalny, aby wyodrębnić zawartość pakietu.

  3. Przejdź do folderu SDK\Tools\PackageDeployer i skopiuj folder pakietu i zestaw z c:\DeployPackage do folderu SDK\Tools\PackageDeployer.

  4. Po skopiowaniu plików uruchom narzędzie klikając dwukrotnie plik PackageDeployer.exe w folderze SDK\Tools\PackageDeployer.

  5. Kliknij przycisk Kontynuuj na głównym ekranie narzędzia.

  6. Na ekranie Połącz z Microsoft Dynamics 365 podaj szczegóły uwierzytelniania, aby nawiązać połączenie z serwerem Dynamics 365, na którym chcesz wdrożyć pakiet. Jeśli masz wiele organizacji i chcesz wybrać organizację, do której chcesz wdrożyć dany pakiet, wybierz pole wyboru Zawsze wyświetlaj listę dostępnych organizacji. Kliknij przycisk Logowanie.

  7. Jeśli masz wiele organizacji na serwerze Dynamics 365, wybierz organizację Dynamics 365, z którą chcesz się połączyć.

  8. Wybierz pakiet, który ma zostać wdrożony, a następnie kliknij Dalej.

    Select your package in the Package Deployer Tool

  9. Postępuj zgodnie z instrukcjami na ekranie, aby ukończyć wdrażanie pakietu.

    Ekrany są wyświetlane na podstawie definicji pakietu, który został wybrany do wdrożenia. Aby uzyskać więcej informacji na temat kompleksowego wdrażania pakietu, które używa Narzędzie do wdrażania pakietów, zobacz temat dotyczący wdrażania pakietów Unified Service Desk: Wdrażanie przykładowych aplikacji Unified Service Desk na serwer CRM przy użyciu narzędzia Package Deployer

Użyj Narzędzie do wdrażania pakietów w wierszu polecenia

Administratorzy systemu i konfiguratorzy mogą przekazać parametry, takie jak kod języka regionalnego, do packagedeployer.exe z wiersza polecenia. Te parametry można skonfigurować tylko przez uruchomienie Narzędzie do wdrażania pakietów w wierszu polecenia.

Uwaga

Ta funkcja została po raz pierwszy wprowadzona w Microsoft Dynamics CRM Online 2016, aktualizacja 0.1.

Dostępne parametry znajdują się w tej tabeli.

Parametr

Opis

Wartość domyślna

RuntimePackageSettings

Instruuje packagedeployer.exe, aby przyjmować parametry wiersza polecenia, takie jak LCID i SkipChecks.

Nie dotyczy

LCID=localeID

Określa identyfikator ustawień regionalnych, taki jak 1033 dla Angielski-Stany Zjednoczone lub 1036 dla Francuski-Francja, z identyfikatorów regionalnych dostępnych w pakiecie. Jeśli nie zostanie określony, używany będzie język domyślny.

Użyj języka domyślnego

SkipChecks=true/false

Używaj tego parametru tylko wtedy, kiedy środowisko docelowe nie zawiera innych rozwiązań ani dostosowań. Po ustawieniu wartości na true, Import rozwiązania ominie niektóre kontrole bezpieczeństwa, które mogą zwiększyć wydajność importu.

Fałsz

Poniższy przykład instruuje Narzędzie do wdrażania pakietów programu CRM, aby ominąć niektóre kontrole bezpieczeństwa i ustawia język importowania na Polski.

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

Uwaga

Używaj znaku | potoku, aby oddzielać parametry podczas uruchamiania packagedeployer.exe w wierszu polecenia z wieloma parametrami.

Aby uzyskać więcej informacji dotyczących parametrów i wartości, które mogą być przekazywane do packagedeployer.exe, zobacz MSDN: Tworzenie pakietów dla narzędzia Package Deployer CRM.

Korzystanie z Windows PowerShell podczas wdrażania pakietów

Narzędzie do wdrażania pakietów zapewnia również wsparcie Windows PowerShell dla wdrażania pakietów.

Wykonaj następujące czynności, aby użyć poleceń cmdlet PowerShell do wdrażania pakietów:

Wymagania wstępne

Zarejestruj polecenia cmdlet

Użyj polecenia cmdlet, aby pobrać pakiet

Użyj polecenia cmdlet, aby połączyć się z wystąpieniem Dynamics 365

Użyj polecenia cmdlet, aby wdrożyć pakiety

Uzyskiwanie szczegółowej pomocy na temat poleceń cmdlet

Wymagania wstępne

Poniżej przedstawiono wymagania wstępne dla korzystania z poleceń cmdlet PowerShell:

  • PowerShell w wersji 3.0 lub nowszej jest wymagany do wdrażania pakietu przy pomocy PowerShell. Aby sprawdzić wersję PowerShell uruchom okno PowerShell, a następnie uruchom następujące polecenie: $Host

  • Ustaw zasadę wykonywania, aby uruchomić podpisane skrypty PowerShell. Aby to zrobić, uruchom okno PowerShell jako administrator, a następnie uruchomi następujące polecenie: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Zarejestruj polecenia cmdlet

Należy zarejestrować polecenia cmdlet Windows PowerShell dla Narzędzie do wdrażania pakietów przed jego użyciem. Aby zarejestrować polecenia cmdlet:

  1. Jeśli jeszcze tego nie zrobiono, pobierz pakiet SDK Dynamics 365 z Centrum pobierania firmy Microsoft, i uruchom plik pakietu, aby wyodrębnić zawartość pakietu. Załóżmy, że wyodrębniłeś pakiet do folderu c:\CRM na komputerze.Narzędzie do wdrażania pakietów i inne wymagane pliki zostają udostępnione w następującej lokalizacji: c:\CRM\SDK\Tools\PackageDeployer.

  2. Uruchom Windows PowerShell na komputerze ze zwiększonymi uprawnieniami (uruchom jako administrator).

  3. Po monicie w oknie Windows PowerShell zmień katalog na folder Windows PowerShell w folderze PackageDeployer. W tym przypadku:

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

  4. Uruchom skrypt RegisterXRMTooling.ps1, aby zarejestrować zestaw Package Deployer Windows PowerShell (dll), i zainstaluj przystawkę Windows PowerShell dla Narzędzie do wdrażania pakietów. Aby to zrobić, wpisz następujące polecenie i naciśnij klawisz ENTER:

    .\RegisterXRMTooling.ps1

  5. Dodaj przystawkę Windows PowerShell dla narzędzi XRM. Zarejestrowane zostaną następujące polecenia cmdlet: Get-CrmConnection i Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Dodaj przystawkę Windows PowerShell dla narzędzia Package Deployer. Zarejestrowane zostaną następujące polecenia cmdlet: Get-CrmPackages i Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Teraz można przystąpić do korzystania z tych poleceń cmdlet Windows PowerShell. Aby wyświetlić listę zarejestrowanych poleceń cmdlet uruchom następujące polecenie po monicie w oknie Windows PowerShell:

Get-Help “Crm”

Użyj polecenia cmdlet, aby pobrać pakiet

Zanim użyjesz polecenia cmdlet upewnij się, że skopiowałeś pakiet do folderu PackageDeployer (w tym przypadku c:\CRM\SDK\Tools\PackageDeployer). Pakiet jest kolekcją plików i folderów tworzoną w folderze projektu Visual Studio (<Project>\Bin\Debug) podczas budowania projektu w Visual Studio. Skopiuj całą zawartość folderu projektu debugowania do folderu PackageDeployer. Aby uzyskać szczegółowe informacje na temat budowania pakietu za pomocą Visual Studio, zobacz MSDN: Tworzenie pakietów dla narzędzia Package Deployer programu CRM.

  1. W oknie PowerShell użyj polecenia cmdlet, aby otrzymać listę pakietów dostępnych do zaimportowania w określonym folderze (w tym przypadku c:\CRM\SDK\Tools\PackageDeployer):

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

  2. Jeśli potrzebujesz informacji o pakiecie w folderze, możesz użyć polecenia cmdlet Get-CrmPackages wraz z parametrem –PackageName, aby podać nazwę zestawu w folderze, który zawiera definicję pakietu.

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

  3. Lokalizacja zestawu pakietu może być przechowywana w zmiennej za pomocą polecenia Get-CrmPackages. Następnie może zostać ponownie użyta w poleceniu Import-CrmPackage, aby określić wartość parametru PackageDirectory. Na przykład można przechowywać informacje dla jednego lub kilku pakietów zwrócone z polecenia Get-CrmPackages w zmiennej o nazwie $MyPackages.

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

    Aby wyświetlić wszystkie pakiety.

    $MyPackages

    Aby wyświetlić tylko trzeci pakiet.

    $MyPackages[2].PackageAssemblyLocation

    Można się odwoływać do każdego pakietu w tablicy z przedziału od 0 do n. Naprzykład to polecenie importuje pierwszy pakiet znaleziony w $MyPackages.

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

    Uwaga

    Parametr PackageAssemblyLocation, możliwość wyświetlania lokalizacji folderu oraz nazwa pakietu zostały po raz pierwszy wprowadzone z Aktualizacja z grudnia 2016 dla usługi Dynamics 365 (wersje online i lokalne).Więcej informacji:Dynamics 365 SDK

Użyj polecenia cmdlet, aby połączyć się z wystąpieniem Dynamics 365

  1. Podaj poświadczenia, aby połączyć się z wystąpieniem Microsoft Dynamics 365 (online) lub Dynamics 365 (wersja lokalna). Uruchomienie tego polecenia wyświetli monit o wpisanie nazwy użytkownika i hasła, potrzebnych do połączenia z wystąpieniem Dynamics 365. Firma Microsoft będzie przechowywać je w zmiennej $Cred i używać do łączenia z serwerem Dynamics 365.

    $Cred = Get-Credential

  2. Użyj następującego polecenia, aby uzyskać połączenie z Microsoft Dynamics 365 (online) lub wystąpieniem Dynamics 365 (wersja lokalna). Firma Microsoft będzie przechowywać informacje o połączeniu w zmiennej $CRMConn:

    • Jeśli łączysz się z wystąpieniem Dynamics 365 (wersja lokalna):

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

    • Jeśli łączysz się z serwerem Microsoft Dynamics 365 (online):

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

      Uwaga

      Dla parametru DeploymentRegion prawidłowymi wartościami są NorthAmerica, EMEA, APACSouthAmerica, Oceania, JPN, i NorthAmerica2. Dla parametru OnlineType prawidłowymi wartościami są Office365 i LiveID.

  3. Podane poświadczenia są sprawdzane podczas uruchamiania polecenia w kroku 2.

Użyj polecenia cmdlet, aby wdrożyć pakiety

Następnie użyj informacji o połączeniu Dynamics 365 przechowywanych w zmiennej $CRMConn, aby wdrożyć pakiety do wystąpienia Dynamics 365. Poniższe polecenie wdraża pakiet, rozkłada pakiet w folderze c:\UnpackedFiles, i zapisuje informacje w pliku dziennika w folderze c:\MyLogFiles.

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

Uwaga

  • Parametry CrmConnection, PackageDirectory, i PackageName są obowiązkowe.

  • Zamiast ręcznie określać folder pakietu, można użyć zmiennej z parametrem PackageDirectory.Więcej informacji:Użyj polecenia cmdlet, aby pobrać pakiet

  • Dla parametru PackageName należy określić nazwę zestawu, który zawiera definicję pakietu.

  • Nie trzeba określać parametru UnpackFilesDirectory, jeśli pakiet nie rozpakowuje plików podczas wdrażania pakietu. Podczas definiowania pakietu w Visual Studio, możesz określić, czy rozpakować pliki za pomocą parametru agentdesktopzipfile w pliku ImportConfig.xml.Więcej informacji:MSDN: Tworzenie pakietów dla narzędzia Package Deployer programu CRM

  • Parametr Verbose jest opcjonalny i służy do wyświetlania szczegółowego dziennika czynności wykonywanych podczas procesu wdrażania pakietu.

  • Opcjonalny parametr RuntimePackageSettings może być stosowany wraz z poniższymi parametrami:

    • Parametr LCID=localeID określa identyfikator ustawień regionalnych, taki jak 1033 dla Angielski-Stany Zjednoczone lub 1036 dla Francuski-Francja, z identyfikatorów regionalnych dostępnych w pakiecie. Jeśli nie zostanie określony, używany będzie język domyślny.

    • Zostanie otwarte

      Parametr SkipChecks=true/false może być stosowany tylko wtedy, kiedy środowisko docelowe nie zawiera innych rozwiązań ani dostosowań. Po ustawieniu wartości na true, import rozwiązania ominie niektóre kontrole bezpieczeństwa, co może poprawić wydajność importu.

  • Folder, który określasz podczas używania parametru LogWriteDirectory musi już istnieć, a użytkownik, który uruchamia polecenie cmdlet Import-CrmPackage musi mieć uprawnienie do zapisu do folderu. Ponadto w przypadku korzystania z parametru LogWriteDirectory wymagany jest parametr -Verbose.

    Parametr LogWriteDirectory został po raz pierwszy wprowadzony z Aktualizacja z grudnia 2016 dla usługi Dynamics 365 (wersje online i lokalne).Więcej informacji:Dynamics 365 SDK

Następujące polecenie przykładowe importuje pakiet o nazwie SampleCRMPackage i określa Angielski-Stany Zjednoczone (1033) jako język importowania pakietu.

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

Uzyskiwanie szczegółowej pomocy na temat poleceń cmdlet

W oknie PowerShell, użyj polecenia cmdlet Get-Help z nazwą polecenia cmdlet, aby wyświetlić szczegółową pomoc dla tego polecenia. Na przykład, aby uzyskać szczegółową pomoc dotyczącą polecenia cmdlet Import-CrmPackage:

Get-Help Import-CrmPackage -full

Aby wyświetlić Pomoc online dla poleceń cmdlet, zobacz Odwołanie PowerShell CRM.

Rozwiązywanie problemów dotyczących wdrażania pakietu za pomocą plików dziennika

Narzędzie do wdrażania pakietów zapewnia obsługę logowania, aby uzyskać szczegółowe informacje na temat błędów występujących, gdy ktoś loguje się do wystąpienia Microsoft Dynamics 365 za pomocą narzędzia i wdraża pakiety. Domyślnie, narzędzie generuje trzy pliki dziennika, które są dostępne w następującej lokalizacji na komputerze, gdzie uruchamiane jest narzędzie: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Aby określić inny folder, użyj parametru -LogWriteDirectory polecenia PowerShell.Więcej informacji:Użyj polecenia cmdlet, aby pobrać pakiet

  • Login_ErrorLog.log: Zawiera informacje dotyczące problemów, które wystąpiły podczas używania narzędzia do logowania do wystąpienia Dynamics 365. W razie jakichkolwiek problemów podczas logowania, na ekranie logowania do narzędzia pojawi się wiadomość z łączem do tego pliku dziennika. Wiadomość ta poinformuje o wystąpieniu błędu przetwarzania żądania logowania i użytkownik będzie mógł zobaczyć dziennik błędów. Kliknięcie łącza w wiadomości umożliwi wyświetlenie tego pliku dziennika. Plik dziennika jest tworzony podczas pierwszego wystąpienia jakichkolwiek problemów podczas logowania w narzędziu. Po tej dacie plik dziennika jest używany do rejestrowania informacji o problemach podczas logowania, zawsze wtedy, gdy takie problemy wystąpią.

  • PackageDeployer.log: Zawiera szczegółowe informacje dotyczące każdego zadania wykonywanego za pomocą narzędzia podczas wdrażania pakietów. Plik dziennika z narzędzia można przeglądać klikając łącze Wyświetl plik dziennika widoczne u dołu ekranu.

  • ComplexImportDetail.log: Zawiera szczegółowe informacje dotyczące danych importowanych w ostatnim wdrożeniu za pomocą narzędzia. Każdorazowo podczas wdrażania pakietu za pomocą tego narzędzia, istniejące dane z pliku dziennika są przenoszone do pliku o nazwie ComplexImportDetail._old.log w tym samym katalogu, a plik ComplexImportDetail.log wyświetla informacje o najnowszym imporcie przeprowadzonym za pomocą tego narzędzia.

Najważniejsze wskazówki dotyczące wdrażania pakietów

Podczas wdrażania pakietów administratorzy Dynamics 365 muszą:

  • Wymagać podpisanych zestawów pakietów, aby umożliwić wyśledzenie źródła zestawu.

  • Testować pakiet na wystąpieniu przedprodukcyjnym (najlepiej lustrzanym odbiciu wystąpienia produkcyjnego) przed uruchomieniem go na serwerze produkcyjnym.

  • Wykonywać kopię zapasową wystąpienia produkcyjnego przed wdrożeniem pakietu.

Zobacz też

MSDN: Tworzenie pakietów dla narzędzia Package Deployer programu CRM
Administrowanie Dynamics 365

© 2017 Microsoft. Wszelkie prawa zastrzeżone. Prawa autorskie