مشاركة عبر

Set-FileLabel

الوحدة النمطية:
PurviewInformationProtection Module

تعيين وصف الحساسية والحماية لملف من خلال التسمية اليدوية أو التسمية التلقائية وفقا لتكوين التسمية أو الأذونات المخصصة.

بناء الجملة

SetLabel 

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

SetLabelCustom 

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    -CustomPermissions <AIPCustomPermissions>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

Custom 

Set-FileLabel
    [-Path] <String[]>
    -CustomPermissions <AIPCustomPermissions>
    [-Owner <String>]
    [-PreserveFileDetails]

SetAutoLabel 

Set-FileLabel
    [-Path] <String[]>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-Force]
    [-PreserveFileDetails]
    [-AutoLabel]

WhatIf 

Set-FileLabel
    [-Path] <String[]>
    [-PreserveFileDetails]
    [-WhatIf]
    [-DiscoveryInfoTypes <String[]>]

الوصف

بالنسبة لعميل Microsoft Purview Information Protection، يقوم Set-FileLabel cmdlet بتعيين تسمية حساسية لملف واحد أو أكثر. يمكن لهذا الإجراء تطبيق الحماية تلقائيا عند تكوين التسميات لتطبيق التشفير.

بالإضافة إلى ذلك، يمكنك استخدام الأمر cmdlet هذا لتطبيق الأذونات المخصصة عند إنشائها ككائن نهج حماية مخصص باستخدام cmdlet New-CustomPermissions .

عند تشغيل الأمر بنجاح، يمكن استبدال أي تسمية أو حماية موجودة.

يمكنك تشغيل cmdlet هذا بشكل غير تفاعلي. لمزيد من المعلومات، راجع دليل مسؤول عميل التسمية الموحد.

أمثلة

مثال 1: تطبيق التسمية "عام" على كافة الملفات التي لا تحتوي حاليا على تسمية

Get-FileStatus -Path \\Finance\Projects\ |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -LabelId d9f23ae3-4321-4321-4321-f515f824c57b

FileName                              Status Comment
--------                              ------ ------------
\\Finance\Projects\Image.jpg          Success
\\Finance\Projects\Pricelist.pdf      Success
\\Finance\Projects\Announcement.docx  Success
\\Finance\Projects\Analysis.xlsx      Success

يعرف هذا الأمر أولا جميع الملفات غير المسماة باستخدام Get-FileStatus cmdlet. بعد ذلك، يتم تسمية هذه الملفات عن طريق تحديد التسمية "عام" حسب معرفها.

مثال 2: تطبيق التسمية "عام" على ملفات .docx غير المسماة

Get-ChildItem C:\Projects\*.docx -File -Recurse |
    Get-FileStatus |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b

FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

يحدد هذا الأمر أولا جميع .docx الملفات الموجودة في C:\Projects المجلد (ومجلداته الفرعية) باستخدام Get-Child-Item، ثم يجد من هذه الملفات الملفات التي لم يتم تسميتها باستخدام Get-FileStatus cmdlet. ثم يتم تسمية الملفات الناتجة عن طريق تحديد التسمية العامة بمعرفها.

ملاحظة

يستخدم هذا الأمر الاسم المستعار Path ل FullName، بحيث يمكن استخدام Get-Child-Item مع Get-FileStatus.

مثال 3: تطبيق التسمية "عام" على كافة الملفات الموجودة في مجلد وأي من مجلداته الفرعية

Set-FileLabel -Path C:\Projects\ -LabelId d9f23ae3-1324-1234-1234-f515f824c57b

FileName                    Status      Comment
--------                    ------      ------------
C:\Projects\Project1.docx   Success
C:\Projects\Datasheet.pdf   Success
C:\Projects\Image.jpg       Success
C:\Projects\Analysis.xlsx   Skipped    No label to apply
C:\Projects\Dashboard.xlsx  Success

يقوم هذا الأمر بتعيين تسمية باسم "عام" على كافة الملفات الموجودة في C:\Projects المجلد وأي من مجلداته الفرعية.

إذا تم تكوين التسمية General لتطبيق التشفير، أيضا تشفير الملفات التي تمت تسميتها بنجاح باستخدام هذا الأمر. في هذه الحالة، مالك إدارة الحقوق (الذي لديه إذن التحكم الكامل بإدارة الحقوق) لهذه الملفات هو المستخدم الذي قام بتشغيل أمر PowerShell.

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

لتمكين هذه الحماية، يجب تكوين نهج تسمية تصنيف Office 365 لطلب مبرر لإزالة تسمية أو خفض التصنيف. عند تشغيل هذا الأمر بعد ذلك بدون المعلمة JustificationMessage وتشغل التسمية التبرير، يتم تخطي الملف مع التعليق "لا توجد تسمية لتطبيقها".

مثال 4: تطبيق التسمية "عام" على ملف واحد، والذي يتطلب تبريرا

$setFileLabelSplat = @{
    Path = '\\Finance\Projects\Analysis.xlsx'
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    JustificationMessage = 'The previous label no longer applies'
}
Set-FileLabel @setFileLabelSplat

FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

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

مثال 5: حماية ملف بأذونات مخصصة

$newCustomPermissionsSplat = @{
    Users = 'user1@contoso.com', 'user2@vanarsdel.com'
    Permissions = 'Reviewer'
    ExpirationDate = (Get-Date -Month 1 -Day 1 -Year 2020)
}
$permissions = New-CustomPermissions @newCustomPermissionsSplat
Set-FileLabel C:\Projects\Analysis.docx -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

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

يحمي الأمر الثاني ملفا واحدا مسمى Analysis.docx باستخدام الأذونات المخصصة في كائن نهج الحماية المخصص المخزن.

مثال 6: تطبيق تسمية وأذونات مخصصة على ملف

$permissions = New-CustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer
$setFileLabelSplat = @{
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    CustomPermissions = $permissions
}
Set-FileLabel @setFileLabelSplat C:\Projects\Analysis.docx

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

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

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

مثال 7: فحص جميع الملفات في شجرة مجلدات وتطبيق التسميات وفقا للشروط التي تم تكوينها

Set-FileLabel -AutoLabel -Path C:\Projects\ -PreserveFileDetails

FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName :
MainLabelId   :
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName :
MainLabelId   :
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName :
MainLabelId   :
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  :
SubLabelId    :

يفحص هذا الأمر جميع الملفات الموجودة في مجلد Projects وأي من مجلداته الفرعية، ويعين التسميات وفقا للشروط المكونة في نهج التسمية التلقائية. في هذا المثال، هناك خمسة ملفات وملفان يتم تصنيفهما تلقائيا. لم يتم تسمية الملف Datasheet.pdf لأن محتوياته لا تتطابق مع الشروط التي تم تكوينها للتسمية Analysis.xlsx التلقائية التي تم تسميتها يدويا بالفعل، ولها Pricelist.xlsx تسمية أعلى. نظرا لأنه يتم تشغيل الأمر بدون المعلمة Force ، فإن التسميات الموجودة ل Analysis.xlsx ولا Pricelist.xlsx يتم استبدالها.

إذا تم تكوين التسميات المطبقة أيضا لتطبيق حماية إدارة الحقوق، فإن الملفات التي تم تسميتها بنجاح بهذا الأمر محمية أيضا. في هذه الحالة، مالك إدارة الحقوق (الذي لديه إذن التحكم الكامل بإدارة الحقوق) لهذه الملفات هو المستخدم الذي قام بتشغيل أمر PowerShell.

نظرا لتحديد المعلمة PreserveFileDetails ، يظل تاريخ التعديل للملفات المسماة دون تغيير.

مثال 8: فحص جميع الملفات في شجرة مجلد وتطبيق التسميات وفقا للشروط التي تم تكوينها، وتجاوز أي تسميات موجودة

Set-FileLabel -Autolabel -Path C:\Projects\ -Force -PreserveFileDetails

FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName :
MainLabelId   :
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  :
SubLabelId    :

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  :
SubLabelId    :

يشبه هذا الأمر المثال السابق من حيث أنه يقوم أيضا بمسح جميع الملفات الموجودة في مجلد Projects وأي من مجلداته الفرعية، وتعيين التسميات وفقا للشروط المكونة للتسمية التلقائية. ومع ذلك ، هذه المرة ، نظرا لأن الأمر يتضمن المعلمة Force ، فإنه يحل أيضا محل التسمية الموجودة ل Dashboard.xlsx، و Pricelist.xlsx.

Datasheet.pdf محتويات لا تتطابق مع أي شروط تم تكوينها ويظل هذا الملف بدون تسمية.

مثال 9: فحص ملف بحثا عن جميع أنواع المعلومات الحساسة المعروفة

Set-FileLabel -AutoLabel -Path C:\Projects\Project1.docx -DiscoveryInfoTypes All

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

يكتشف هذا الأمر جميع أنواع المعلومات المعروفة في ملف Project1.docx دون تطبيق الحماية أو التسمية.

مثال 10: فحص ملف بحثا عن أنواع معينة من المعلومات الحساسة

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = "50842eb7-edc8-4019-85dd-5a5c1f2bb085", "a44669fe-0d48-453d-a9b1-2cc83f2cba77"
}
Set-FileLabel @setFileLabelSplat

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

يكتشف هذا الأمر أنواع المعلومات المحددة لرقم بطاقة الائتمانورقم الضمان الاجتماعي (SSN) في Project1.docx الملف دون تطبيق الحماية أو التسمية.

مثال 11: فحص ملف بحثا عن أنواع معينة من المعلومات الحساسة وعرض القيم التي تم العثور عليها

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = '50842eb7-edc8-4019-85dd-5a5c1f2bb085',
        'a44669fe-0d48-453d-a9b1-2cc83f2cba77'
}
$x = Set-FileLabel @setFileLabelSplat
$x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}

$x.MatchedInformationTypes[0].SensitiveContents | Format-List

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

على غرار المثال السابق ، يكتشف الأمر الأول أنواع المعلومات المحددة لرقم بطاقة الائتمانورقم الضمان الاجتماعي (SSN) في Project1.docx الملف دون تطبيق الحماية أو التسمية. ومع ذلك، في هذا المثال، يتم تخزين النتائج في متغير لمزيد من المعالجة.

ثم يتم استخدام الأمر الثاني لعرض محتويات أنواع المعلومات المتطابقة، والتي تتضمن المعلمة SensitiveContents.

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

المعلمات

-AutoLabel

عند استخدام -AutoLabel، يتم تشغيل cmdlet في وضع التسمية التلقائية. عند عدم استخدام -AutoLabel cmdlet، يتم تشغيله في وضع التسمية اليدوية.

خصائص المعلمات

النوع:SwitchParameter
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetAutoLabel
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-CustomPermissions

يحدد اسم المتغير الذي يخزن نهج حماية مخصص، والذي تم إنشاؤه باستخدام الأمر cmdlet New-CustomPermissions . يتم استخدام نهج الحماية المخصصة لحماية الملف أو الملفات بأذونات مخصصة.

خصائص المعلمات

النوع:AIPCustomPermissions
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetLabelCustom
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
Custom
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-DiscoveryInfoTypes

حدد أنواع المعلومات الحساسة التي سيتم اكتشافها عند استخدام المعلمة WhatIf .

إذا كنت تريد البحث عن أنواع معلومات حساسة معينة، فحدد رقم معرف الكيان لنوع المعلومات هذا، والذي يمكنك العثور عليه مدرجا في أنواع المعلومات الحساسة في Exchange Server.

على سبيل المثال، "50842eb7-edc8-4019-85dd-5a5c1f2bb085" هو الرقم الذي يجب تحديده لنوع المعلومات الحساسة لرقم بطاقة الائتمان.

خصائص المعلمات

النوع:

String[]

القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

WhatIf
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-Force

يستبدل تسمية موجودة عند تطبيق الشروط المكونة.

خصائص المعلمات

النوع:SwitchParameter
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetAutoLabel
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-JustificationMessage

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

خصائص المعلمات

النوع:String
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetLabel
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
SetLabelCustom
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
SetAutoLabel
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-LabelId

تحديد هوية (معرف) التسمية لتطبيقها. عندما تحتوي التسمية على تسميات فرعية، حدد دائما معرف تسمية فرعية فقط وليس التسمية الأصل.

للعثور على معرف التسمية:

لا يتم عرض قيمة معرف التسمية في مدخل التوافق Microsoft Purview. ومع ذلك، يمكنك استخدام الأمر التالي PowerShell لمركز الأمان والتوافق في Office 365 للعثور على هذه القيمة: Get-Label | Format-Table -Property DisplayName, Name, Guid

بالنسبة للملفات التي تم تطبيق تسميات عليها، يمكنك أيضا تشغيل الأمر Get-FileStatus cmdlet لتحديد معرف التسمية (MainLabelId أو SubLabelId).

خصائص المعلمات

النوع:Guid
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetLabel
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
SetLabelCustom
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-Owner

تحديد المالك لتطبيق التسمية أو الحماية على الملف.

خصائص المعلمات

النوع:String
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

SetLabel
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
SetLabelCustom
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
Custom
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False
SetAutoLabel
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-Path

تحديد مسار محلي أو مسار شبكة أو عنوان URL ل SharePoint Server إلى الملفات التي تريد الحصول على معلومات التسمية والحماية لها.

أحرف البدل غير معتمدة ومواقع WebDav غير معتمدة.

بالنسبة إلى مسارات SharePoint، يتم دعم ما يلي:

  • SharePoint Server 2022
  • SharePoint Server 2019
  • SharePoint Server 2016
  • خادم SharePoint 2013

على سبيل المثال:

  • C:\Folder\
  • C:\Folder\Filename
  • \\Server\Folder
  • http://sharepoint.contoso.com/Shared%20Documents/Folder

يمكن أن تتضمن المسارات مسافات عند إحاطة قيمة المسار بعلامات اقتباس.

خصائص المعلمات

النوع:

String[]

القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False
الأسماء المستعارة:الاسم الكامل, FileName

مجموعات المعلمات

(All)
Position:0
إلزامي:True
القيمة من مسار معالجة البيانات:True
القيمة من مسار معالجة البيانات حسب اسم الخاصية:True
القيمة من الوسائط المتبقية:False

-PreserveFileDetails

حدد هذه المعلمة لترك تاريخ التعديل (Windows وSharePoint) وتعديله بواسطة قيم (SharePoint) دون تغيير للمستندات التي تسميها:

  • بالنسبة إلى الملفات المحلية أو ملفات الشبكة، تظل قيمة تاريخ التعديل دون تغيير.

  • بالنسبة لملفات SharePoint، يظل تاريخ التعديل والقيم المعدلة حسب القيم دون تغيير.

خصائص المعلمات

النوع:SwitchParameter
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

(All)
Position:Named
إلزامي:False
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

-WhatIf

يظهر ما قد يحدث إذا تم تشغيل cmdlet. لم يتم تشغيل cmdlet.

خصائص المعلمات

النوع:SwitchParameter
القيمة الافتراضية:None
يدعم أحرف البدل:False
DontShow:False

مجموعات المعلمات

WhatIf
Position:Named
إلزامي:True
القيمة من مسار معالجة البيانات:False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:False
القيمة من الوسائط المتبقية:False

الإدخالات

System.String

المخرجات

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

ملاحظات

عند تشغيل Set-FileLabel cmdlet في حلقة، أضف الأمر التالي بعد cmdlet:

  • [GC]::Collect()
  • [GC]::WaitForPendingFinalizers()

تضمن هذه الأوامر تشغيل مجمع البيانات المهملة وتحريره الذاكرة التي لم تعد هناك حاجة إليها.