העברת נתונים באמצעות שורת הפקודה

Google Workspace Migration for Microsoft Exchange

בנוסף לשימוש ב-Google Workspace Migration for Microsoft Exchange‏ (GWMME) במחשב Windows, אפשר להריץ את GWMME באמצעות ממשק שורת הפקודה.

לפני שמתחילים

פותחים את שורת הפקודה ומזינים cd ואחריו את המיקום של התקנת GWMME במירכאות כפולות, לדוגמה, cd "C:\Program Files\Google\Google Workspace Migration".

מיקומי ברירת המחדל הם:

  • C:\Program Files\Google\Google Workspace Migration (32-bit system)
  • C:\Program Files (x86)\Google\Google Workspace Migration (מערכת 64 ביט)

יכול להיות שתתבקשו להזין את שם המשתמש והסיסמה של מנהל ה-Exchange.

הפקודות הנדרשות להעברה

צריך להזין את הפקודות בשורה רציפה אחת. כל מעבר שורה שמופיע כאן הוא רק לצורך קריאות.

העברה מ-Exchange

דוגמה 1: העברה באמצעות פרופיל אדמין

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

דוגמה 2: העברה באמצעות פרטי השרת והאדמין

ExchangeMigration.exe
--nouse_gui
--source_server="exchange-server hostname"
--exchange_admin_login="Exchange server admin account"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

מידע נוסף על העברת נתונים מ-Exchange זמין במאמר העברת נתונים מ-Exchange.

העברה מחשבון Google או משרת IMAP

ExchangeMigration.exe
--nouse_gui
--enable_imap
--filename="filename containing user list"
--service_account_json_path="json file path"
--imap_security="security number"
--imap_port="port number"
--imap_path_prefix="path prefix"
--imap_server_type="server type"
--source_server="IMAP server hostname"
--google_admin="admin email address"
--google_domain="Google domain name"

להעברות במצב אדמין מ-Cyrus, צריך להשתמש גם ב:

--imap_admin_id="Cyrus IMAP admin"
--imap_admin_password="Cyrus admin password"

מידע נוסף על העברת נתוני אימייל מחשבונות Google או מחשבונות מבוססי IMAP זמין במאמר העברת אימייל מחשבונות Google או מ-IMAP.

העברה מקובצי PST

דוגמה 1: העברת הודעות ל-Gmail

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"

דוגמה 2: העברת הודעות ל-Google Vault

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"
--migrate_to_vault

למידע נוסף על העברת קובצי PST, אפשר לעבור אל העברת נתונים מקובצי PST.

העברה מתיקיות ציבוריות

דוגמה 1: שימוש במצב מיפוי להעברת תיקיות ציבוריות (מומלץ). במצב הזה, המערכת משתמשת בקובץ מיפוי כדי למפות את התיקייה הציבורית לקבוצה ב'קבוצות'. מכיוון שכתובות אימייל קבוצתיות לרוב לא תואמות לשמות של תיקיות ציבוריות, רוב הארגונים משתמשים במצב מיפוי.

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--public_folder_mapping_file="path to mapping file"
--enable_public_folder_migration

דוגמה 2: שימוש במצב ברירת המחדל להעברת תיקיות ציבוריות. במצב הזה, לא צריך קובץ מיפוי. במקום זאת, GWMME משווה בין שמות התיקיות והקבוצות. המיפוי מתבצע כששם התיקייה הציבורית זהה לשם הקבוצה. לדוגמה, TPS reports/tps-reports ממופה לקבוצה tps-reports@solarmora.com.

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--enable_public_folder_migration

מידע נוסף על העברת תיקיות ציבוריות זמין במאמר העברה מתיקיות ציבוריות.

כל הארגומנטים של GWMME

מזינים ארגומנט בשורה אחת, ומקדימים לו שני מקפים (‎--‎). חלק מהארגומנטים דורשים פרמטרים נוספים. מזינים את הפרמטרים אחרי סימן שווה (=) ובתוך מרכאות כפולות.

A—E

ארגומנט ותיאור פרמטר

--calendar_migration_end_date

מציינים את תאריך הסיום של אירועי היומן שרוצים להעביר. אירועים שמתרחשים אחרי התאריך הזה לא מועברים.

דוגמה: ‎--calendar_migration_end_date="2020-01-01"‎

 תאריך בפורמט YYYY-MM-DD

--calendar_migration_start_date

מציינים את תאריך ההתחלה של אירועי היומן שרוצים להעביר. אירועים ביומן מלפני התאריך הזה לא מועברים.

דוגמה: ‎--calendar_migration_start_date="2018-01-01"‎

 תאריך בפורמט YYYY-MM-DD

--custom_label_prefix

מציינים את הקידומת שתצורף לכל התוויות ב-Gmail.

דוגמה: ‎--custom_label_prefix="migrated-"‎

 קידומת מותאמת אישית שמצורפת לתוויות

--email_migration_end_date

מציין את תאריך הסיום של הודעות האימייל שרוצים להעביר. הודעות שנשלחו אחרי התאריך הזה לא יועברו

דוגמה: ‎--email_migration_end_date="2020-01-01"‎

תאריך בפורמט YYYY-MM-DD

--email_migration_start_date

מציינים את תאריך ההתחלה של הודעות האימייל שרוצים להעביר. הודעות מלפני התאריך הזה לא מועברות.

דוגמה: ‎--email_migration_start_date="2018-01-01"‎

 תאריך בפורמט YYYY-MM-DD

--enable_calendar_fanout

מאפשר fan-out של אירועים ביומן להעברת יומן.

 לא נדרש פרמטר

--enable_hidden_folders_migration

הפעלה של העברת תיקיות MAPI (Exchange או PST) מוסתרות.

 לא נדרש פרמטר

--enable_imap

מאפשרת העברה משרת IMAP ולא משרת Exchange.

 לא נדרש פרמטר

--enable_mbox_logging

הפעלה של רישום ביומן של mbox. הודעות שלא ניתן להעביר בגלל מגבלות על גודל או סוג הקובץ ב-Gmail נכתבות לקובץ mbox ספציפי למשתמש. קובץ ה-mbox נמצא בנתיב התיקייה של רישום המעקב של GWMME (לדוגמה, ‎%localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox).

פרטים נוספים על ההגבלות על הודעות ב-Gmail מופיעים במאמר סוגי הקבצים שנחסמים ב-Gmail.

 לא נדרש פרמטר

--enable_public_folder_migration

מאפשרת העברה של GWMME מתיקיות ציבוריות של Exchange אל קבוצות Google. פרטים נוספים זמינים במאמר העברת תיקיות ציבוריות.

הערה: אי אפשר להפעיל העברה של משתמשים ותיקיות ציבוריות בו-זמנית.

 לא נדרש פרמטר

--enable_resource_migration

מאפשר העברה של משאבים ביומן.

 לא נדרש פרמטר

--exchange_admin_login

מציינים את שם הכניסה לחשבון האדמין של שרת Exchange. משתמשים בארגומנט הזה בשילוב עם ‎--source_server.

אם משתמשים בארגומנט הזה, לא משתמשים ב-‎--exchange_profile_name.

דוגמה: ‎--exchange_admin_login="administrator"‎

 שם הכניסה לחשבון האדמין של שרת Exchange

--exchange_profile_name

מציינים את השם של פרופיל Outlook שרוצים להשתמש בו כדי להתחבר לשרת Exchange. מציינים פרופיל אדמין באותו מחשב שבו מופעל GWMME. אם משתמשים בארגומנט הזה, אסור להשתמש בארגומנטים הבאים:

  • ‎--source_server
  • ‎--pst_base_folder
  • ‎--exchange_admin_login

דוגמה: ‎--exchange_profile_name="exch_migration_admin"‎

 השם של פרופיל Outlook קיים

--exclude_message_classes

הודעות מוחרגות על סמך סיווג ההודעה.

הארגומנט הזה שימושי כשרוצים להחריג הודעות עם stub מפתרון ארכיון. הכלי GWMME לא תומך בהעברה חוזרת של הודעות שלא הוסרו מהן קבצים מצורפים. הגישה המומלצת היא להחריג הודעות עם stub, ואז, אחרי שההודעות עם stub יחזרו למצב מלא, להעביר את ההודעות בהרצה שנייה של GWMME.

דוגמה: ‎--exclude_message_classes="ipm.note.eas,ipm.note.1"‎

 רשימה של מחלקות שמוחרגות, מופרדות בפסיקים (ללא רווחים בין פריטי הרשימה)

--exclude_top_level_folders

הכלי לא כולל תיקיות ברמה העליונה על סמך שם התיקייה.

דוגמה: ‎--exclude_top_level_folders="Deleted Items,Drafts"

 רשימה של תיקיות ברמה העליונה, מופרדות בפסיקים (ללא רווחים בין הפריטים ברשימה)

F—M

ארגומנט ותיאור פרמטר

--filename

כולל את הנתונים ששייכים לשמות המשתמשים שצוינו בקובץ ה-CSV. אם משתמשים בארגומנט הזה, לא משתמשים בארגומנט ‎--migration_usernames.

דוגמה: ‎--filename="C:\Documents and Settings\users.csv"‎

 הנתיב לקובץ ה-CSV של שמות המשתמשים

--force_clear_google_calendar_ids_on_remigration

מנקה את המזהים של היומנים המשניים לפני שמבצעים העברה חוזרת של נתונים. כשמבצעים העברה חוזרת של נתוני יומן, GWMME יוצר יומנים משניים חדשים עם מזהים ייחודיים. כך נמנעות התנגשויות בין אירועים.

הערה: כדאי להשתמש בארגומנט הזה לפני שמבצעים העברה חוזרת של נתונים. פרטים נוספים זמינים במאמר בנושא העברה חוזרת של תוכן.

 לא נדרש פרמטר

--force_restart

ההעברה מופעלת מחדש על כל הפריטים, ולא רק על פריטים שלא הועברו בהצלחה.

כברירת מחדל, אם ההעברה נקטעה, ההעברה הבאה מתחילה בנקודה שבה ההעברה הקודמת נעצרה. אפשר להשתמש בפרמטר הזה כדי להפעיל את ההעברה מחדש מההתחלה. אם משתמשים באפשרות הזו, הודעות אימייל כפולות מסוננות, אירועים ביומן שהועברו בעבר מתעלמים מהם (אבל יכול להיות שהם ישוכפלו במקרים מסוימים), ואנשי קשר שהועברו בעבר משוכפלים.

 לא נדרש פרמטר

--google_admin

מגדיר את הבעלים של אירוע במשאבים ביומן. אם לאירוע אין בעלים, GWMME מגדיר את האדמין שצוין כבעלים של האירוע. למשתמש צריכה להיות גישה מלאה ליומנים של המשאבים.

לדוגמה: ‎--google_admin="admin@example.com"

 כתובת האימייל של הבעלים המיועד של האירוע ביומנים של משאבים

--google_domain

מציינים את דומיין Google Workspace שאליו מעבירים את הנתונים.

דוגמה: ‎--google_domain="example.com"

 דומיין Google Workspace

--help

הצגת רשימה של הארגומנטים של ExchangeMigration.exe.

 לא נדרש פרמטר

--id_mapping_file

מציינים את השם של הקובץ שמכיל את רשימת המיפוי המלאה. משתמשים בקובץ מיפוי CSV שמכיל מיפוי של כתובות משתמשים וכתובות של יומנים. לפרטים נוספים, אפשר לעבור אל יצירת קובצי CSV להעברה.

דוגמאות: ‎--id_mapping_file="resources.csv"‎

 שם הקובץ

--imap_admin_id

מציינת את מנהל מערכת Cyrus IMAP שיש לו גישה לכל חשבונות ה-IMAP בשרת. משתמשים בה עם ‎--imap_admin_password.

דוגמה: ‎--imap_admin_id="admin@example.com"‎

 כתובת האימייל של האדמין ב-Cyrus

--imap_admin_password

מציינת את הסיסמה של מנהל מערכת Cyrus IMAP. משתמשים בה עם ‎--imap_admin_id.

דוגמה: ‎--imap_admin_password="password"‎

 סיסמת האדמין של Cyrus

--imap_path_prefix

מציינת את קידומת הנתיב לתיקיות משתמשים בשרת IMAP.

מזינים את קידומת הנתיב של תיקיות IMAP שמשותפת לכל התיקיות. קידומת הנתיב היא בדרך כלל מרחב השמות של IMAP לשמות התיקיות. לדוגמה, אם רשימת תיקיות ה-IMAP של משתמש היא INBOX,‏ INBOX.Sent ו-INBOX.Drafts, אז INBOX היא קידומת הנתיב. ערכים אופייניים של קידומת נתיב הם INBOX עבור Cyrus ו-Courier, או ללא ערך (השדה נשאר ריק) עבור GroupWise IMAP, ‏ Gmail ו-Dovecot.

דוגמה: ‎--imap_path_prefix="INBOX"

 קידומת הנתיב לתיקיות משתמשים

--imap_port

מציינת את מספר היציאה של שרת ה-IMAP.

דוגמה: ‎--imap_port="143"‎

 מספר יציאה

--imap_security

מציינים את אפשרות האבטחה שבה רוצים להשתמש. משתמשים באחד מהקודים הבאים:

  • ‫0 (ללא אבטחה)
  • ‫1 (SSL)
  • ‫2 (STARTTLS)

דוגמה: ‎--imap_security="1"‎

 קוד בן ספרה אחת

--imap_server_type

מציינים את סוג שרת ה-IMAP שממנו מתבצעת ההעברה. סוגי השרתים הם Exchange,‏ GroupWise,‏ Gmail,‏ Cyrus,‏ Courier,‏ Dovecot,‏ Zimbra וסוגים שלא נתמכים. ברירת המחדל היא סוגים שלא נתמכים.

הערה: אם מציינים סוג שרת שגוי, יכול להיות שהביצועים של ההעברה יושפעו.

דוגמה: ‎--imap_server_type="Gmail"

 סוג שרת IMAP

--migrate_to_vault

העברת אימייל ל-Google Vault. ההודעות מועלות לחשבון של המשתמש ומסומנות כמחוקות. התוויות לא נוצרות בתיבת הדואר הנכנס של המשתמש.

שימו לב להגבלות הבאות:

  • כללי השמירה ב-Google Vault קובעים כמה זמן ההודעה תישמר ב-Vault.
  • אם אתם מבצעים העברה ל-Vault, אתם צריכים להפעיל את Gmail במסוף Admin. אם Gmail מושבת, יוצגו שגיאות 403.
  • ההעברה למשתמשים עם רישיון Vault Former Employee (VFE) תיכשל כי Gmail לא מופעל אצל המשתמשים האלה.
 לא נדרש פרמטר

--migration_usernames

מציין את רשימת המשתמשים להעברה. אם משתמשים בארגומנט הזה, לא משתמשים ב-‎--filename.

דוגמה: ‎--migration_usernames="user1,user2,user3"‎

 רשימה מופרדת בפסיקים של משתמשים (ללא רווחים בין הפריטים)

נ עד צ

ארגומנט ותיאור פרמטר

--noenable_calendar_migration

מפעיל את ההעברה מבלי לכלול נתוני יומן.

 לא נדרש פרמטר

--noenable_contact_migration

מפעיל את ההעברה מבלי לכלול נתונים של אנשי קשר.

 לא נדרש פרמטר

--noenable_email_migration

מפעיל את ההעברה מבלי לכלול נתוני אימייל.

 לא נדרש פרמטר

--noenable_error_reports

מונעת מהכלי GWMME ליצור דוחות העברה שמציגים שגיאות בהודעות שמתרחשות במהלך ההעברה. דילוג על דוחות ההעברה יכול לשפר את ביצועי ההעברה.

מידע נוסף על דוחות העברה מופיע בקטע 'בדיקת דוחות העברה' במדריך לאדמין GWMME.

 לא נדרש פרמטר

--noenable_id_mapping

מריץ את ההעברה בלי לדרוש קובץ מיפוי. כל נתוני המיפוי מוגדרים ברשימת המשתמשים אם משתמשים בארגומנט ‎--id_mapping_file.

 לא נדרש פרמטר

--noenable_label_prefix

מציין שלא יתווסף קידומת לתוויות כשמעבירים קבצים מ-PST. כברירת מחדל, השם של קובץ ה-PST מתווסף כקידומת לתוויות וללוחות שנה שנוצרו במהלך ההעברה.

 לא נדרש פרמטר

--nouse_gui

מריצים את GWMME באמצעות שורת הפקודה. מצב ממשק המשתמש הגרפי (GUI) הוא ברירת המחדל.

 לא נדרש פרמטר

--nowait

סוגר את GWMME בלי שתצטרכו להקיש על המקש Enter כשמריצים את ההעברה משורת הפקודה.

 לא נדרש פרמטר

--num_threads

מציינים את מספר המשתמשים שרוצים להעביר בו-זמנית. לכל משתמש נפתח שרשור נפרד. ברירת המחדל היא 25 שרשורים.

דוגמה: ‎--num_threads="20"‎

 מספר המשתמשים

--pst_base_folder

מציינת את הספרייה שמכילה את קובצי ה-PST להעברה. GWMME מעביר את כל קובצי ה-PST בתיקיות המשנה של התיקייה שצוינה.

אם משתמשים בארגומנט הזה, אסור להשתמש בארגומנטים הבאים:

  • ‎--source_server
  • ‎--exchange_profile_name

דוגמה: ‎--pst_base_folder="C:\pst"‎

 הספרייה שמכילה קובצי PST

--public_folder_mapping_file

מציינים את שם קובץ המיפוי. קובץ המיפוי ממפה נתיבים של תיקיות ציבוריות ב-Exchange לכתובות אימייל של קבוצות ב-Google. פרטים נוספים זמינים במאמר העברת תיקיות ציבוריות.

דוגמה: ‎--public_folder_mapping_file="public_folder_mapping.csv"

 שם קובץ המיפוי בפורמט CSV

--retry_count

מציינת את מספר הניסיונות החוזרים אם מתרחש כשל זמני, כמו פסק זמן של שרת עמוס. ברירת המחדל היא 10.

דוגמה: ‎--retry_count="5"‎

 מספר הניסיונות החוזרים

--run_diagnostics

מריץ את האבחון המקיף לפני ההעברה, שמאמת את הקישוריות לשרת, את האימות, את הגישה לחשבונות ואת כל רשימת המשתמשים.

 לא נדרש פרמטר

--service_account_json_path

מציינים את הנתיב לקובץ פרטי הכניסה של חשבון השירות. הוראות להשגת הקובץ הזה מופיעות במאמר בנושא מתן הרשאה ל-GWMME בחשבון.

דוגמה: ‎--service_account_json_path ="C:\Users\admin\privatekey.json"‎

 הנתיב לקובץ פרטי הכניסה של חשבון השירות

--source_server

מציינים את כתובת ה-IP או את שם הדומיין המלא של שרת ה-Exchange או IMAP.

במיגרציות של Exchange, משתמשים בארגומנט הזה בשילוב עם ‎--exchange_admin_login. אם משתמשים בארגומנט הזה, לא משתמשים בארגומנט ‎--exchange_profile_name.

דוגמה: ‎--source_server="mailserver.example.com"‎

 כתובת ה-IP או שם דומיין שמוגדר במלואו של השרת

--strip_user_labels

קובע שההודעות יועברו ללא תוויות.

 לא נדרש פרמטר

--translate_conflicting_events

מורה ל-GWMME לבדוק אירועים קיימים שכבר הועברו ליומן Google ולשנות את האירועים על ידי תרגום כתובת האימייל של משאב Exchange לכתובת האימייל של משאב Google Workspace התואם.

הרבה אדמינים בוחרים להעביר קודם את המשתמשים ואחר כך את משאבי היומן. אם אתם בוחרים להעביר את משאבי היומן בשלב השני, אתם צריכים להגדיר את GWMME כך שיעביר מחדש את נתוני היומן של המשתמשים. כדי לעשות זאת, משתמשים ב-‎--translate_conflicting_events.

 לא נדרש פרמטר


‫Google‏, Google Workspace וסימנים וסמלי לוגו קשורים הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.