共用方式為

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"

此命令會執行查詢，並以 2020 年 12 月保護的檔案名 test.docx，傳回儲存在租使用者上之所有追蹤檔的保護資訊。

範例 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

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

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

提示

如果您使用此參數，建議您也使用 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