Get-AipServiceTrackingLog
取得 Azure 資訊保護所保護檔的追蹤資訊。
Azure 資訊保護傳統和統一標籤用戶端都支援此 Cmdlet,其使用方式不同,如下所述。
語法
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 前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ContentId
指定您要傳回追蹤資料之檔的 contentID 值。
若要擷取特定檔的 contentID,請使用 Get-AipServiceDocumentLog Cmdlet。
類型: | String |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-FromTime
將記錄檔的開始時間 (包含) 指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請鍵入 Get-Help Get-Date
。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ToTime
將記錄檔的停止時間 (包含) 指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請鍵入 Get-Help Get-Date
。
類型: | DateTime |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UserEmail
指定使用者的電子郵件地址。 此 Cmdlet 會取得受保護或由具有此電子郵件地址之使用者存取之檔的追蹤資訊。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |