Get-AipServiceTrackingLog

取得 Azure 資訊保護所保護檔的追蹤資訊。

Azure 資訊保護傳統和統一標籤用戶端都支援此 Cmdlet,其使用方式不同,如下所述。

Syntax

Get-AipServiceTrackingLog
   -ContentId <Guid>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Get-AipServiceTrackingLog Cmdlet 會執行查詢,以傳回有關追蹤檔的保護資訊。

傳回的資訊包括:

  • 如果有檔案名稱,則為檔內容識別碼。
  • Rights Management 簽發者。
  • 存取檔、時間及位置的使用者。
  • 使用哪些保護範本識別碼或特定許可權來保護檔,以及是否授與或拒絕存取權。
  • IsHiddenInfo屬性,一律為false。 這個屬性是用來隱藏停用追蹤的使用者事件。

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

Get-AipServiceTracking Cmdlet 會傳回具有指定 contentID 之受保護檔的追蹤資訊。

若要擷取特定檔的 contentID,請使用 Get-AipServiceDocumentLog Cmdlet。

範例

範例 1:使用其 contentId 取得特定檔的追蹤資料

PS C:\>Get-AipServiceDocumentLog -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

此命令會執行查詢以傳回特定檔的追蹤資訊,其 contentID 值為 c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

參數

-Confirm

在執行 Cmdlet 前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ContentId

指定您要傳回追蹤資料之檔的 contentID 值。

若要擷取特定檔的 contentID,請使用 Get-AipServiceDocumentLog Cmdlet。

Type:String
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FromTime

將記錄檔的開始時間 (包含) 指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請鍵入 Get-Help Get-Date

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ToTime

將記錄檔的停止時間 (包含) 指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請鍵入 Get-Help Get-Date

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserEmail

指定使用者的電子郵件地址。 此 Cmdlet 會取得受保護或由具有此電子郵件地址之使用者存取之檔的追蹤資訊。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False