نقل البيانات باستخدام AzCopy وتخزين الملفات

مقالة
12/16/2023

AzCopy عبارة عن أداة مساعدة لسطر الأوامر يمكنك استخدامها لنسخ الملفات من أو إلى حساب تخزين. تحتوي هذه المقالة على أمثلة للأوامر التي تعمل مع ملفات Azure.

الشروع في العمل

راجع مقالة بدء استخدام AzCopy لتنزيل AzCopy والتعرف على الطرق التي يمكنك من خلالها توفير بيانات اعتماد التخويل لخدمة التخزين.

إشعار

توضح الأمثلة الواردة في هذه المقالة استخدام رمز SAS المميز لتخويل الوصول. ومع ذلك، بالنسبة للأوامر التي تستهدف الملفات والدلائل، يمكنك الآن توفير بيانات اعتماد التخويل باستخدام معرف Microsoft Entra وحذف رمز SAS المميز من هذه الأوامر. سيظل يتعين عليك استخدام رمز SAS المميز في أي أمر يستهدف مشاركة الملف أو الحساب فقط (على سبيل المثال: 'azcopy make https://mystorageaccount.file.core.windows.net/myfileshare' أو 'azcopy copy 'https://mystorageaccount.file.core.windows.net'.

لمعرفة المزيد، راجع تخويل AzCopy.

إنشاء مشاركات الملفات

يمكنك استخدام أمر azcopy make لإنشاء مشاركة ملف. ينشئ المثال في هذا القسم مشاركة ملف باسم myfileshare.

تلميح

يتضمن هذا المثال الوسيطات الخاصة بالمسار بعلامات اقتباس مفردة (''). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

بناء الجمله

azcopy make 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>'

مثال

azcopy make 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D'

للحصول على مستندات مرجعية مفصلة، انظر نسخة.

تحميل الملفات

يمكنك استخدام الأمر azcopy Copy لتحميل الملفات والدلائل من جهاز الكمبيوتر المحلي خاصتك.

تلميح

تتضمن الأمثلة الواردة في هذا القسم وسيطات المسار مع علامات اقتباس مفردة («»). استخدم علامات الاقتباس المفردة في كافة أغلفة الأوامر باستثناء shell الأوامر Windows (cmd.exe). في حالة استخدامك Windows Command Shell (cmd.exe)، فقم بإحاطة وسيطات المسار بعلامات اقتباس مزدوجة ("") بدلًا من علامات الاقتباس المفردة ('').

يحتوي هذا القسم على الأمثلة التالية:

تحميل ملف
تحميل دليل
تحميل محتويات الدليل
تحميل ملف معين

تلميح

بمقدورك تعديل عملية التحميل باستخدام علامات اختيارية. إليك بعض الأمثلة.

السيناريو	العلامة
انسخ قوائم التحكم في الوصول (ACLs) مع الملفات.	--preserve-smb-permissions=[true\|false]
انسخ معلومات خاصية SMB مع الملفات.	--preserve-smb-info=[true\|false]

للحصول على قائمة كاملة، راجع الخيارات .

إشعار

لا يقوم AzCopy تلقائيا بحساب وتخزين رمز تجزئة md5 الخاص بالملف لملف أكبر من 256 ميغابايت. إذا كنت تريد أن يقوم AzCopy بذلك، فقم بإلحاق العلامة --put-md5 بكل أمر نسخ. بهذه الطريقة، عند تنزيل الملف، تحسب AzCopy تجزئة MD 5 للبيانات التي تم تنزيلها وتتحقق من أن تجزئة MD 5 المخزنة في خاصية الملف Content-md5 تتطابق مع التجزئة المحسوبة.

تحميل ملف

بناء الجمله

azcopy copy '<local-file-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-name>'

مثال

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

يمكنك أيضًا تحميل ملف باستخدام رمز البدل (*) في أي مكان في مسار الملف أو اسم الملف. على سبيل المثال: 'C:\myDirectory\*.txt' أو C:\my*\*.txt.

تحميل دليل

يقوم هذا المثال بنسخ دليل (وجميع الملفات الموجودة في هذا الدليل) إلى مشاركة ملف. والنتيجة هي دليل في مشاركة الملف بنفس الاسم.

بناء الجمله

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

للنسخ إلى دليل داخل مشاركة الملف، ما عليك سوى تحديد اسم هذا الدليل في سلسلة الأوامر خاصتك.

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

إذا قمت بتحديد اسم دليل غير موجود في مشاركة الملف، يقوم AzCopy بإنشاء دليل جديد بهذا الاسم.

تحميل محتويات الدليل

يمكنك تحميل محتويات الدليل دون نسخ الدليل المحتوي نفسه باستخدام رمز البدل (*).

بناء الجمله

azcopy copy '<local-directory-path>/*' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>'

مثال

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

إشعار

ألحق علامة --recursive لتحميل الملفات في جميع الأدلة الفرعية.

تحميل ملفات محددة

يمكنك تحميل ملفات معينة باستخدام أسماء ملفات كاملة، أو أسماء جزئية بأحرف البدل (*)، أو باستخدام التواريخ والأوقات.

تحديد عدة أسماء ملفات كاملة

استخدم أمر نسخ azcopy مع الخيار --include-path. افصل أسماء الملفات الفردية عن طريق فاصلة منقوطة (;).

بناء الجمله

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-path <semicolon-separated-file-list>

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-path 'photos;documents\myFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

في هذا المثال، تقوم AzCopy بنقل الدليل C:\myDirectory\photos والملف C:\myDirectory\documents\myFile.txt. تحتاج إلى تضمين خيار --recursive لنقل جميع الملفات في الدليل C:\myDirectory\photos.

يمكنك أيضًا استبعاد الملفات باستخدام خيار --exclude-path. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

استخدم حرف البدل

استخدم أمر نسخ azcopy مع الخيار --include-pattern. حدد الأسماء الجزئية التي تشمل أحرف البدل. افصل الأسماء باستخدام فاصلة منقوطة (;).

بناء الجمله

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

مثال

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

يمكنك أيضًا استبعاد الملفات باستخدام خيار --exclude-pattern. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

ينطبق الخياران --include-pattern و --exclude-pattern فقط على أسماء الملفات وليس على المسار. إذا كنت ترغب في نسخ جميع الملفات النصية الموجودة في شجرة الدليل، فاستخدم خيار --recursive للحصول على شجرة الدليل بأكملها، ثم استخدم --include-pattern وحدد *.txt للحصول على جميع الملفات النصية.

تحميل الملفات التي عُدلت بعد التاريخ والوقت

استخدم أمر نسخ azcopy مع الخيار --include-after. حدد التاريخ والوقت بتنسيق ISO 8601 (على سبيل المثال: 2020-08-19T15:04:00Z).

بناء الجمله

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-after <Date-Time-in-ISO-8601-format>

مثال

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

للحصول على مرجع مفصل، راجع نسخة من المستندات المرجعية.

تحميل الملفات

يمكنك استخدام الأمر azcopy Copy لتنزيل الملفات والدلائل ومشاركات الملفات إلى جهاز الكمبيوتر المحلي.

تلميح

يحتوي هذا القسم على الأمثلة التالية:

تنزيل ملف
تنزيل دليل
تنزيل محتويات الدليل
تنزيل ملفات محددة

تلميح

يمكنك تعديل عملية التنزيل باستخدام علامات اختيارية. فيما يلي بعض الأمثلة على ذلك:

السيناريو	العلامة
انسخ قوائم التحكم في الوصول (ACLs) مع الملفات.	--preserve-smb-permissions=[true\|false]
انسخ معلومات خاصية SMB مع الملفات.	--preserve-smb-info=[true\|false]
فك ضغط الملفات تلقائيًا.	--decompress

للحصول على قائمة كاملة، راجع الخيارات .

إشعار

إذا كانت قيمة الخاصية Content-md5 للملف تحتوي على تجزئة، فإن AzCopy تحسب تجزئة MD 5 للبيانات التي نُزلت وتتحقق من أن تجزئة MD 5 المخزنة في خاصية Content-md5 الملف تتطابق مع التجزئة المحسوبة. إذا لم تتطابق هذه القيم، يفشل التنزيل ما لم تتجاوز هذا السلوك عن طريق إلحاق --check-md5=NoCheck أو --check-md5=LogOnly بأمر النسخ.

تنزيل ملف

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' '<local-file-path>'

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

تنزيل دليل

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' '<local-directory-path>' --recursive

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

ينتج عن هذا المثال دليل باسم C:\myDirectory\myFileShareDirectory يحتوي على جميع الملفات التي نُزلت.

تنزيل محتويات الدليل

يمكنك تنزيل محتويات الدليل دون نسخ دليل المحتوي نفسه باستخدام رمز البدل (*).

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/*<SAS-token>' '<local-directory-path>/'

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory/*?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory' --preserve-smb-permissions=true --preserve-smb-info=true

إشعار

ألحق علامة --recursive لتنزيل الملفات في جميع الأدلة الفرعية.

تنزيل ملفات محددة

يمكنك تنزيل ملفات محددة باستخدام أسماء الملفات الكاملة أو الأسماء الجزئية التي تحتوي على أحرف البدل (*) أو باستخدام التواريخ والأوقات.

تحديد عدة أسماء ملفات كاملة

استخدم أمر نسخ azcopy مع الخيار --include-path. افصل أسماء الملفات الفردية عن طريق فاصلة منقوطة (;).

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-path <semicolon-separated-file-list>

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

في هذا المثال، تقوم AzCopy بنقل الدليل https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos والملف https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/documents/myFile.txt. قم بتضمين الخيار--recursive لنقل كافة الملفات في الدليل https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos.

يمكنك أيضًا استبعاد الملفات باستخدام خيار --exclude-path. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

استخدم حرف البدل

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

يمكنك أيضًا استبعاد الملفات باستخدام خيار --exclude-pattern. لمعرفة المزيد، راجع مستندات مرجعية azcopy copy .

تنزيل الملفات التي عُدلت بعد تاريخ ووقت

استخدم أمر نسخ azcopy مع الخيار --include-after. حدد التاريخ والوقت بتنسيق ISO-8601 (على سبيل المثال: 2020-08-19T15:04:00Z).

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name>/*<SAS-token>' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>

مثال

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/*?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

للحصول على مرجع مفصل، راجع نسخة من المستندات المرجعية.

يمكنك تنزيل إصدار محدد من ملف أو دليل عن طريق الرجوع إلى قيمة DateTime لقطة المشاركة. لمعرفة المزيد عن لقطات المشاركة، راجع نظرة عامة على لقطات المشاركة لملفات Azure.

بناء الجمله

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path-or-directory-name><SAS-token>&sharesnapshot=<DateTime-of-snapshot>' '<local-file-or-directory-path>'

مثال (تنزيل ملف)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

مثال (تنزيل دليل)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

نسخ الملفات بين حسابات التخزين

يمكنك استخدام AzCopy لنسخ الملفات إلى حسابات تخزين أخرى. عملية النسخ متزامنة بحيث يتم نسخ جميع الملفات عند إرجاع الأمر.

تستخدم AzCopy من خادم إلى خادم واجهة برمجة التطبيقات، لذلك تُنسخ البيانات مباشرةً بين خوادم التخزين. يمكنك زيادة معدل نقل هذه العمليات عن طريق تعيين قيمة AZCOPY_CONCURRENCY_VALUE متغير البيئة. لمعرفة المزيد، راجع زيادة التزامن.

يمكنك أيضا نسخ إصدارات معينة من ملف عن طريق الرجوع إلى قيمة DateTime للقطة مشاركة. لمعرفة المزيد عن لقطات المشاركة، راجع نظرة عامة على لقطات المشاركة لملفات Azure.

تلميح

يحتوي هذا القسم على الأمثلة التالية:

نسخ ملف إلى حساب تخزين آخر
نسخ دليل إلى حساب تخزين آخر
نسخ مشاركة ملف إلى حساب تخزين آخر
نسخ جميع مشاركات الملفات والدلائل والملفات إلى حساب تخزين آخر

تلميح

يمكنك تعديل عملية النسخ باستخدام الأعلام الاختيارية. إليك بعض الأمثلة.

السيناريو	العلامة
انسخ قوائم التحكم في الوصول (ACLs) مع الملفات.	--preserve-smb-permissions=[true\|false]
انسخ معلومات خاصية SMB مع الملفات.	--preserve-smb-info=[true\|false]

للحصول على قائمة كاملة، راجع الخيارات .

نسخ ملف إلى حساب تخزين آخر

بناء الجمله

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>'

مثال

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

مثال (مشاركة لقطة)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

نسخ دليل إلى حساب تخزين آخر

بناء الجمله

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

مثال (مشاركة لقطة)

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

بناء الجمله

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D --preserve-smb-permissions=true --preserve-smb-info=true

مثال (مشاركة لقطة)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

نسخ جميع مشاركات الملفات والدلائل والملفات إلى حساب تخزين آخر

بناء الجمله

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<SAS-token>' --recursive'

مثال

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

مثال (مشاركة لقطة)

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

مزامنة الملفات

يمكنك مزامنة محتويات نظام ملفات محلي مع مشاركة ملف أو مزامنة محتويات مشاركة ملف مع مشاركة ملف آخر. يمكنك أيضًا مزامنة محتويات الدليل في مشاركة ملف مع محتويات الدليل الموجود في مشاركة ملف آخر. المزامنة هي إحدى الطرق. بعبارة أخرى، يمكنك اختيار أي من نقطتيّ النهاية هاتين لتكون المصدر وأي منهما الوجهة. المزامنة تستخدم أيضًا واجهات برمجة تطبيقات خادم إلى خادم.

إشعار

في الوقت الحالي، يُدعَم هذا السيناريو للحسابات التي مكنت مساحة الأسماء الهرمية عبر نقطة نهاية الكائن الثنائي كبير الحجم.

تحذير

مزامنة AzCopy معتمدة ولكنها غير موصى بها بالكامل لملفات Azure. لا تدعم مزامنة AzCopy النسخ التفاضلية على نطاق واسع، وقد يتم فقد بعض دقة الملفات. لمعرفة المزيد، راجع الترحيل إلى مشاركات ملف Azure.

المبادئ التوجيهيه

بشكل افتراضي، يقارن أمر المزامنة أسماء الملفات والطوابع الزمنية المعدلة الأخيرة. يمكنك تجاوز هذا السلوك لاستخدام تجزئات MD5 بدلا من آخر طوابع زمنية معدلة باستخدام العلامة --compare-hash . اضبط العلامة الاختيارية --delete-destination على قيمة true أو prompt لحذف الملفات في الدليل الوجهة إذا لم تعد هذه الملفات موجودة في الدليل المصدر.

إذا عيّنت العلامة --delete-destination إلى true، يحذف AzCopy الملفات دون تقديم مطالبة. إذا كنت تريد ظهور مطالبة قبل أن يحذف AzCopy ملفًا، فعيّن العلامة --delete-destination إلى prompt.
إذا كنت تخطط لتعيين علم --delete-destination إلى prompt أو false، ففكر في استخدام أمر نسخ بدلاً من أمر مزامنة وتعيين ضابط --overwrite إلى ifSourceNewer. يستهلك أمر نسخ ذاكرة أقل ويتحمل تكاليف فوترة أقل لأن عملية النسخ لا تحتاج إلى فهرسة المصدر أو الوجهة قبل نقل الملفات.
إذا كنت لا تخطط لاستخدام العلامة --compare-hash ، فيجب أن يكون للجهاز الذي تقوم بتشغيل أمر المزامنة عليه ساعة نظام دقيقة لأن آخر مرة تم تعديلها مهمة في تحديد ما إذا كان يجب نقل الملف أم لا. إذا كان نظامك يحتوي على انحراف كبير في الساعة، تجنب تعديل الملفات في الوجهة القريبة جدًا من الوقت الذي تخطط فيه لتشغيل أمر المزامنة.
يستخدم AzCopy واجهات برمجة التطبيقات من خادم إلى خادم لمزامنة البيانات بين حسابات التخزين. وهذا يعني أن البيانات يتم نسخها مباشرة بين خوادم التخزين. ومع ذلك، يقوم AzCopy بإعداد كل عملية نقل ومراقبتها، وبالنسبة لحسابات التخزين الأكبر (على سبيل المثال، الحسابات التي تحتوي على ملايين الكائنات الثنائية كبيرة الحجم)، قد يتطلب AzCopy قدرا كبيرا من موارد الحوسبة لإنجاز هذه المهام. لذلك، إذا كنت تقوم بتشغيل AzCopy من الجهاز الظاهري (VM)، فتأكد من أن الجهاز الظاهري يحتوي على نوى/ذاكرة كافية للتعامل مع الحمل.

تلميح

يمكنك تعديل عملية المزامنة باستخدام العلامات الاختيارية. إليك بعض الأمثلة.

السيناريو	العلامة
انسخ قوائم التحكم في الوصول (ACLs) مع الملفات.	--preserve-smb-permissions=[true\|false]
انسخ معلومات خاصية SMB مع الملفات.	--preserve-smb-info=[true\|false]
استبعاد الملفات بناءً على نمط.	--exclude-path
حدد مدى التفاصيل التي تريد أن تكون عليه إدخالات السجل المتعلقة بالمزامنة.	--مستوى السجل = [تحذير\| خطأ\|معلومات\| لا شيء]

للحصول على قائمة كاملة، راجع الخيارات .

في هذه الحالة، تكون مشاركة الملف هي الوجهة، ويكون نظام الملفات المحلي هو المصدر.

تلميح

بناء الجمله

azcopy sync '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy sync 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive

في هذه الحالة، يكون نظام الملفات المحلي هو الوجهة، وتكون مشاركة الملف هي المصدر.

تلميح

بناء الجمله

azcopy sync 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'C:\myDirectory' --recursive

مثال

azcopy sync 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --recursive

مشاركة الملف الأولى التي تظهر في هذا الأمر هي المصدر. الثاني هو الوجهة.

بناء الجمله

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

أول دليل يظهر في هذا الأمر هو المصدر. الثاني هو الوجهة.

بناء الجمله

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' --recursive

مثال

azcopy sync 'https://mysourceaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

مشاركة الملف الأولى التي تظهر في هذا الأمر هي المصدر. في نهاية URI، قم بإضافة السلسلة &sharesnapshot= متبوعة بقيمة DateTime للقطة.

بناء الجمله

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>&sharesnapsot<snapshot-ID>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

مثال

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-03-03T20%3A24%3A13.0000000Z' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

لمعرفة المزيد عن لقطات المشاركة، راجع نظرة عامة على لقطات المشاركة لملفات Azure.

الخطوات التالية

يمكنك العثور على المزيد من الأمثلة في أي من هذه المقالات:

راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء واستكشاف المشكلات وإصلاحها:

نقل البيانات باستخدام AzCopy وتخزين الملفات

الشروع في العمل

إنشاء مشاركات الملفات

تحميل الملفات

تحميل ملف

تحميل دليل

تحميل محتويات الدليل

تحميل ملفات محددة

تحديد عدة أسماء ملفات كاملة

استخدم حرف البدل

تحميل الملفات التي عُدلت بعد التاريخ والوقت

تحميل الملفات

تنزيل ملف

تنزيل دليل

تنزيل محتويات الدليل

تنزيل ملفات محددة

تحديد عدة أسماء ملفات كاملة

استخدم حرف البدل

تنزيل الملفات التي عُدلت بعد تاريخ ووقت

تنزيل من لقطة مشاركة

نسخ الملفات بين حسابات التخزين

نسخ ملف إلى حساب تخزين آخر

نسخ دليل إلى حساب تخزين آخر

نسخ مشاركة ملف إلى حساب تخزين آخر

نسخ جميع مشاركات الملفات والدلائل والملفات إلى حساب تخزين آخر

مزامنة الملفات

المبادئ التوجيهيه

تحديث مشاركة ملف مع تغييرات على نظام ملفات محلي

تحديث نظام ملفات محلي مع تغييرات على مشاركة ملف

تحديث مشاركة ملف مع تغييرات على مشاركة ملف آخر

تحديث دليل مع تغييرات على دليل في مشاركة ملف آخر

تحديث مشاركة ملف لمطابقة محتويات لقطة المشاركة

الخطوات التالية

الموارد الإضافية