共用方式為

Get-AipServiceDocumentLog

  • 參考
模組:
AIPService

取得 Azure 資訊保護所追蹤之文件的保護資訊。

Azure 信息保護傳統和統一卷標用戶端都支援此 Cmdlet，其使用方式不同，如下所述。

語法

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

Description

Get-AIPServiceDocumentLog Cmdlet 會執行查詢，以傳回所追蹤文件的保護資訊。

傳回的資訊包括：

  • 如果有，則為文件內容識別碼，其中包含文件名稱。
  • Rights Management 擁有者和 Rights Management 簽發者。
  • 已授與存取權的使用者和群組。
  • 保護範本識別碼或保護檔的特定許可權。
  • 任何到期、離線存取或撤銷設定。

您可以指定要包含項目的開始時間和停止時間。 輸出會以PowerShell控制台中的PowerShell物件清單的形式傳回。

如需詳細資訊，請參閱 Rights Management 擁有者和 IRights 管理簽發者。

與統一標籤用戶端搭配使用時，查詢會以檔名稱、擁有者電子郵件或兩者為基礎。

您必須至少指定下列其中一個參數：

  • ContentName
  • 擁有者

提示

如果您使用 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 年 12 月受到保護。

範例 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 年 12 月受到保護。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ContentName

指定追蹤檔的完整名稱，包括擴展名。

如果您有統一卷標用戶端，則必須包含此參數，或 擁有者 參數，也可以包含兩者。

提示

如果您使用此參數，建議您也使用FromTime 和 ToTime 日期篩選條件來篩選傳回的數據。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-FromTime

將記錄檔的開始時間（含）指定為 DateTime 物件。 若要取得 DateTime 物件，請使用 get-Date Cmdlet 。 根據您的系統地區設定指定日期和時間。

如需詳細資訊，請輸入 Get-Help Get-Date。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Owner

指定保護檔的用戶電子郵件位址（Rights Management 簽發者或擁有者）。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ToTime

將記錄檔的停止時間（含）指定為 DateTime 物件。 若要取得 DateTime 物件，請使用 get-Date Cmdlet 。 根據您的系統地區設定指定日期和時間。

如需詳細資訊，請輸入 Get-Help Get-Date。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False