استعلام PowerShell لإدارة الدلائل والملفات في Azure Data Lake Storage Gen2
توضح لك هذه المقالة طريقة استخدام PowerShell لإنشاء الدلائل والملفات وإدارتها في حسابات التخزين التي تحتوي على مساحة أسماء هرمية.
لمعرفة طريقة الحصول على قوائم التحكم في الوصول (ACL) الخاصة بالدلائل والملفات وتعيينها وتحديثها، راجع استخدام PowerShell لإدارة قوائم التحكم في الوصول إلى Azure Data Lake Storage Gen2.
راجع | تعيين Gen1 إلى Gen2 | تقديم الملاحظات
المتطلبات الأساسية
اشتراك Azure. لمزيد من المعلومات، راجع الحصول على التجربة المجانية من Azure.
حساب تخزين يحتوي على مساحة أسماء هرمية ممكنة. اتبع هذه الإرشادات لإنشاء واحدة.
.NET Framework يمثل 4.7.2 أو أعلى مثبتة. لمزيد من المعلومات، يرجى الاطلاع علىتنزيل .NET Framework.
إصدار PowerShell
5.1
أو أحدث.
ثبّت وحدة PowerShell النمطية
تحقق من أن إصدار PowerShell المثبت أو
5.1
أعلى باستخدام الأمر التالي.echo $PSVersionTable.PSVersion.ToString()
لترقية إصدار PowerShell خاصتك، راجع ترقية Windows PowerShell الحالية
ثبّت وحدة Az.Storage.
Install-Module Az.Storage -Repository PSGallery -Force
لمزيد من المعلومات بشأن طريقة تثبيت وحدات PowerShell النمطية، يرجى الاطلاع علىتثبيت الوحدة النمطية Azure PowerShell
الاتصال بالحساب
حدّد الطريقة التي تريد أن تحصل بها الأوامر على تخويل لحساب التخزين.
الخيار 1: الحصول على التخويل باستخدام معرف Microsoft Entra
باستخدام هذا النهج، يضمن النظام أن حساب المستخدم الخاص بك لديه تعيينات التحكم في الوصول المستندة إلى دور Azure (Azure RBAC) المناسبة وأذونات الوصول إلى ACL.
افتح نافذة أوامر Windows PowerShell، ثم سجّل الدخول إلى اشتراك Azure باستخدام
Connect-AzAccount
الأمر واتبع الإرشادات التي تظهر على الشاشة.Connect-AzAccount
إن كانت هويتك مقترنة بأكثر من اشتراك واحد، فحدد اشتراكك النشط لاشتراك حساب التخزين الذي تريد إنشاء الدلائل فيه وإدارتها. في هذا المثال، استبدل قيمة العنصر النائب
<subscription-id>
بمعرف اشتراكك.Select-AzSubscription -SubscriptionId <subscription-id>
ادخل على سياق حساب التخزين.
$ctx = New-AzStorageContext -StorageAccountName '<storage-account-name>' -UseConnectedAccount
الخيار 2: الحصول على تخويل باستخدام مفتاح حساب التخزين
باستخدام هذا النهج، لا يتحقق النظام من أذونات Azure RBAC أو ACL. احصل على سياق حساب التخزين باللجوء إلى مفتاح حساب.
$ctx = New-AzStorageContext -StorageAccountName '<storage-account-name>' -StorageAccountKey '<storage-account-key>'
إنشاء حاوية
تعمل الحاوية كنظام ملفات لملفاتك. بمقدورك إنشاء واحد باستخدام New-AzStorageContainer
cmdlet.
هذا المثال ينشئ حاوية باسم my-file-system
.
$filesystemName = "my-file-system"
New-AzStorageContainer -Context $ctx -Name $filesystemName
إنشاء دليل
إنشاء مرجع دليل باستخدام cmdletNew-AzDataLakeGen2Item
.
يضيف هذا المثال دليلاً باسم my-directory
إلى حاوية.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -Directory
يضيف هذا المثال الدليل نفسه، ولكنه يضيف أذونات الوصول وumask وقيم الخصائص وقيم بيانات التعريف.
$dir = New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -Directory -Permission rwxrwxrwx -Umask ---rwx--- -Property @{"ContentEncoding" = "UDF8"; "CacheControl" = "READ"} -Metadata @{"tag1" = "value1"; "tag2" = "value2" }
إظهار الخصائص المتعلقة بالدليل
يحصل هذا المثال على دليل باستخدام cmdlet Get-AzDataLakeGen2Item
، ثم يقوم بطباعة قيم الخصائص إلى وحدة التحكم.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dir = Get-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname
$dir.ACL
$dir.Permissions
$dir.Group
$dir.Owner
$dir.Properties
$dir.Properties.Metadata
إشعار
للحصول على الدليل الجذر الخاص بالمحتوى، احذف المعلمة-Path
.
إعادة تسمية دليل أو نقله
إعادة تسمية أو نقل دليل باستخدام cmdlet Move-AzDataLakeGen2Item
.
يعيد هذا المثال تسمية دليل من الاسمmy-directory
إلى الاسمmy-new-directory
.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dirname2 = "my-new-directory/"
Move-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -DestFileSystem $filesystemName -DestPath $dirname2
إشعار
استعمل المعلمة -Force
إذا كنت تريد الكتابة فوق بدون مطالبات.
ينقل هذا المثال دليلًا مسمى my-directory
إلى دليل فرعيmy-directory-2
باسمmy-subdirectory
.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dirname2 = "my-directory-2/my-subdirectory/"
Move-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -DestFileSystem $filesystemName -DestPath $dirname2
حذف دليل
حذف دليل باستخدام cmdletRemove-AzDataLakeGen2Item
.
يحذف هذا المثال دليلاً باسم my-directory
.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
Remove-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname
يمكنك استخدام المعلمة-Force
لإزالة الملف دون مطالبة.
تنزيل من دليل
قم بتنزيل ملف من دليل باستخدام cmdletGet-AzDataLakeGen2ItemContent
.
يقوم هذا المثال بتنزيل ملف مسمى upload.txt
من دليل يحمل اسمmy-directory
.
$filesystemName = "my-file-system"
$filePath = "my-directory/upload.txt"
$downloadFilePath = "download.txt"
Get-AzDataLakeGen2ItemContent -Context $ctx -FileSystem $filesystemName -Path $filePath -Destination $downloadFilePath
إعداد قائمة محتويات الدليل
أعدّ قائمة بمحتويات دليل باستخدام cmdlet Get-AzDataLakeGen2ChildItem
. يمكنك استخدام المعلمة -OutputUserPrincipalName
الاختيارية؛ للتمكن من الحصول على اسم المستخدمين (بدلًا من معرّف الكائن).
يسرد هذا المثال محتويات دليل يسمىmy-directory
.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
Get-AzDataLakeGen2ChildItem -Context $ctx -FileSystem $filesystemName -Path $dirname -OutputUserPrincipalName
يسرد المثال التالي خصائص كل من ACL
و Permissions
وGroup
وOwner
لكل عنصر في الدليل. تعتبر المعلمة-FetchProperty
أمرًا ضروريًا للحصول على قيم للخاصيةACL
.
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$properties = Get-AzDataLakeGen2ChildItem -Context $ctx -FileSystem $filesystemName -Path $dirname -Recurse -FetchProperty
$properties.ACL
$properties.Permissions
$properties.Group
$properties.Owner
إشعار
لسرد محتويات الدليل الجذر للحاوية، احذف المعلمة-Path
.
تحميل ملف إلى دليل
تحميل ملف إلى دليل باستخدام cmdlet New-AzDataLakeGen2Item
.
هذا المثال يقوم بتحميل ملف مسمى upload.txt
إلى دليل باسم my-directory
.
$localSrcFile = "upload.txt"
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$destPath = $dirname + (Get-Item $localSrcFile).Name
New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $destPath -Source $localSrcFile -Force
يقوم هذا المثال بتحميل الملف نفسه، ومن ثم يعين الأذونات وumask وقيم الخصائص وقيم بيانات التعريف للملف الوجهة. يطبع هذا المثال أيضًا هذه القيم إلى وحدة التحكم.
$file = New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $destPath -Source $localSrcFile -Permission rwxrwxrwx -Umask ---rwx--- -Property @{"ContentEncoding" = "UDF8"; "CacheControl" = "READ"} -Metadata @{"tag1" = "value1"; "tag2" = "value2" }
$file1
$file1.Properties
$file1.Properties.Metadata
إشعار
لتحميل ملف إلى الدليل الجذر للحاوية، احذف المعلمة-Path
.
إظهار خصائص خاصة بالملف
يحصل هذا المثال على ملف باستخدام cmdletGet-AzDataLakeGen2Item
، ثم يقوم بطباعة قيم الخصائص إلى وحدة التحكم.
$filepath = "my-directory/upload.txt"
$filesystemName = "my-file-system"
$file = Get-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $filepath
$file
$file.ACL
$file.Permissions
$file.Group
$file.Owner
$file.Properties
$file.Properties.Metadata
حذف ملف
احذف ملف باستخدام cmdlet Remove-AzDataLakeGen2Item
.
احذف هذا المثال ملفًا باسمupload.txt
.
$filesystemName = "my-file-system"
$filepath = "upload.txt"
Remove-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $filepath
يمكنك استخدام المعلمة-Force
لإزالة الملف دون مطالبة.
تعيين Gen1 على Gen2
يوضح الجدول التالي طريقة تعيين cmdlets المستخدمة Data Lake Storage Gen1 إلى cmdlets Data Lake Storage Gen2.
إشعار
تم الآن إيقاف Azure Data Lake Storage Gen1. انظر إعلان التقاعد هنا. لم يعد من الممكن الوصول إلى موارد Data Lake Storage Gen1. إذا كنت بحاجة إلى مساعدة خاصة، فيرجى الاتصال بنا.
Data Lake Storage Gen1 cmdlet | Data Lake Storage Gen2 cmdlet | ملاحظات |
---|---|---|
Get-AzDataLakeStoreChildItem | Get-AzDataLakeGen2ChildItem | بشكل افتراضي، لا يسرد cmdlet Get-AzDataLakeGen2ChildItem سوى العناصر الفرعية من المستوى الأول. تسرد المعلمة -Recurse العناصر الفرعية بصفةٍ متكررةٍ. |
Get-AzDataLakeStoreItem Get-AzDataLakeStoreItemAclEntry Get-AzDataLakeStoreItemOwner Get-AzDataLakeStoreItemPermission |
Get-AzDataLakeGen2Item | تحتوي عناصر الإخراج الخاصة ب Get-AzDataLakeGen2Item cmdlet على هذه الخصائص: Acl، المالك، المجموعة، الإذن. |
Get-AzDataLakeStoreItemContent | Get-AzDataLakeGen2FileContent | Get-AzDataLakeGen2FileContent cmdlet تقوم بتنزيل محتوى الملف إلى ملف محلي. |
Move-AzDataLakeStoreItem | Move-AzDataLakeGen2Item | |
New-AzDataLakeStoreItem | New-AzDataLakeGen2Item | يقوم cmdlet بتحميل محتوى الملف الجديد من ملف محلي. |
Remove-AzDataLakeStoreItem | Remove-AzDataLakeGen2Item | |
Set-AzDataLakeStoreItemOwner Set-AzDataLakeStoreItemPermission Set-AzDataLakeStoreItemAcl |
Update-AzDataLakeGen2Item | لا يقوم Update-AzDataLakeGen2Item cmdlet سوى بتحديث عنصر واحد وتجنب التكرار. إذا كنت ترغب في التحديث بشكل متكرر، فقم بإدراج العناصر باستخدام Cmdlet Get-AzDataLakeStoreChildItem، ثم المسار إلى Update-AzDataLakeGen2Item cmdlet. |
Test-AzDataLakeStoreItem | Get-AzDataLakeGen2Item | يبلغ Cmdlet Get-AzDataLakeGen2Item عن خطأ إذا لم يكن العنصر موجودا. |