azcopy copy

نسخ البيانات المصدر إلى موقع وجهة.

الخلاصة

نسخ البيانات المصدر إلى موقع وجهة. الاتجاهات المدعومة هي:

• المحلي <-> Azure Blob (مصادقة SAS أو OAuth)
• المحلي <-> Azure Files (مصادقة SAS للمشاركة/الدليل)
• المحلي <-> Azure Data Lake Storage Gen2 (مصادقة SAS أو OAuth أو SharedKey)
• Azure Blob (SAS أو عام) -> Azure Blob (مصادقة SAS أو OAuth)
• Azure Data Lake Storage Gen2 (SAS أو عام) -> Azure Data Lake Storage Gen2 (SAS أو مصادقة OAuth)
• Azure Blob (SAS أو مصادقة OAuth) <-> Azure Blob (SAS أو مصادقة OAuth) - راجع الإرشادات.
• Azure Data Lake Storage Gen2 (SAS أو مصادقة OAuth) <-> Azure Data Lake Storage Gen2 (SAS أو مصادقة OAuth)
• Azure Data Lake Storage Gen2 (مصادقة SAS أو OAuth) <-> Azure Blob (SAS أو مصادقة OAuth)
• Azure Blob (SAS أو عام) -> Azure Files (SAS)
• Azure Files (SAS) -> Azure Files (SAS)
• Azure Files (SAS) -> Azure Blob (مصادقة SAS أو OAuth)
• AWS S3 (مفتاح الاختصار) -> Azure Block Blob (مصادقة SAS أو OAuth)
• Google Cloud Storage (مفتاح حساب الخدمة) -> Azure Block Blob (مصادقة SAS أو OAuth)

راجع الأمثلة للحصول على مزيد من المعلومات.

خيارات متقدمة

يكتشف AzCopy نوع محتوى الملفات تلقائياً عند التحميل من القرص المحلي، بناءً على امتداد الملف أو المحتوى (إذا لم يتم تحديد امتداد).

جدول البحث المُضمن صغير، ولكن على يونكس، يُعززه ملف (ملفات) mime.types الخاص بالنظام المحلي إذا كان متوفرًا تحت اسم أو أكثر من هذه الأسماء:

• /etc/mime.types
• /etc/apache2/mime.types
• /etc/apache/mime.types

في Windows، تُستخرج أنواع MIME من السجل. يمكن إيقاف تشغيل هذه الميزة بمساعدة علامة. راجع قسم العلامة.

إذا قمت بتعيين متغير بيئة باستخدام سطر الأوامر، فإن هذا المتغير قابل للقراءة في محفوظات سطر الأوامر. ضع في اعتبارك مسح المتغيرات التي تحتوي على بيانات اعتماد من محفوظات سطر الأوامر. لمنع ظهور المتغيرات في المحفوظات، يمكنك استخدام برنامج نصي لمطالبة المستخدم ببيانات اعتماده، وتعيين متغير البيئة.

azcopy copy [source] [destination] [flags]

مقالات مفاهيمية ذات صلة

• بدء استخدام AzCopy
• نقل البيانات باستخدام AzCopy ومخزن الكائنات الثنائية الكبيرة
• نقل البيانات باستخدام AzCopy وتخزين الملفات

الأمثلة

حمّل ملفًا واحدًا باستخدام مصادقة OAuth. إذا لم تكن قد سجلت الدخول إلى AzCopy بعد، فقم بتشغيل أمر تسجيل الدخول إلى azcopy قبل تشغيل الأمر التالي.

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

كما هو موضح أعلاه، ولكن هذه المرة أيضاً حساب تجزئة MD5 لمحتوى الملف وحفظه كخاصية محتوى blob-MD5:

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]" --from-to PipeBlob

تحميل ملف واحد باستخدام OAuth وpiping (كتل الكائنات الثنائية كبيرة الحجم فقط):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob

حمّل دليلاً كاملاً باستخدام رمز SAS المميز:

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

أو

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --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=true

حمّل الملفات والدلائل إلى حساب 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 ويتم فصل أزواج قيم المفاتيح بواسطة علامة العطف (''')
• أثناء تعيين العلامات على الكائنات الثنائية كبيرة الحجم، هناك المزيد من الأذونات (لا' للعلامات) في SAS التي بدونها تعطي الخدمة خطأ التخويل مرة أخرى.

نزّل ملفًا واحدًا باستخدام مصادقة OAuth. إذا لم تكن قد سجلت الدخول إلى AzCopy بعد، فقم بتشغيل أمر تسجيل الدخول إلى azcopy قبل تشغيل الأمر التالي.

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]" --from-to BlobPipe > "/path/to/file.txt"

قم بتنزيل ملف واحد باستخدام OAuth ثم تمرير الإخراج إلى ملف (كتل الكائنات الثنائية كبيرة الحجم فقط):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"

نزّل دليلاً كاملاً باستخدام رمز SAS المميز:

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true

ملاحظة حول استخدام حرف بدل (*) في عناوين 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

قم بتنزيل جميع إصدارات كائن ثنائي كبير الحجم من Azure Storage إلى الدليل المحلي. تأكد من أن المصدر عبارة عن كائن ثنائي كبير الحجم صالح، وأن الوجهة عبارة عن مجلد محلي وversionidsFile يأخذ مساراً إلى الملف حيث تتم كتابة كل إصدار في سطر منفصل. يتم تنزيل جميع الإصدارات المحددة في المجلد الوجهة المحدد.

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"

انسخ كائن ثنائي كبير الحجم واحد إلى كائن ثنائي كبير الحجم آخر باستخدام رمز 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 المميز ورمز OAuth المميز.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "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=true

انسخ كائنًا واحدًا إلى 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=true

ارجع إلى 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=true

انسخ جميع المستودعات إلى 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=true

انسخ مجموعة فرعية من الحاويات باستخدام رمز حرف بدل (*) في اسم المستودع. مثل الأمثلة السابقة، تحتاج إلى مفتاح وصول ورمز 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=true

انسخ الكائنات الثنائية كبيرة الحجم من وحدة تخزين كائن ثنائي كبير الحجم إلى أخرى واحتفظ بالعلامات من المصدر. للاحتفاظ بالعلامات، استخدم الصيغة التالية:

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]" --s2s-preserve-blob-tags=true

انقل الملفات والدلائل إلى حساب 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 (GCS) باستخدام مفتاح حساب الخدمة ورمز SAS المميز. أولاً، قم بتعيين متغير المجموعة GOOGLE_APPLICATION_CREDENTIALS لمصدر GCS.

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 (GCS) باستخدام مفتاح حساب الخدمة ورمز SAS المميز. أولاً، قم بتعيين متغير المجموعة GOOGLE_APPLICATION_CREDENTIALS لمصدر GCS.

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 (GCS) باستخدام مفتاح حساب الخدمة ورمز SAS المميز. أولاً، قم بتعيين متغير المجموعة GOOGLE_APPLICATION_CREDENTIALS لمصدر GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

انسخ جميع المستودعات إلى Blob Storage من Google Cloud Storage (GCS) باستخدام مفتاح حساب الخدمة ورمز 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 (GCS) باستخدام مفتاح حساب الخدمة ورمز SAS المميز للوجهة. أولاً، قم بتعيين متغيرات المجموعة GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> لمصدر GCS

azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

الخيارات

--as-subdir صحيح بشكل افتراضي. يضع مصادر المجلد كأدلة فرعية ضمن الوجهة. (الافتراضي True)

--backup يقوم بتنشيط SeBackupPrivilege للتحميلات، أو SeRestorePrivilege للتنزيلات، للسماح لـ AzCopy برؤية جميع الملفات، بغض النظر عن أذونات نظام الملفات، واستعادة جميع الأذونات. يتطلب أن يكون لدى الحساب الذي يقوم بتشغيل AzCopy هذه الأذونات بالفعل (على سبيل المثال، لديه حقوق المسؤول أو أنه عضو في مجموعة 'Backup Operators' group). تعمل هذه العلامة على تنشيط الامتيازات التي يمتلكها الحساب بالفعل

--blob-tags (سلسلة) قم بتعيين العلامات على الكائنات الثنائية كبيرة الحجم لتصنيف البيانات في حساب التخزين الخاص بك

--blob-type (سلسلة) تحدد نوع النقطة الثنائية الكبيرة في الوجهة. يُستخدم هذا لتحميل الكائنات الثنائية كبيرة الحجم وعند النسخ بين الحسابات (الافتراضي 'كشف'). تتضمن القيم الصالحة 'Detect', 'BlockBlob', 'PageBlob', and 'AppendBlob'. عند النسخ بين الحسابات، تؤدي قيمة 'الكشف' إلى قيام AzCopy باستخدام نوع الكائن الثنائي كبير الحجم للمصدر لتحديد نوع الكائن الثنائي كبير الحجم للوجهة. عند تحميل ملف، يحدد خيار 'Detect' ما إذا كان الملف VHD أو VHDX بناءً على امتداد الملف. إذا كان الملف عبارة عن ملف VHD أو VHDX، فإن AzCopy يعامل الملف ككائن ثنائي كبير الحجم لصفحة. (الافتراضي "كشف")

--block-blob-tier (سلسلة) تحميل كتلة كائنات ثنائية كبيرة الحجم إلى Azure Storage باستخدام طبقة الكائنات الثنائية كبيرة الحجم هذه. (الافتراضي "لا شيء")

--block-size-mb (عائم) استخدم حجم الكتلة هذا (المحدد في MiB) عند التحميل إلى تخزين Azure والتنزيل من تخزين Azure. تُُحسب القيمة الافتراضية تلقائيًا بناءً على حجم الملف. يُسمح بالكسور العشرية (على سبيل المثال: 0.25). عند التحميل أو التنزيل، يكون الحد الأقصى المسموح به لحجم الكتلة هو 0.75 * AZCOPY_BUFFER_GB. لمعرفة المزيد، راجع تحسين استخدام الذاكرة.

--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 خيارا لتوفير مفتاح تشفير على أساس كل طلب. يتم جلب اسم المفتاح المقدم من Azure Key Vault ويستخدم لتشفير البيانات

--cpk-by-value قدم العميل المفتاح بالاسم الذي يتيح للعملاء إجراء طلبات مقابل تخزين Azure Blob خيارا لتوفير مفتاح تشفير على أساس كل طلب. يتم جلب المفتاح المقدم وتجزئته من متغيرات البيئة

--decompress فك ضغط الملفات تلقائياً عند التنزيل، إذا أشار ترميز المحتوى إلى أنها مضغوطة. قيم ترميز المحتوى المدعومة هي 'gzip' و'deflate'. ملحقات ملفات '.gz'/'.gzip' أو '.zz' ليست ضرورية، ولكن تتم إزالتها إذا كانت موجودة.

--disable-auto-decoding خطأ بشكل افتراضي لتمكين فك التشفير التلقائي للأحرف غير القانونية على Windows. يمكن ضبطه على مجموعة لتعطيل فك التشفير التلقائي.

--dry-run طباعة مسارات الملفات التي سيتم نسخها بواسطة هذا الأمر. هذه العلامة لا تنسخ الملفات الفعلية. العلامة --الكتابة فوق ليس لها أي تأثير. إذا قمت بتعيين العلامة --overwrite إلى false، يتم سرد الملفات الموجودة في الدليل المصدر حتى إذا كانت هذه الملفات موجودة في الدليل الوجهة.

--exclude-attributes (سلسلة) (Windows فقط) استبعاد الملفات التي تطابق سماتها قائمة السمات. على سبيل المثال: A؛S؛R

--exclude-blob-type (سلسلة) اختيارياً تحدد نوع blob (BlockBlob / PageBlob / AppendBlob) لاستبعاده عند نسخ البيانات الثنائية الكبيرة من الحاوية أو الحساب. لا ينطبق استخدام هذه العلامة على نسخ البيانات من خدمة non 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. الأنابيب: BlobPipe، PipeBlob

-h، --help تعليمات النسخ

--include-after (سلسلة) لا تتضمن سوى تلك الملفات التي تم تعديلها في التاريخ / الوقت المحدد أو بعده. يجب أن تكون القيمة بتنسيق ISO8601. إذا لم يتم تحديد منطقة زمنية، يفترض أن تكون القيمة في المنطقة الزمنية المحلية للجهاز الذي يشغّل AzCopy. على سبيل المثال، 2020-08-19T15:04:00Z لتوقيت UTC، أو 2020-08-19 لمنتصف الليل (00:00) بالتوقيت المحلي. اعتباراً من AzCopy 10.5، تنطبق هذه العلامة فقط على الملفات، لا المجلدات، لذلك لن يتم نسخ خصائص المجلد عند استخدام هذه العلامة مع --preserve-smb-info أو --preserve-smb-permissions.

--include-attributes (سلسلة) (Windows فقط) قم بتضمين الملفات التي تطابق سماتها قائمة السمات. على سبيل المثال: A؛S؛R

--include-before (سلسلة) لا تتضمن سوى تلك الملفات التي تم تعديلها قبل أو في التاريخ / الوقت المحدد. يجب أن تكون القيمة بتنسيق ISO8601. إذا لم يتم تحديد منطقة زمنية، يفترض أن تكون القيمة في المنطقة الزمنية المحلية للجهاز الذي يشغّل AzCopy. على سبيل المثال، 2020-08-19T15:04:00Z لتوقيت UTC أو 2020-08-19 لمنتصف الليل (00:00) في المنطقة الزمنية المحلية. اعتبارًا من الإصدار AzCopy 10.7، تنطبق هذه العلامة فقط على الملفات، وليس المجلدات، لذلك لن يتم نسخ خصائص المجلد عند استخدام هذه العلامة مع --preserve-smb-info أو --preserve-smb-permissions.

--include-directory-stub خطأ بشكل افتراضي لتجاهل كعب الروتين للدليل. وحدات التنبيه الجذرية للدليل عبارة عن كائنات ثنائية كبيرة الحجم تحتوي على بيانات التعريف hdi_isfolder:true. سيؤدي تعيين القيمة على صحيح إلى الحفاظ على وحدات كعب الدليل أثناء عمليات النقل. بما في ذلك هذه العلامة مع عدم وجود قيمة افتراضية إلى true (على سبيل المثال،azcopy copy --include-directory-stub هو نفس azcopy copy --include-directory-stub=true).

--include-path (سلسلة نصية) قم بتضمين هذه المسارات فقط عند النسخ. لا يدعم هذا الخيار أحرف البدل (*). للتحقق من بادئة المسار النسبية (على سبيل المثال: myFolder;myFolder/subDirName/file.pdf).

--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" و"false" و"prompt" و"ifSourceNewer". بالنسبة للوجهات التي تدعم المجلدات، تتم الكتابة فوق الخصائص المتعارضة على مستوى المجلد إذا كانت هذه العلامة "صحيحة" أو إذا تم توفير استجابة إيجابية للمطالبة. (الافتراضي «صحيح»)

--page-blob-tier (سلسلة) تحميل الكائن الثنائي كبير الحجم للصفحة إلى Azure Storage باستخدام طبقة الكائنات الثنائية كبيرة الحجم هذه. (الافتراضي 'لا شيء'). (الافتراضي "لا شيء")

--preserve-last-modified-time يتوفر فقط عندما تكون الوجهة هي نظام الملفات.

--preserve-owner يكون له تأثير فقط في التنزيلات، وعند استخدام فقط --preserve-smb-permissions . إذا كان صحيحًا (الافتراضي)، يتم الاحتفاظ بمالك الملف والمجموعة في التنزيلات. إذا تم التعيين إلى خطأ،

--preserve-smb-permissions سيظل يحتفظ ب ACLs ولكن المالك والمجموعة يستندان إلى المستخدم الذي يقوم بتشغيل AzCopy (صحيح افتراضي)

--preserve-permissions False افتراضياً. يحتفظ بقوائم ACL بين الموارد المتوافقة (ملفات Windows وAzure، أو Azure Data Lake Storage Gen2 إلى Azure Data Lake Storage Gen2). بالنسبة للحسابات التي تحتوي على مساحة اسم هرمية، يجب أن يكون أساس الأمان الخاص بك هو المستخدم المالك للحاوية الهدف أو يجب تعيين دور Storage Blob Data Owner، ضمن نطاق الحاوية الهدف، أو حساب التخزين، أو مجموعة الموارد الأصلية، أو الاشتراك. بالنسبة للتنزيلات، ستحتاج أيضاً إلى علامة --backup لاستعادة الأذونات حيث لن يكون المالك الجديد هو المستخدم الذي يقوم بتشغيل AzCopy. تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط).

--preserve-smb-info بالنسبة للمواقع المدركة ل SMB، يتم تعيين العلامة إلى true بشكل افتراضي. يحافظ على معلومات خصائص SMB (آخر وقت للكتابة ووقت الإنشاء وحجم السمات بالبايت) بين الموارد المتوافقة مع SMB (Windows وملفات Azure). يتم نقل بتات السمة التي تدعمها ملفات Azure فقط؛ يتم تجاهل أي أشخاص آخرين. تنطبق هذه العلامة على كل من الملفات والمجلدات، ما لم يُحدد عامل تصفية للملفات فقط (على سبيل المثال، تضمين نمط). المعلومات المنقولة للمجلدات هي نفسها المعلومات الخاصة بالملفات، باستثناء Last Write Time الذي لا يتم الاحتفاظ به للمجلدات مطلقاً. (الافتراضي True)

--preserve-symlinks إذا تم تمكينه، يتم الاحتفاظ بوجهات symlink كمحتوى كائن ثنائي كبير الحجم، بدلا من تحميل الملف أو المجلد على الطرف الآخر من ارتباط symlink.

--put-blob-size-mb استخدم هذا الحجم (المحدد في MiB) كعتبات لتحديد ما إذا كان يجب تحميل كائن ثنائي كبير الحجم كطلب PUT واحد عند التحميل إلى Azure Storage. تُُحسب القيمة الافتراضية تلقائيًا بناءً على حجم الملف. يُسمح بالكسور العشرية (على سبيل المثال: 0.25).

--put-md5 قم بإنشاء تجزئة MD5 لكل ملف، واحفظ التجزئة كخاصية Content-MD5 للكائن الثنائي كبير الحجم الوجهة أو الملف. (لا تُنشأ التجزئة بشكل افتراضي.) متوفرة فقط عند التحميل.

--recursive ابحث في الدلائل الفرعية بشكل متكرر عند التحميل من نظام الملفات المحلي.

--s2s-detect-source-changed اكتشف ما إذا كان الملف المصدر/الكائن الثنائي كبير الحجم يتغير أثناء قراءته. (تنطبق هذه المعلمة فقط على نسخ الخدمة إلى الخدمة، لأنه يتم تمكين التحقق المقابل بشكل دائم لعمليات التحميل والتنزيل.)

--s2s-handle-invalid-metadata (سلسلة) تحدد كيفية معالجة مفاتيح بيانات التعريف غير الصالحة. الخيارات المتاحة: ExcludeIfinvalid، FailIfInvalid، RenameIfInvalid. (الافتراضي 'ExcludeIfInvalid'). (الافتراضي 'ExcludeIfInvalid')

--s2s-preserve-access-tier الاحتفاظ بطبقة الوصول أثناء نسخ الخدمة إلى الخدمة. راجع تخزين Azure Blob: طبقات الوصول العاجلة والعادية والمؤرشفة للتأكد من أن حساب التخزين الوجهة يدعم إعداد طبقة الوصول. في الحالات التي يكون فيها إعداد طبقة الوصول غير مدعوم، تأكد من استخدام s2sPreserveAccessTier = false لتجاوز نسخ طبقة الوصول. (true افتراضي). (الافتراضي True)

--s2s-preserve-blob-tags يحتفظ بعلامات الفهرس أثناء النقل من خدمة إلى خدمة من وحدة تخزين كائن ثنائي كبير الحجم إلى أخرى

--s2s-preserve-properties الاحتفاظ بالخصائص الكاملة أثناء الخدمة لنسخ الخدمة. بالنسبة لمصدر ملفات AWS S3 وAzure File غير الفردي، لا تُرجع عملية القائمة الخصائص الكاملة للكائنات والملفات. للحفاظ على الخصائص الكاملة، يحتاج AzCopy إلى إرسال طلب آخر لكل عنصر أو ملف. (الافتراضي True)

الخيارات الموروثة من الأوامر الأصل

--cap-mbps (عائم) الحد الأقصى لمعدل النقل، بالميغابتات في الثانية. قد تختلف الإنتاجية لحظة بلحظة قليلا عن الحد الأقصى. إذا تم تعيين هذا الخيار على صفر، أو تم حذفه، فلن يتم تحديد معدل النقل لنقظة الارتكاز.

--output-type (سلسلة) تنسيق إخراج الأمر. وتشمل الخيارات: النص، json. القيمة الافتراضية هي 'text'. (افتراضي "نص")

--trusted-microsoft-suffixes (سلسلة) تحديد لاحقات مجال إضافية حيث يمكن إرسال الرموز المميزة لتسجيل الدخول إلى Microsoft Entra. الافتراضي هو '.core.windows.net؛.core.chinacloudapi.cn؛.core.cloudapi.de؛.core.usgovcloudapi.net؛ *.storage.azure.net'. تتم إضافة أي قيمة مدرجة هنا إلى الإعداد الافتراضي. للأمان، يجب وضع مجالات Microsoft Azure هنا فقط. يمكنك فصل الإدخالات المتعددة بفواصل منقوطة.

(راجع أيضًا )

• azcopy