نقل البيانات باستخدام AzCopy وتخزين الملفات
AzCopy عبارة عن أداة مساعدة لسطر الأوامر يمكنك استخدامها لنسخ الملفات من أو إلى حساب تخزين. تحتوي هذه المقالة على أمثلة للأوامر التي تعمل مع ملفات Azure.
قبل أن تبدأ، راجع مقالة ابدأ بمقالة AzCopy لتنزيل AzCopy والتعرف على الأداة.
تلميح
تتضمن الأمثلة الواردة في هذه المقالة حجج المسار مع اقتباسات مفردة (" "). استخدم اقتباسات مفردة في جميع أغلفة الأوامر باستثناء غلاف أوامر Windows (cmd.exe). إذا كنت تستخدم Windows Command Shell (cmd.exe )، فقم بإرفاق وسيطات المسار باقتباسات مزدوجة (" ") بدلاً من اقتباسات مفردة (" ").
إنشاء مشاركات الملفات
يمكنك استخدام أمر azcopy make لإنشاء مشاركة ملف. ينشئ المثال في هذا القسم مشاركة ملف باسم myfileshare.
بناء الجملة
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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%3D'
للحصول على مستندات مرجعية مفصلة، انظر نسخة.
تحميل الملفات
يمكنك استخدام الأمر azcopy Copy لتحميل الملفات والدلائل من جهاز الكمبيوتر المحلي خاصتك.
يحتوي هذا القسم على الأمثلة التالية:
- تحميل ملف
- تحميل دليل
- تحميل محتويات الدليل
- تحميل ملف معين
تلميح
يمكنك تعديل عملية التحميل باستخدام الأعلام الاختيارية. إليك بعض الأمثلة.
| السيناريو | وضع علامة |
|---|---|
| انسخ قوائم التحكم في الوصول (ACLs) مع الملفات. | --preserve-smb-permissions=[true|false] |
| انسخ معلومات خاصية SMB مع الملفات. | --preserve-smb-info=[true|false] |
للحصول على قائمة كاملة، راجع الخيارات.
ملاحظة
لا تقوم AzCopy تلقائيًا بحساب وتخزين رمز التجزئة md5 للملف. إذا كنت تريد أن تقوم 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><SAS-token>'
مثال
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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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 مع الخيار --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. لمعرفة المزيد، راجع نسخة من مستندات مرجعية.
ينطبق الخياران --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] |
| فك ضغط الملفات تلقائياً. | --فك الضغط |
للحصول على قائمة كاملة، راجع الخيارات.
ملاحظة
إذا كانت قيمة الخاصية 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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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 مع الخيار --include-pattern. حدد الأسماء الجزئية التي تتضمن أحرف البدل. افصل الأسماء باستخدام فاصلة منقوطة (;).
بناء الجملة
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. لمعرفة المزيد، راجع نسخة من مستندات مرجعية.
ينطبق الخياران --include-pattern و --exclude-pattern فقط على أسماء الملفات وليس على المسار. إذا كنت ترغب في نسخ جميع الملفات النصية الموجودة في شجرة الدليل، فاستخدم خيار --recursive للحصول على شجرة الدليل بأكملها، ثم استخدم --include-pattern وحدد *.txt للحصول على جميع الملفات النصية.
تنزيل الملفات التي عُدلت بعد تاريخ ووقت
استخدم أمر نسخ 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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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=%2FSOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B%2F3Eykf%2FJLs%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 .
الإرشادات
يقارن أمر المزامنة أسماء الملفات والطوابع الزمنية الأخيرة المعدلة. اضبط
--delete-destinationالعلامة الاختيارية على قيمةtrueأوpromptلحذف الملفات في الدليل الوجهة إذا لم تعد هذه الملفات موجودة في الدليل المصدر.إذا قمت بتعيين
--delete-destinationالعلامة إلىtrue، يقوم AzCopy بحذف الملفات دون تقديم مطالبة. إذا كنت تريد ظهور مطالبة قبل أن يحذف AzCopy ملفًا، فقم بتعيين--delete-destinationالعلامة إلىprompt.إذا كنت تخطط لتعيين علم
--delete-destinationإلىpromptأوfalse، ففكر في استخدام أمر نسخ بدلاً من أمر مزامنة وتعيين ضابط--overwriteإلىifSourceNewer. يستهلك أمر نسخ ذاكرة أقل ويتحمل تكاليف فوترة أقل لأن عملية النسخ لا تحتاج إلى فهرسة المصدر أو الوجهة قبل نقل الملفات.يجب أن يكون لدى الجهاز الذي تقوم بتشغيل أمر المزامنة عليه ساعة نظام دقيقة لأن الأوقات الأخيرة المعدلة حاسمة في تحديد ما إذا كان يجب نقل ملف. إذا كان نظامك يحتوي على انحراف كبير في الساعة، تجنب تعديل الملفات في الوجهة القريبة جدًا من الوقت الذي تخطط فيه لتشغيل أمر المزامنة.
تلميح
يمكنك تعديل عملية المزامنة باستخدام العلامات الاختيارية. إليك بعض الأمثلة.
| السيناريو | وضع علامة |
|---|---|
| انسخ قوائم التحكم في الوصول (ACLs) مع الملفات. | --preserve-smb-permissions=[true|false] |
| انسخ معلومات خاصية SMB مع الملفات. | --preserve-smb-info=[true|false] |
| استبعاد الملفات بناءً على نمط. | --استبعاد المسار |
| حدد مدى التفصيل الذي تريد أن تكون عليه إدخالات السجل المتعلقة بالمزامنة. | --مستوى السجل = [تحذير| خطأ|معلومات| لا شيء] |
للحصول على قائمة كاملة، راجع الخيارات.
تحديث مشاركة ملف مع تغييرات على نظام ملفات محلي
في هذه الحالة، تكون مشاركة الملف هي الوجهة، ويكون نظام الملفات المحلي هو المصدر.
تلميح
هذا المثال يرفق وسيطات المسار مع اقتباسات واحدة (""). استخدم اقتباسات مفردة في جميع أغلفة الأوامر باستثناء غلاف أوامر Windows (cmd.exe). إذا كنت تستخدم Windows Command Shell (cmd.exe )، فقم بإرفاق وسيطات المسار باقتباسات مزدوجة (" ") بدلاً من اقتباسات مفردة (" ").
بناء الجملة
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
تحديث نظام ملفات محلي مع تغييرات على مشاركة ملف
في هذه الحالة، يكون نظام الملفات المحلي هو الوجهة، وتكون مشاركة الملف هي المصدر.
تلميح
هذا المثال يرفق وسيطات المسار مع اقتباسات واحدة (""). استخدم اقتباسات مفردة في جميع أغلفة الأوامر باستثناء غلاف أوامر Windows (cmd.exe). إذا كنت تستخدم Windows Command Shell (cmd.exe )، فقم بإرفاق وسيطات المسار باقتباسات مزدوجة (" ") بدلاً من اقتباسات مفردة (" ").
بناء الجملة
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.
الخطوات التالية
يمكنك العثور على المزيد من الأمثلة في أي من هذه المقالات:
راجع هذه المقالات لتكوين الإعدادات وتحسين الأداء وحل المشكلات: