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

‫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: שימוש במצב מיפוי להעברת תיקיות ציבוריות (מומלץ). במצב הזה, המערכת משתמשת בקובץ מיפוי כדי למפות את התיקייה הציבורית לקבוצה ב-Groups. מכיוון שכתובות אימייל של קבוצות לרוב לא תואמות לשמות של תיקיות ציבוריות, רוב הארגונים משתמשים במצב מיפוי.

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

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

א עד ה

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

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

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

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

 לא נדרש פרמטר

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

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

הארגומנט הזה שימושי כשרוצים להחריג הודעות עם סטאבים מפתרון ארכיון. הכלי 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, או none (משאירים את השדה ריק) עבור 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"‎

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

N—Z

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

--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. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.