Get-AipServiceTrackingLog
取得 Azure 資訊保護所保護文件的追蹤資訊。
Azure 信息保護傳統和統一卷標用戶端都支援此 Cmdlet,其使用方式不同,如下所述。
語法
Default (預設值)
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 之受保護文件的追蹤資訊。
若要擷取特定文件的內容識別碼,請使用 Get-AipServiceDocumentLog Cmdlet。
範例
範例 1:使用特定檔的 contentId 取得追蹤數據
PS C:\>Get-AipServiceDocumentLog -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87
此命令會執行查詢以傳回特定文件的追蹤資訊,其 contentID 值為 c03bf90c-6e40-4f3f-9ba0-2bcd77524b87
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentId
指定您要傳回追蹤資料的檔 contentID 值。
若要擷取特定文件的內容識別碼,請使用 Get-AipServiceDocumentLog Cmdlet。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FromTime
將記錄檔的開始時間(含)指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請輸入 Get-Help Get-Date。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ToTime
將記錄檔的停止時間(含)指定為 DateTime 物件。 若要取得 DateTime 物件,請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。 如需詳細資訊,請輸入 Get-Help Get-Date。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UserEmail
指定使用者的電子郵件位址。 Cmdlet 會取得受保護的文件追蹤資訊,或由具有此電子郵件地址的使用者存取。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。