Get-AipServiceUserLog
將保護用戶記錄從 Azure 資訊保護 下載到本機記憶體。
語法
Get-AipServiceUserLog
-Path <String>
[-FromDate <DateTime>]
[-ToDate <DateTime>]
[-ForDate <DateTime>]
[-Force]
[-NumberOfThreads <Int32>]
[<CommonParameters>] Description
Get-AipServiceUserLog Cmdlet 會將保護用戶記錄下載到本機記憶體。 您必須指定特定日期或日期範圍，才能下載記錄專案。
您必須使用PowerShell來取得這些用戶記錄;您無法使用管理入口網站來執行此動作。
當您執行此命令並只指定 DateTime 物件的日期時，時間會假設在本機時間是 00：00：00，然後轉換成 UTC。
例如，當您指定日期 (的時間時， -ForDate '2/1/2016 15：00：00') ，該日期和時間會轉換成 UTC。 Get-AipServiceUserLog 命令接著會取得該 UTC 時間週期的記錄。 只有在 「date」 功能變數名稱包含上一個日期的值， (UTC 時間) 時，才能使用使用量記錄。 目前日期的使用量記錄無法使用。
請參閱範例，以瞭解您可能需要如何變更 DateTime 值，以配合當地時間所需的轉換。
如需保護使用方式記錄和逐步範例的詳細資訊，請參閱 記錄和分析來自 Azure 的保護使用方式保護。
範例
範例 1：取得日期範圍的用戶記錄
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10此命令會下載在 2015/12/12 和 2015/12/15 之間建立的用戶記錄， (UTC 時間) 至 C：\Logs 資料夾。
此命令會使用10個線程來下載記錄。
範例 2：取得日期的用戶記錄
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'此命令會將 2015/12/5 的用戶記錄 (以 UTC 時間) 下載至 C：\Logs 資料夾。
範例 3：取得日期的用戶記錄，並考慮 UTC +位移時間轉換
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'此命令示範在將使用者記錄檔下載到 C：\Logs 資料夾之前，您可能需要考慮從當地時間進行 UTC +位移時間轉換。
您位於紐西蘭，這表示計算機的當地時間是UTC+12，而且您想要在當地時間下載2/2/2/2的記錄，而不是UTC。 如果您未指定日期為 12：00：00 的時間，則記錄只會包含前 12 小時 2/2/2 的數據， (和前一天的過去 12 小時) 。
範例 4：取得日期範圍的用戶記錄，並考慮 UTC 位移時間轉換
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'此命令說明在將用戶記錄下載到 C：\Logs 資料夾之前，您可能需要考慮從當地時間進行 UTC 位移時間轉換。
您位於美國，這表示計算機的當地時間是UTC-6，而且您想要從2016年2月2日到2/9/2016下載記錄，而不是UTC。
如果您未指定前一個日期和時間 18：00：00，則您的記錄會在 2/2/2/2016 的前 6 小時遺失數據，您的當地時間 (以及結束日期) 的額外 6 小時。
參數
-Force
指出此 Cmdlet 會覆寫，而不提示確認，現有記錄檔的日期或日期範圍。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForDate
指定日期 (，並選擇性地指定記錄檔的時間) 做為 DateTime 物件。
當您不使用 FromDate 參數時，請使用此參數。
若要取得 DateTime 物件，請使用 Get-Date Cmdlet。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FromDate
指定記錄檔的開始日期 (，並選擇性地指定記錄檔的時間) 做為 DateTime 物件。
當您不使用 ForDate 參數時，請使用此參數。
如果您指定此參數，但不是 ToDate，結束日期就是您執行命令的日期。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-NumberOfThreads
指定要用來下載記錄的線程數目。
此參數可接受的值為：1-32。
預設值是 3。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Path
指定要在其中儲存記錄之資料夾的現有路徑。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ToDate
指定 (的停止日期，並選擇性地指定記錄檔的時間) 做為 DateTime 物件。
或者，當您使用 FromDate 參數來指定特定日期範圍時，請指定此參數。 如果您在使用 FromDate 參數時未指定此參數，結束日期就是您執行命令的日期。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |