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

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

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

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

 לא נדרש פרמטר

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

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

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

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

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

--exclude_top_level_folders

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

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

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

ז—נ

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

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