פריסת חבילות באמצעות Package Deployer ו- Windows PowerShell
Microsoft Dynamics CRM Package Deployer מאפשר למנהלי מערכת לפרוס חבילות בסביבת Microsoft Dataverse.
הערה
Package Deployer פועל גם עם ארגוני Dynamics 365 Customer Engagement (on-premises).
"חבילה" יכולה להיות מורכבת מפעולה אחת או מכל הפעולות הבאות:
קובצי פתרון, אחד או יותר, של Dataverse.
קבצים שטוחים או נתונים המיוצאים מהכלי Configuration Migration. לקבלת מידע נוסף אודות הכלי Configuration Migration, ראה ניהול נתוני תצורה.
קוד מותאם אישית שניתן להפעיל במהלך או אחרי פריסת החבילה בסביבת Dataverse.
תוכן HTML ספציפי לחבילה שיכול להציג בהתחלה ובסוף תהליך הפריסה של החבילה. הדבר יכול להיות שימושי כדי לספק תיאור של פתרונות וקבצים הנפרסים בחבילה.
מפתחים יוצרים חבילות באמצעות תבנית של פריסת חבילות ב- Visual Studio. מידע נוסף: יצירת חבילות עבור Package Deployer
לאחר יצירת חבילה, באפשרותך לפרוס אותה על-ידי הפעלת CRM Package Deployer או על-ידי שימוש בכלי cmdlet Windows PowerShell של הכלי.
חשוב
לפני ייבוא והפעלת חבילה בארגון ייצור, בדוק את החבילה בארגון שאינו למטרות ייצור שהוא תמונת ראי של ארגון הייצור.
תמיד גבה את ארגון הייצור לפני פריסת חבילה.
פריסת חבילות באמצעות הכלי Package Deployer
באפשרותך להשתמש ב- Package Deployer (packagedeployer.exe) כדי לפרוס חבילות בדרכים הבאות.
השתמש ב- CRM Package Deployer כדי לפרוס חבילות
השתמש ב- CRM Package Deployer בסרגל הפקודות
השתמש בכלי Package Deployer כדי לפרוס חבילות
הכלי Package Deployer יכול לפרוס רק חבילה אחת בכל פעם. עם זאת, הוא מספק למשתמשים יכולת לבחור חבילה לפריסה מתוך חבילות מרובות שזמינות בספריה של הכלי Package Deployer. חלק מהמסכים והפעולות בכלי הם שונים, בהתבסס על הגדרת החבילה. אינך צריך להתקין את הכלי Package Deployer. רק להוריד ולהפעיל אותו.
השג את החבילה לפריסה. חבילה היא אוסף של קבצים ותיקיות אשר נוצר בתיקיית פרוייקט של Visual Studio (<Project> \Bin\Debug) כאשר אתה בונה את הפרוייקט שלך ב- Visual Studio. העתק את הטקסט הבא מהתיקיה של איתור באגים בפרויקט:
התיקיה <PackageName>: תיקיה זו מכילה את הפתרונות, תצורת הייבוא והתוכן עבור החבילה.
<PackageName>.dll: ההרכבה מכילה את הקוד עבור החבילה. כברירת מחדל, שם ההרכבה זהה לשם פרויקט ה- Visual Studio שלך.
לקבלת מידע מפורט אודות יצירת חבילה באמצעות Visual Studio, ראה יצירת חבילה עבור הכלי Package Deployer.
עבור נושא זה, נניח שתיקיית החבילה וההרכבה מתוך תיקיית איתור הבאגים של פרוייקט Visual Studio (<Project> \Bin\Debug) מועתקים לתיקיה
c:\DeployPackage.
השג את הכלי Package Deployer. הכלי Package Deployer זמין כחבילת NuGet. כדי להשתמש ב- Package Deployer, עליך להוריד ולחלץ אותו במחשב המקומי שלך באמצעות nuget.exe.
הורד את nuget.exe מתוך https://www.nuget.org/downloads, ושמור אותו במחשב שלך, נניח ב- d:\. לאחר מכן הפעל את הפקודה הבאה בשורת הפקודה כדי לחלץ את תוכן החבילה לתיקיה, נניח PD, במחשב שלך:d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
לאחר שחילצת את הכלי Package Deployer, עבור אל התיקיה[ExtractedLocation]\toolsכדי למצוא את הקובץ PackageDeployer.exe.העתק את תיקיית החבילה וההרכבה מהתיקיה
c:\DeployPackageלתיקיה[ExtractedLocation]\tools.לאחר שהקבצים הועתקו, הפעל את הכלי על-ידי לחיצה כפולה על הקובץ
PackageDeployer.exeבתיקיה[ExtractedLocation]\tools.לחץ על המשך במסך הראשי של הכלי.
במסך התחבר אל Microsoft Dynamics 365 for Customer Engagement, ספק פרטי אימות כדי להתחבר אל שרת Dynamics 365 שלך שבו ברצונך לפרוס את החבילה. אם יש לך ארגונים מרובים, וברצונך לבחור את הארגון שבו תבוצע פריסת החבילה, בחר בתיבת הסימון הצג תמיד רשימת ארגונים זמינים. לחץ על כניסה.
אם יש לך ארגונים מרובים בשרת Dynamics 365, בחר ארגון של יישומי Dynamics 365 להתחברות.
בחר את החבילה לפריסה ולאחר מכן לחץ על הבא.

בצע את ההוראות במסכים הבאים כדי להשלים את פריסת החבילה שלך.
המסכים מופיעים בהתבסס על הגדרת החבילה שבחרת עבור פריסה. לפריסת החבילה מקצה-לקצה שמשתמשת בכלי Package Deployer, עיין בנושא של פריסת החבילות של Unified Service Desk: פריסת יישומים לדוגמה של Unified Service Desk בשרת CRM באמצעות Package Deployer
השתמש בכלי Package Deployer בסרגל הפקודות
מנהלי מערכת ומבצעי התאמה אישית יכולים להעביר פרמטרים, כגון קוד השפה והאזור, ל- packagedeployer.exe מתוך שורת הפקודה. ניתן להגדיר פרמטרים אלה רק על-ידי הפעלת הכלי Package Deployer בסרגל הפקודות.
הערה
תכונה זו הוצגה לראשונה ב- Dynamics CRM Online 2016 Update 0.1.
פרמטרים זמינים מוצגים בטבלה זו.
| פרמטר | תיאור | ערך ברירת מחדל |
|---|---|---|
| RuntimePackageSettings | מורה ל- packagedeployer.exe לקבל פרמטרים של שורת פקודה כגון LCID ו- SkipChecks. | לא ישים |
| LCID=localeID | מציין את מזהה האזור, כגון 1033 עבור אנגלית - ארצות הברית או 1036 עבור צרפתית-צרפת, מתוך מזהי אזור זמינים בחבילה. אם לא תצוין, ייעשה שימוש בשפת ברירת המחדל. | שימוש בשפת ברירת המחדל |
| SkipChecks=true/false | השתמש בפרמטר זה רק כאשר סביבת היעד אינה מכילה פתרונות או התאמות אישיות אחרים כלשהם. כאשר מוגדר כ- true, ייבוא פתרון יעקוף בדיקות בטיחות מסוימות, מה שיכול לשפר את ביצועי הייבוא. | לא נכון |
הדוגמה הבאה מורה ל- CRM Package Deployer לעקוף בדיקות בטיחות מסוימות ומגדירה לייבא את השפה כפולנית.
packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"
הערה
השתמש בתו הערוץ | להפרדה בין פרמטרים בעת הפעלת packagedeployer.exe בשורת הפקודה עם פרמטרים מרובים.
לקבלת מידע נוסף אודות פרמטרים וערכים שניתן להעביר ל- packagedeployer.exe, ראה יצירת חבילות עבור CRM Package Deployer.
השתמש ב- Windows PowerShell כדי לפרוס חבילות
הכלי Package Deployer מספק גם תמיכה של Windows PowerShell כדי לפרוס חבילות.
בצע את השלבים הבאים כדי להשתמש ב- cmdlets של PowerShell כדי לפרוס חבילות:
התקן את מודול PowerShell של Package Deployer
שימוש ב- cmdlet כדי להתחבר אל Dynamics 365 Server
לקבלת עזרה מפורטת אודות כלי cmdlet
דרישות מוקדמות
להלן התנאים המוקדמים לשימוש ב-cmdlets של PowerShell:
PowerShell 3.0 או גירסה מתקדמת יותר נדרש כדי לפרוס חבילה באמצעות PowerShell. כדי לבדוק מהי גירסת PowerShell שברשותך, הפעל חלון PowerShell ולאחר מכן הפעל את הפקודה הבאה:
$Hostהגדר את מדיניות הביצוע כדי להפעיל את קבצי ה-script החתומים של PowerShell. כדי לעשות זאת, הפעל חלון PowerShell בתור מנהל ולאחר מכן הפעל את הפקודה הבאה:
Set-ExecutionPolicy -ExecutionPolicy AllSigned
התקן את מודול PowerShell של Package Deployer
עליך להתקין את מודול Windows PowerShell עבור הכלי Package Deployer לפני שתוכל להשתמש בו. כדי להתקין:
הפעל את Windows PowerShell במחשב שלך עם הרשאות מוגברות (הפעל כמנהל).
בהנחיה בחלון Windows PowerShell, הזן את הפקודה הבאה להתקנת המודול:
Install-Module Microsoft.Xrm.Tooling.PackageDeployment.Powershell
כעת אתה מוכן להשתמש ברכיבי ה- cmdlet של Windows PowerShell. כדי לפרט את כלי ה-cmdlet שרשמת, הפעל את הפקודה הבאה בסרגל הפקודות שבחלון Windows PowerShell:
Get-Help “Crm”
השתמש ב-cmdlet לאחזור חבילות
לפני שתוכל להשתמש ב-cmdlet, ודא שהעתקת את החבילה שלך לתיקיה PackageDeployer (במקרה זה, [ExtractedLocation]\tools). חבילה היא אוסף של קבצים ותיקיות אשר נוצר בתיקיית פרוייקט של Visual Studio (<Project> \Bin\Debug) כאשר אתה בונה את הפרוייקט שלך ב- Visual Studio. העתק את התוכן המלא של תיקיית איתור הבאגים של הפרוייקט לתיקיה PackageDeployer. לקבלת מידע מפורט על בניית חבילה באמצעות Visual Studio, ראה יצירת חבילה עבור CRM Package Deployer.
בחלון PowerShell, השתמש ב- cmdlet הבאים כדי להחזיר רשימה של חבילות שזמינות לייבוא בתיקיה שצוינה (במקרה זה, c:\CRM\SDK\Tools\PackageDeployer):
Get-CrmPackages –PackageDirectory [ExtractedLocation]\toolsאם ברצונך לקבל מידע אודות חבילה בתיקייה, באפשרותך להשתמש ב-cmdlet של Get-CrmPackages יחד עם הפרמטר –PackageName כדי לציין את שם ההרכבה בתיקייה המכילה את הגדרת החבילה.
Get-CrmPackages –PackageDirectory [ExtractedLocation]\tools –PackageName SampleCRMPackage.dllניתן לאחסן את מיקום ההרכבה של החבילה במשתנה באמצעות cmdlet Get-CrmPackages. לאחר מכן ניתן לעשות בו שימוש חוזר ב- Import-CrmPackage cmdlet כדי לציין ערך עבור הפרמטר PackageDirectory. לדוגמה, באפשרותך לאחסן את המידע של חבילה אחת או יותר שהוחזרו מ- Get-CrmPackages cmdlet במשתנה שנקרא $MyPackages.
$MyPackages = Get-CrmPackages –PackageDirectory [ExtractedLocation]\toolsכדי להציג את כל החבילות.
$MyPackagesכדי להציג רק את החבילה השלישית.
$MyPackages[2].PackageAssemblyLocationלאחר מכן, באפשרותך ליצור הפניה לכל חבילה בטווח בין 0 עד n. לדוגמה, cmdlet זה מייבא את החבילה הראשונה שנמצאה ב- $MyPackages.
Import-CrmPackage -CrmConnection $CRMConn -PackageDirectory $MyPackages[0].PackageAssemblyLocation
שימוש ב-cmdlet כדי להתחבר למופע Dynamics 365 for Customer Engagement
ספק את האישורים שלך כדי להתחבר אל יישומי Dynamics 365 או אל מופע של יישומי Dynamics 365 for Customer Engagement (on-premises). הפעלת הפקודה הבאה תנחה אותך להקליד את שם המשתמש והסיסמה כדי להתחבר למופע Dynamics 365 ואנו נאחסן אותו במשתנה
$Cred, ונשתמש בו מאוחר יותר לצורך התחברות ל- Dynamics 365 Server שלך.$Cred = Get-Credentialהשתמש בפקודה הבאה כדי להתחבר אל יישומי Dynamics 365 או אל מופע של יישומי Dynamics 365 for Customer Engagement (on-premises). אנו נאחסן את נתוני החיבורים במשתנה
$CRMConn:אם אתה מתחבר אל יישומי Dynamics 365 for Customer Engagement (on-premises).
$CRMConn = Get-CrmConnection -ServerUrl https://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Credאם אתה מתחבר לשרת Dynamics 365:
$CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Credהערה
עבור הפרמטר
DeploymentRegion, הערכים החוקיים הםNorthAmerica,EMEA, APACSouthAmerica,Oceania,JPN, ו-NorthAmerica2. עבור הפרמטרOnlineTypeהערכים החוקיים הםOffice365ו-LiveID.
האישורים שסופקו מאומתים כאשר אתה מפעיל את הפקודה בשלב 2.
השתמש ב-cmdlet לפריסת חבילות
לאחר מכן, השתמש בנתוני החיבור של יישומי Dynamics 365 המאוחסנים במשתנה $CRMConn כדי לפרוס חבילות למופע Dynamics 365. הפקודה הבאה פורסת חבילה, מפרקת את החבילה בתיקייה c:\UnpackedFiles ומתעדת מידע בקובץ יומן בתיקייה c:\MyLogFiles.
Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -LogWriteDirectory C:\MyLogFiles -Verbose
הערה
הפרמטרים
CrmConnection,PackageDirectory, ו-PackageNameמוגדרים כחובה.במקום לציין באופן ידני את תיקיית החבילה, באפשרותך להשתמש במשתנה עם הפרמטר PackageDirectory. מידע נוסף: שימוש ב-cmdlet לאחזור חבילות
עבור הפרמטר
PackageName, עליך לציין את שם ההרכבה המכילה את הגדרת החבילה.אין צורך לציין את הפרמטר
UnpackFilesDirectoryאם החבילה שלך לא פותחת קבצים במהלך פריסת החבילה. בעת הגדרת חבילה ב Visual Studio, ציין אם לחלץ קבצים באמצעות פרמטר agentdesktopzipfile בקובץ ImportConfig.xml. מידע נוסף:יצירת חבילות עבור CRM Package Deployerהפרמטר
Verboseהוא אופציונלי, ומשמש כדי להציג יומן רישום מפורט של פעילויות המבוצעות במהלך תהליך הפריסה של החבילה.ניתן להשתמש בפרמטר האופציונלי
RuntimePackageSettingsיחד עם הפרמטרים הבאים:- הפרמטר
LCID=localeIDמציין את מזהה האזור, כגון 1033 עבור אנגלית - ארצות הברית או 1036 עבור צרפתית-צרפת, מתוך מזהי אזור זמינים בחבילה. אם לא תצוין, ייעשה שימוש בשפת ברירת המחדל. - יש להשתמש בפרמטר
SkipChecks=true/falseרק כאשר סביבת היעד אינה מכילה פתרונות או התאמות אישיות אחרים כלשהם. כאשר מוגדר כ- true, ייבוא פתרון יעקוף בדיקות בטיחות מסוימות, מה שיכול לשפר את הביצועים.
- הפרמטר
התיקייה שאתה מציין בעת שימוש בפרמטר
LogWriteDirectoryצריכה כבר להיות קיימת, ולמשתמש שמפעיל את Import-CrmPackage cmdlet צריכה להיות הרשאת כתיבה בתיקייה. בנוסף, פרמטר -Verbose נדרש בעת שימוש בפרמטר LogWriteDirectory.הפרמטר LogWriteDirectory הוצג לראשונה ב- Dynamics 365 (online), גירסה 9.0. מידע נוסף: המדריך למפתחים של יישומי Dynamics 365 for Customer Engagement
הפקודה בדוגמה הבאה מייבאת חבילה הקרויה SampleCRMPackage ומציינת אנגלית - ארצות הברית (1033) כשפה לייבוא חבילה.
Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles –RuntimePackageSettings LCID=1033
לקבלת עזרה מפורטת אודות כלי cmdlet
בחלון PowerShell השתמש ב-cmdlet Get-Help עם שם cmdlet כדי להציג עזרה מפורטת עבור ה- cmdlet. לדוגמה, כדי לקבל עזרה מפורטת עבור ה-cmdlet Import-CrmPackage:
Get-Help Import-CrmPackage -full
כדי להציג את העזרה המקוונת עבור רכיבי ה- cmdlet, ראה הפניה ל- PowerShell ביישומי Dynamics 365 for Customer Engagement.
פתרון בעיות בנושא פריסת חבילות על-ידי שימוש בקבצי יומן רישום
הכלי Package Deployer מספק תמיכה ברישום כדי לקבל מידע מפורט אודות שגיאות המתרחשות כאשר מישהו נכנס למופע של Microsoft Dynamics 365 for Customer Engagement באמצעות הכלי ופריסה של חבילות. כברירת מחדל, הכלי יוצר שלושה קבצי יומן רישום שזמינים במיקום הבא במחשב שבו אתה מפעיל את הכלי: c:\Users\<UserName> \AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. כדי לציין תיקייה אחרת, השתמש בפרמטר -LogWriteDirectory PowerShell cmdlet. מידע נוסף: שימוש ב-cmdlet לאחזור חבילות
Login_ErrorLog.log: מספק מידע אודות הבעיות שהתרחשו בזמן השימוש בכלי כדי להיכנס למופע Dynamics 365. אם קיימות בעיות במהלך הכניסה למערכת, מופיעה הודעה במסך הכניסה של הכלי עם קישור לקובץ יומן רישום זה. ההודעה מציינת כי אירעה שגיאה בעת עיבוד בקשת הכניסה והמשתמש יכול להציג את יומן רישום השגיאות. באפשרותך ללחוץ על הקישור בהודעה כדי להציג קובץ יומן רישום זה. קובץ יומן הרישום נוצר בפעם הראשונה שבה שאתה נתקל בבעיות כניסה בכלי. מכאן ואילך, קובץ יומן הרישום משמש כדי לתעד מידע על בעיה בכניסה, בכל פעם שהיא מתרחשת.PackageDeployer.log: Providesמספק מידע מפורט אודות כל משימה המבוצעת בכלי במהלך פריסת החבילות. באפשרותך להציג את קובץ יומן הרישום מהכלי על-ידי לחיצה על הקישור הצג קובץ יומן רישום שבתחתית המסך.ComplexImportDetail.log: מספק מידע מפורט על הנתונים שיובאו בפריסה האחרונה באמצעות הכלי. בכל פעם שאתה פורס חבילה באמצעות כלי זה, הפרטים הקיימים מקובץ יומן הרישום יועברו אל קובץ הנקרא ComplexImportDetail._old.log באותה ספריה, והקובץ ComplexImportDetail.log יציג מידע על משימת הייבוא האחרונה שנעשתה באמצעות הכלי.
שיטות עבודה מומלצות לפריסת חבילות
בעת פריסת חבילות, מנהלי Dynamics 365 חייבים:
להתעקש על הרכבה של חבילה חתומה כך שהם יוכלו לעקוב אחר ההרכבה חזרה למקור שלו.
לבדוק את החבילה במופע קדם-ייצור (רצוי תמונת ראי של מופע הייצור) לפני הפעלתה בשרת הייצור.
לגבות את מופע הייצור לפני פריסת החבילה.