مشاركة عبر

Get-AipServiceDocumentLog

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

الحصول على معلومات الحماية حول المستندات التي يتم تعقبها بواسطة Azure Information Protection.

يتم دعم أمر cmdlet هذا من قبل كل من عملاء التسمية الكلاسيكية والموحدة لحماية البيانات في Azure، مع استخدام مختلف، كما هو موضح أدناه.

بناء الجملة

Default (افتراضي) 

Get-AipServiceDocumentLog
    -ContentName <String>
    -Owner <String>
    [-FromTime <DateTime>]
    [-ToTime <DateTime>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

الوصف

يقوم Get-AIPServiceDocumentLog cmdlet بتشغيل استعلام لإرجاع معلومات الحماية حول المستندات المتعقبة.

تتضمن المعلومات التي تم إرجاعها ما يلي:

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

يمكنك تحديد وقت البدء ووقت إيقاف الإدخالات لتضمينها. يتم إرجاع الإخراج ك قائمة كائنات PowerShell في وحدة تحكم PowerShell.

لمزيد من المعلومات، راجع مالكي إدارة الحقوق ومصدري IRights Management.

عند استخدامه مع عميل التسمية الموحد، يستند الاستعلام إلى اسم المستند أو البريد الإلكتروني للمالك أو كليهما.

يجب تحديد معلمة واحدة على الأقل من المعلمات التالية:

  • اسم المحتوى
  • المالك

تلميح

إذا كنت تستخدم المعلمة ContentName، نوصي أيضا باستخدام معلمات FromTime ToTime لتصفية المحتوى إلى فترة زمنية معينة.

أمثلة

مثال 1: (عميل التسمية الموحد فقط) احصل على معلومات الحماية حول جميع المستندات المتعقبة باسم ملف معين، والتي كانت محمية في إطار زمني محدد

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

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

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

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

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

  • اسم الملف test.docx
  • تمت حماية الملف من قبل مستخدم مع البريد الإلكتروني alice@contoso.com
  • تمت حماية الملف في ديسمبر 2020.

المعلمات

-Confirm

يطالبك بالتأكيد قبل تشغيل cmdlet.

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

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

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

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

-ContentName

تحديد الاسم الكامل للمستند المتعقب، بما في ذلك ملحق الملف.

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

تلميح

إذا كنت تستخدم هذه المعلمة، نوصي أيضا باستخدام FromTime ToTime عوامل تصفية التاريخ لتصفية البيانات التي تم إرجاعها.

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

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

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

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

-FromTime

تحديد وقت البدء (ضمنا) لملف السجل كعنصر DateTime. للحصول على كائن DateTime، استخدم الأمر cmdlet Get-Date . حدد التاريخ والوقت وفقا لإعدادات النظام المحلية.

لمزيد من المعلومات، اكتب Get-Help Get-Date.

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

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

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

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

-Owner

يحدد عنوان البريد الإلكتروني للمستخدم الذي قام بحماية المستند (مصدر أو مالك إدارة الحقوق).

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

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

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

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

-ToTime

تحديد وقت الإيقاف (ضمنا) لملف السجل كعنصر DateTime. للحصول على كائن DateTime، استخدم الأمر cmdlet Get-Date . حدد التاريخ والوقت وفقا لإعدادات النظام المحلية.

لمزيد من المعلومات، اكتب Get-Help Get-Date.

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

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

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

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

-WhatIf

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

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

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

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

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

CommonParameters

يدعم cmdlet هذا المعلمات الشائعة: -Debug و -ErrorAction و -ErrorVariable و -InformationAction و -InformationVariable و -OutBuffer و -OutVariable و -PipelineVariable و -ProgressAction و -Verbose و -WarningAction و -WarningVariable. لمزيد من المعلومات، راجع about_CommonParameters.