Get-AipServiceDocumentLog
取得 Azure 資訊保護所追蹤之文件的保護資訊。
Azure 信息保護傳統和統一卷標用戶端都支援此 Cmdlet，其使用方式不同，如下所述。
語法
Default (預設值)
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 管理簽發者。
與統一標籤用戶端搭配使用時，查詢會以檔名稱、擁有者電子郵件或兩者為基礎。
您必須至少指定下列其中一個參數：
- 內容名稱
- 擁有者
小提示
如果您使用
範例
範例 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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentName
指定追蹤檔的完整名稱，包括擴展名。
如果您有統一卷標用戶端，則必須包含此參數，或 擁有者 參數，也可以包含兩者。
小提示
如果您使用此參數，建議您也使用FromTime
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FromTime
將記錄檔的開始時間（含）指定為 DateTime 物件。 若要取得 DateTime 物件，請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。
如需詳細資訊，請輸入 Get-Help Get-Date。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Owner
指定保護檔的用戶電子郵件位址（Rights Management 簽發者或擁有者）。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ToTime
將記錄檔的停止時間（含）指定為 DateTime 物件。 若要取得 DateTime 物件，請使用 Get-Date Cmdlet。 根據您的系統地區設定指定日期和時間。
如需詳細資訊，請輸入 Get-Help Get-Date。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | 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。