azcopy copy
نسخ البيانات المصدر إلى موقع وجهة.
الخلاصة
نسخ البيانات المصدر إلى موقع وجهة. الاتجاهات المدعومة هي:
- المحلي <-> Azure Blob (مصادقة SAS أو OAuth)
- المحلي <-> Azure Files (مصادقة SAS للمشاركة/الدليل)
- المحلي <-> Azure Data Lake Storage Gen 2 (مصادقة SAS أو OAuth أو المفاتيح المشتركة)
- Azure Blob (SAS أو عام) -> Azure Blob (مصادقة SAS أو OAuth)
- Azure Blob (SAS أو عام) -> Azure Files (SAS)
- Azure Files (SAS) -> Azure Files (SAS)
- Azure Files (SAS) -> Azure Blob (مصادقة SAS أو OAuth)
- Amazon Web Services (AWS) S3 (مفتاح الوصول) -> Azure Block Blob (مصادقة SAS أو OAuth)
- Google Cloud Storage (مفتاح حساب الخدمة) -> Azure Block Blob (مصادقة SAS أو OAuth) [معاينة]
لمزيد من المعلومات، راجع قسم الأمثلة في هذه المقالة.
مقالات مفاهيمية ذات صلة
- بدء العمل مع أداة المساعدة AzCopy
- البرنامج التعليمي: ترحيل البيانات المحلية إلى التخزين السحابي باستخدام AzCopy
- نقل البيانات باستخدام AzCopy ومخزن الكائنات الثنائية كبيرة الحجم
- نقل البيانات باستخدام AzCopy وتخزين الملفات
متقدم
يكتشف AzCopy تلقائيًا نوع محتوى الملفات استنادًا إلى امتداد الملف أو المحتوى (إذا لم يتم تحديد أي امتداد) عند تحميلها من القرص المحلي.
جدول البحث المُضمن صغير، ولكن على يونكس، يُعززه ملف (ملفات) mime.types الخاص بالنظام المحلي إذا كان متوفرًا تحت اسم أو أكثر من هذه الأسماء:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
في Windows، تُستخرج أنواع MIME من السجل. يمكن إيقاف تشغيل هذه الميزة بمساعدة علامة. لمزيد من المعلومات، راجع قسم العلامات في هذه المقالة.
إذا قمت بتعيين متغير بيئة باستخدام سطر الأوامر، فسيكون هذا المتغير قابلاً للقراءة في محفوظات سطر الأوامر. ضع في اعتبارك مسح المتغيرات التي تحتوي على بيانات اعتماد من محفوظات سطر الأوامر. لمنع ظهور المتغيرات في المحفوظات، يمكنك استخدام برنامج نصي لمطالبة المستخدم ببيانات اعتماده، وتعيين متغير البيئة.
azcopy copy [source] [destination] [flags]
أمثلة
حمّل ملفًا واحدًا باستخدام مصادقة OAuth. إذا لم تكن قد سجلت الدخول إلى AzCopy حتى الآن، فشغّل الأمر azcopy login قبل تشغيل الأمر التالي.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
كما هو موضح أعلاه، ولكن هذه المرة، قم أيضًا بحساب تجزئة MD5 لمحتوى الملف وحفظه كخاصية Content-MD5 الخاصة بـ blob:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
حمّل ملفًا واحدًا باستخدام رمز SAS المميز:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
حمّل ملفًا واحدًا باستخدام رمز SAS المميز وشبكة الأنابيب (كتل الكائنات الثنائية كبيرة الحجم فقط):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]
حمّل دليلاً كاملاً باستخدام رمز SAS المميز:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive
أو
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive --put-md5
حمّل مجموعة من الملفات باستخدام رمز SAS المميز وأحرف البدل (*):
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
حمّل الملفات والدلائل باستخدام رمز SAS المميز وأحرف البدل (*):
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive
حمّل الملفات والدلائل إلى حساب Azure Storage وعيّن العلامات المشفرة لسلسلة الاستعلام على الكائن الثنائي كبير الحجم.
لتعيين العلامات {key = "bla bla", val = "foo"} and {key = "bla bla 2", val = "bar"}، استخدم بناء الجملة التالي :
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"يتم ترميز المفاتيح والقيم بعنوان URL ويتم فصل أزواج قيم المفاتيح باستخدام علامة العطف ('&')
أثناء إعداد العلامات على الكائنات الثنائية كبيرة الحجم، هناك أذونات إضافية ("t" للعلامات) في SAS والتي بدونها ستُرجع الخدمة خطأ تخويل.
نزّل ملفًا واحدًا باستخدام مصادقة OAuth. إذا لم تكن قد سجلت الدخول إلى AzCopy حتى الآن، فشغّل الأمر azcopy login قبل تشغيل الأمر التالي.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
نزّل ملفًا واحدًا باستخدام رمز SAS المميز:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
نزّل ملفًا واحدًا باستخدام رمز SAS مميز ثم توصيل الإخراج إلى ملف (كتل الكائنات الثنائية كبيرة الحجم فقط):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" > "/path/to/file.txt"
نزّل دليلاً كاملاً باستخدام رمز SAS المميز:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive
ملاحظة حول استخدام حرف بدل (*) في عناوين URL:
هناك طريقتان مدعومتان فقط لاستخدام حرف بدل في عنوان URL.
يمكنك استخدام واحدًا فقط بعد الشرطة المائلة للأمام النهائية (/) لعنوان URL مباشرة. هذا الاستخدام لحرف البدل ينسخ جميع الملفات الموجودة في دليل مباشرة إلى الوجهة دون وضعها في دليل فرعي.
يمكنك أيضًا استخدام حرف بدل في اسم حاوية طالما أن عنوان URL يشير فقط إلى حاوية وليس إلى كائن ثنائي كبير الحجم. يمكنك استخدام هذا النهج للحصول على ملفات من مجموعة فرعية من الحاويات.
نزّل محتويات دليل دون نسخ الدليل الذي يحتوي عليها نفسه.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
نزّل حساب تخزين كامل.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
نزّل مجموعة فرعية من الحاويات داخل حساب تخزين باستخدام رمز حرف بدل (*) في اسم الحاوية.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
انسخ كائن ثنائي كبير الحجم واحد إلى كائن ثنائي كبير الحجم آخر باستخدام رمز SAS مميز.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
انسخ كائن ثنائي كبير الحجم واحد إلى كائن ثنائي كبير الحجم آخر باستخدام رمز SAS مميز ورمز مصادقة مميز. يجب عليك استخدام رمز SAS المميز في نهاية عنوان URL للحساب المصدر، ولكن الحساب الوجهة لا يحتاج إلى واحد إذا قمت بتسجيل الدخول إلى AzCopy باستخدام الأمر azcopy login.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
انسخ دليل ظاهري لكائن ثنائي كبير الحجم واحد إلى آخر باستخدام رمز SAS مميز:
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
انسخ جميع حاويات الكائنات الثنائية كبيرة الحجم والدلائل والكائنات الثنائية كبيرة الحجم من حساب تخزين إلى آخر باستخدام رمز SAS مميز:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive
انسخ كائنًا واحدًا إلى Blob Storage من Amazon Web Services (AWS) S3 باستخدام مفتاح وصول ورمز SAS مميز. أولاً، عيّن متغير البيئة AWS_ACCESS_KEY_ID وAWS_SECRET_ACCESS_KEY لمصدر AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
انسخ دليلاً كاملاً إلى Blob Storage من AWS S3 باستخدام مفتاح وصول ورمز SAS مميز. أولاً، عيّن متغير البيئة AWS_ACCESS_KEY_ID وAWS_SECRET_ACCESS_KEY لمصدر AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive
ارجع إلى https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html لفهم العنصر النائب [المجلد] بشكل أفضل.
انسخ جميع المستودعات إلى Blob Storage من Amazon Web Services (AWS) باستخدام مفتاح وصول ورمز SAS مميز. أولاً، عيّن متغير البيئة AWS_ACCESS_KEY_ID وAWS_SECRET_ACCESS_KEY لمصدر AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive
انسخ جميع المستودعات إلى Blob Storage من منطقة Amazon Web Services (AWS) باستخدام مفتاح وصول ورمز SAS مميز. أولاً، عيّن متغير البيئة AWS_ACCESS_KEY_ID وAWS_SECRET_ACCESS_KEY لمصدر AWS S3.
- azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive
انسخ مجموعة فرعية من الحاويات باستخدام رمز حرف بدل (*) في اسم المستودع. مثل الأمثلة السابقة، ستحتاج إلى مفتاح وصول ورمز SAS مميز. تأكد من تعيين متغير البيئة AWS_ACCESS_KEY_ID وAWS_SECRET_ACCESS_KEY لمصدر AWS S3.
- azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive
انقل الملفات والدلائل إلى حساب Azure Storage وعيّن العلامات المشفرة لسلسلة الاستعلام المحددة على الكائن الثنائي كبير الحجم.
لتعيين العلامات {key = "bla bla", val = "foo"} and {key = "bla bla 2", val = "bar"}، استخدم بناء الجملة التالي :
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"يتم ترميز المفاتيح والقيم بعنوان URL ويتم فصل أزواج قيم المفاتيح باستخدام علامة العطف ('&')
أثناء إعداد العلامات على الكائنات الثنائية كبيرة الحجم، هناك أذونات إضافية ("t" للعلامات) في SAS والتي بدونها ستُرجع الخدمة خطأ تخويل.
انسخ كائنًا واحدًا إلى Blob Storage من Google Cloud Storage باستخدام مفتاح حساب خدمة ورمز SAS مميز. أولاً، عيّن متغير البيئة GOOGLE_APPLICATION_CREDENTIALS لمصدر Google Cloud Storage.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
انسخ دليل كامل إلى Blob Storage من Google Cloud Storage باستخدام مفتاح حساب خدمة ورمز SAS مميز. أولاً، عيّن متغير البيئة GOOGLE_APPLICATION_CREDENTIALS لمصدر Google Cloud Storage.
- azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
انسخ مستودع كامل إلى Blob Storage من Google Cloud Storage باستخدام مفتاح حساب خدمة ورمز SAS مميز. أولاً، عيّن متغير البيئة GOOGLE_APPLICATION_CREDENTIALS لمصدر Google Cloud Storage.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
انسخ جميع المستودعات إلى Blob Storage من Google Cloud Storage باستخدام مفتاح حساب خدمة ورمز SAS مميز. أولاً، عيّن متغيرات البيئة GOOGLE_APPLICATION_CREDENTIALS وGOOGLE_CLOUD_PROJECT=<project-id> لمصدر GCS
- azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
انسخ مجموعة فرعية من المستودعات باستخدام رمز حرف بدل (*) في اسم المستودع من Google Cloud Storage باستخدام مفتاح حساب خدمة ورمز SAS مميز للوجهة. أولاً، عيّن متغيرات البيئة GOOGLE_APPLICATION_CREDENTIALS وGOOGLE_CLOUD_PROJECT=<project-id> لمصدر Google Cloud Storage.
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
الخيارات
--backup ينشط SeBackupPrivilege في Windows للتحميلات، أو SeRestorePrivilege للتنزيلات، للسماح لـ AzCopy برؤية جميع الملفات وقراءتها، بغض النظر عن أذونات نظام الملفات الخاصة بها، ولاستعادة جميع الأذونات. يتطلب أن يكون الحساب الذي يشغّل AzCopy لديه بالفعل هذه الأذونات (على سبيل المثال، لديه حقوق المسؤول أو أنه عضو في مجموعة Backup Operators). تعمل هذه العلامة على تنشيط الامتيازات التي لدى الحساب بالفعل.
سلسلة --blob-tags تعيين العلامات على الكائنات الثنائية كبيرة الحجم لتصنيف البيانات في حساب التخزين الخاص بك.
سلسلة --blob-type تحدد نوع الكائن الثنائي كبير الحجم في الوجهة. يستخدم هذا لتحميل الكائنات الثنائية كبيرة الحجم وعند النسخ بين الحسابات (الافتراضي Detect). تتضمن القيم الصالحة Detect، وBlockBlob، وPageBlob، وAppendBlob. عند النسخ بين الحسابات، تتسبب قيمة Detect في أن يستخدم AzCopy نوع الكائن الثنائي كبير الحجم للمصدر لتحديد نوع الكائن الثنائي كبير الحجم للوجهة. عند تحميل ملف، يحدد Detect ما إذا كان الملف عبارة عن ملف VHD أو VHDX استنادًا إلى امتداد الملف. إذا كان الملف عبارة عن ملف VHD أو VHDX، فإن AzCopy يعامل الملف ككائن ثنائي كبير الحجم لصفحة. (الافتراضي "كشف")
سلسلة --block-blob-tier تحميل كتلة كائنات ثنائية كبيرة الحجم إلى Azure Storage باستخدام طبقة الكائنات الثنائية كبيرة الحجم هذه. (الافتراضي "لا شيء")
تعويم --block-size-mb استخدم حجم الكتلة هذا (المحدد في MiB) عند التحميل إلى "تخزين Azure" والتنزيل من "تخزين Azure". تُُحسب القيمة الافتراضية تلقائيًا بناءً على حجم الملف. يُسمح بالكسور العشرية (على سبيل المثال: 0.25).
--cache-control تعيّن عنوان التحكم في ذاكرة التخزين المؤقت. تم إرجاعه عند التنزيل.
--check-length تحقق من طول الملف على الوجهة بعد النقل. إذا كان هناك عدم تطابق بين المصدر والوجهة، وضع علامة على النقل على أنه فاشل. (القيمة الافتراضية هي true)
سلسلة --check-md5 تحدد مدى دقة التحقق من صحة تجزئات MD5 عند التنزيل. متوفر فقط عند التنزيل. الخيارات المتاحة: NoCheck، LogOnly، FailIfDifferent، FailIfDifferentOrMissing. (الافتراضي FailIfDifferent) (الافتراضي "FailIfDifferent")
سلسلة --content-disposition تعيين عنوان تصرف المحتوى. تم إرجاعه عند التنزيل.
سلسلة --content-encoding تعيين عنوان ترميز المحتوى. تم إرجاعه عند التنزيل.
سلسلة --content-language تعيين عنوان لغة المحتوى. تم إرجاعه عند التنزيل.
سلسلة --content-type تعيّن نوع المحتوى للملف. يعني عدم تخمين نوع mime. تم إرجاعه عند التنزيل.
سلسلة --cpk-by-name قدّم العميل مفتاحًا بالاسم يسمح للعملاء تقديم طلبات مقابل Azure Blob Storage بخيار لتوفير مفتاح تشفير على أساس كل طلب. سيُحضر اسم المفتاح المُقدم من Azure Key Vault وسيُستخدم لتشفير البيانات.
--cpk-by-value قدّم العميل مفتاحًا بالاسم يسمح للعملاء تقديم طلبات مقابل Azure Blob Storage بخيار لتوفير مفتاح تشفير على أساس كل طلب. سيُحضر المفتاح المُقدم والتجزئة الخاصة به من متغيرات البيئة.
--decompress فك ضغط الملفات تلقائيًا عند التنزيل، إذا كان ترميز المحتوى الخاص بها يشير إلى أنها مضغوطة. قيم ترميز المحتوى المدعومة هي gzip وdeflate. امتدادات الملفات .gz/.gzip أو .zz ليست ضرورية، ولكن ستتم إزالتها إذا كانت موجودة.
--dry-run يطبع مسارات الملفات التي سيتم نسخها بواسطة هذا الأمر. لا تنسخ هذه العلامة الملفات الفعلية.
--disable-auto-decoding خطأ بشكل افتراضي لتمكين فك الترميز التلقائي للأحرف غير القانونية على Windows. يمكن تعيينه على true لتعطيل فك الترميز التلقائي.
سلسلة --exclude-attributes (Windows فقط) تستبعد الملفات التي تتطابق سماتها مع قائمة السمات. على سبيل المثال: A؛S؛R
سلسلة --exclude-blob-type تحدد اختياريًا نوع الكائن الثنائي كبير الحجم (BlockBlob/ PageBlob/ AppendBlob) لاستبعاده عند نسخ الكائنات الثنائية كبيرة الحجم من الحاوية أو الحساب. لا ينطبق استخدام هذه العلامة على نسخ البيانات من خدمة غير تابعة لـ Azure إلى الخدمة. يجب فصل أكثر من كائن ثنائي كبير الحجم واحد بواسطة ;.
سلسلة --exclude-path استبعاد هذه المسارات عند النسخ. لا يدعم هذا الخيار أحرف البدل (*). يتحقق من بادئة المسار النسبي (على سبيل المثال: myFolder;myFolder/subDirName/file.pdf). عند استخدام المسارات مع اجتياز الحساب، فإنها على تتضمن اسم الحاوية.
سلسلة --exclude-pattern استبعاد هذه الملفات عند النسخ. يدعم هذا الخيار أحرف البدل (*).
سلسلة --exclude-regex استبعاد بالكامل المسار النسبي للملفات التي تتماشى مع التعبيرات العادية. افصل التعبيرات العادية بـ ';'.
--follow-symlinks اتباع الارتباطات الرمزية عند التحميل من نظام الملفات المحلي.
--force-if-read-only عند الكتابة فوق ملف موجود على Windows أو Azure Files، افرض عمل الكتابة الفوقية حتى إذا كان الملف الموجود يحتوي على مجموعة سمات للقراءة فقط الخاصة به.
سلسلة --from-to تحدد اختياريا مجموعة وجهة المصدر. على سبيل المثال: LocalBlob، BlobLocal، LocalBlobFS.
--help مساعدة للنسخ.
سلسلة --include-after تضمين فقط تلك الملفات التي تم تعديلها في أو بعد التاريخ/الوقت المحدد. يجب أن تكون القيمة بتنسيق ISO8601. إذا لم يتم تحديد منطقة زمنية، يفترض أن تكون القيمة في المنطقة الزمنية المحلية للجهاز الذي يشغّل AzCopy. على سبيل المثال، 2020-08-19T15:04:00Z لتوقيت UTC أو 2020-08-19 لمنتصف الليل (00:00) في المنطقة الزمنية المحلية. كما هو الحال في AzCopy 10.5، تنطبق هذه العلامة فقط على الملفات، وليس المجلدات، لذلك لن يتم نسخ خصائص المجلد عند استخدام هذه العلامة مع --preserve-smb-info أو --preserve-permissions.
سلسلة --include-before تضمين فقط تلك الملفات التي تم تعديلها قبل أو في التاريخ/الوقت المحدد. يجب أن تكون القيمة بتنسيق ISO8601. إذا لم يتم تحديد منطقة زمنية، يفترض أن تكون القيمة في المنطقة الزمنية المحلية للجهاز الذي يشغّل AzCopy. على سبيل المثال، 2020-08-19T15:04:00Z لتوقيت UTC أو 2020-08-19 لمنتصف الليل (00:00) في المنطقة الزمنية المحلية. اعتبارًا من الإصدار AzCopy 10.7، تنطبق هذه العلامة فقط على الملفات، وليس المجلدات، لذلك لن يتم نسخ خصائص المجلد عند استخدام هذه العلامة مع --preserve-smb-info أو --preserve-permissions.
سلسلة --include-attributes (Windows فقط) تتضمن الملفات التي تتطابق سماتها مع قائمة السمات. على سبيل المثال: A؛S؛R
سلسلة --include-path تضمين فقط هذه المسارات عند النسخ. لا يدعم هذا الخيار أحرف البدل (*). يتحقق من بادئة المسار النسبي (على سبيل المثال: myFolder;myFolder/subDirName/file.pdf).
--include-directory-stub خطأ بشكل افتراضي لتجاهل كعب الدليل. وحدات كعب الدليل عبارة عن كائنات ثنائية كبيرة الحجم تحتوي على بيانات التعريف "hdi_isfolder:true". سيؤدي تعيين القيمة على صحيح إلى الحفاظ على وحدات كعب الدليل أثناء عمليات النقل.
سلسلة --include-pattern تضمين فقط هذه الملفات عند النسخ. يدعم هذا الخيار أحرف البدل (*). فصل الملفات باستخدام ;.
سلسلة --include-regex تضمين فقط المسار النسبي للملفات التي تتماشى مع التعبيرات العادية. افصل التعبيرات العادية بـ ';'.
سلسلة --list-of-versions تحدد ملفا حيث يتم سرد كل معرف إصدار في سطر منفصل. تأكد من أن المصدر يجب أن يشير إلى blob واحدة ويجب أن تنتمي جميع معرفات الإصدار المحددة في الملف باستخدام هذه العلامة إلى الblob المصدر فقط. سيقوم AzCopy بتنزيل الإصدارات المحددة في مجلد الوجهة المتوفر. لمزيد من المعلومات، راجع تنزيل الإصدارات السابقة من كائن ثنائي كبير الحجم.
--log-level السجل حدد الإسهاب في السجل لملف السجل، والمستويات المتاحة: INFO (جميع الطلبات / الردود)، وWARNING (الاستجابات البطيئة)، وERROR (الطلبات الفاشلة فقط)، وNONE (لا توجد سجلات الإخراج). (افتراضي INFO).
سلسلة --metadata التحميل إلى Azure Storage باستخدام أزواج قيم المفاتيح هذه كبيانات تعريف.
--no-guess-mime-type يمنع AzCopy من اكتشاف نوع المحتوى استنادًا إلى امتداد الملف أو محتواه.
سلسلة --overwrite الكتابة فوق الملفات المتعارضة والكائنات الثنائية كبيرة الحجم في الوجهة إذا تم تعيين هذه العلامة على صحيح. (الافتراضي true) تشمل القيم المحتملة true وfalse وprompt وifSourceNewer. بالنسبة للوجهات التي تدعم المجلدات، ستتم كتابة الخصائص المتعارضة على مستوى المجلد فوق هذه العلامة true أو إذا تم توفير استجابة إيجابية للمطالبة. (الافتراضي «صحيح»)
سلسلة --page-blob-tier تحميل الكائن الثنائي كبير الحجم للصفحة إلى Azure Storage باستخدام طبقة الكائنات الثنائية كبيرة الحجم هذه. (افتراضي None). (الافتراضي "لا شيء")
--preserve-last-modified-time متوفر فقط عندما تكون الوجهة هي نظام الملفات.
--preserve-owner له تأثير فقط في التنزيلات، وفقط عند استخدام --preserve-permissions. إذا كان صحيحًا (الافتراضي)، يتم الاحتفاظ بمالك الملف والمجموعة في التنزيلات. إذا تم تعيينه خطأ، فسيظل --preserve-permissions يحتفظ بقوائم التحكم بالوصول (ACL) ولكن سيعتمد المالك والمجموعة على المستخدم الذي يشغّل AzCopy (الافتراضي صحيح)
--preserve-smb-info صحيح بشكل افتراضي. يحافظ على معلومات خصائص SMB (آخر وقت للكتابة ووقت الإنشاء وحجم السمات بالبايت) بين الموارد المتوافقة مع SMB (Windows وملفات Azure). سيتم نقل بتات السمات التي يدعمها Azure Files فقط؛ سيتم تجاهل أي بتات أخرى. تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط). المعلومات المنقولة للمجلدات هي نفسها الخاصة بالملفات، باستثناء "آخر وقت للكتابة" الذي لم يُحفظ للمجلدات مطلقًا.
--preserve-permissions خطأ بشكل افتراضي. يحافظ على قوائم التحكم في الوصول بين الموارد المتوافقة (Windows وملفات Azure، أو Data Lake Storage Gen 2 إلى Data Lake Storage Gen 2). بالنسبة للحسابات التي تحتوي على مساحة اسم هرمية، ستحتاج إلى رمز SAS أو OAuth المميز للحاوية مع أذونات "تعديل الملكية" "وتعديل الأذونات". بالنسبة للتنزيلات، ستحتاج أيضًا إلى علامة --backup لاستعادة الأذونات حيث لن يكون المالك الجديد هو المستخدم الذي يُشغل AzCopy. تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط).
--put-md5 يُنشئ تجزئة MD5 لكل ملف، ويحفظ التجزئة كخاصية Content-MD5 للكائن الثنائي كبير الحجم أو الملف الوجهة. (لا تُنشأ التجزئة بشكل افتراضي.) متوفرة فقط عند التحميل.
--recursive البحث في الدلائل الفرعية بشكل متكرر عند التحميل من نظام ملفات محلي.
--s2s-detect-source-changed اكتشاف ما إذا كان الملف المصدر/ الكائن الثنائي كبير الحجم يتغير أثناء قراءته. (تنطبق هذه المعلمة فقط على نسخ الخدمة إلى الخدمة، لأنه يتم تمكين التحقق المقابل بشكل دائم لعمليات التحميل والتنزيل.)
سلسلة --s2s-handle-invalid-metadata تحدد كيفية معالجة مفاتيح بيانات التعريف غير الصالحة. الخيارات المتاحة: ExcludeIfinvalid، FailIfInvalid، RenameIfInvalid. (افتراضي ExcludeIfInvalid).
--s2s-preserve-access-tier يحتفظ بطبقة الوصول أثناء نسخ خدمة إلى خدمة. ارجع إلى طبقات الوصول الفعّالة والفرعية والمؤرشفة لبيانات كائن ثنائي كبير الحجم للتأكد من أن حساب تخزين الوجهة يدعم تعيين طبقة الوصول. في الحالات التي يكون فيها تعيين طبقة الوصول غير مدعوم، استخدم s2sPreserveAccessTier=false لتجاوز نسخ طبقة الوصول. (افتراضي true).
--s2s-preserve-blob-tags يحتفظ بعلامات الفهرس أثناء النقل من خدمة إلى خدمة من وحدة تخزين كائن ثنائي كبير الحجم إلى أخرى.
--s2s-preserve-properties الحفاظ على الخصائص الكاملة أثناء النسخ من خدمة إلى خدمة. بالنسبة لمصدر ملفات AWS S3 وAzure File غير الفردي، لا تُرجع عملية القائمة الخصائص الكاملة للكائنات والملفات. للحفاظ على الخصائص الكاملة، يحتاج AzCopy إلى إرسال طلب إضافي واحد لكل كائن أو ملف. (الافتراضي True)
الخيارات الموروثة من الأوامر الأصل
--cap-mbps float يحدد الحد الأقصى لمعدل النقل بالميغابت في الثانية. قد تختلف الإنتاجية لحظة بلحظة قليلًا عن الحد الأقصى. إذا تم تعيين هذا الخيار إلى صفر، أو تم حذفه، فلن يتم تحديد الحد الأقصى للإنتاجية.
سلسلة --output-type تنسيق إخراج الأمر. وتشمل الخيارات: النص، json. القيمة الافتراضية هي text. (افتراضي "نص")
سلسلة --trusted-microsoft-suffixes تُحدد لواحق المجال الإضافية حيث يمكن إرسال الرموز المميزة لتسجيل الدخول إلى Microsoft Azure Active Directory. الافتراضي هو *.core.windows.net;*.core.chinacloudapi.cn;*.core.cloudapi.de;*.core.usgovcloudapi.net. تتم إضافة أي مدرج هنا إلى الإعداد الافتراضي. للأمان، يجب عليك فقط وضع مجالات Microsoft Azure هنا. فصل إدخالات متعددة بفواصل منقوطة.