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

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

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

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

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