次の方法で共有

Get-AipServiceUserLog

  • リファレンス
モジュール:
AIPService

Azure Information Protection からローカル ストレージに保護ユーザー ログをダウンロードします。

構文

Get-AipServiceUserLog
   -Path <String>
   [-FromDate <DateTime>]
   [-ToDate <DateTime>]
   [-ForDate <DateTime>]
   [-Force]
   [-NumberOfThreads <Int32>]
   [<CommonParameters>]

説明

Get-AipServiceUserLog コマンドレットは、保護ユーザー ログをローカル ストレージにダウンロードします。 ログ エントリをダウンロードするには、特定の日付または日付範囲を指定する必要があります。

これらのユーザー ログを取得するには、PowerShell を使用する必要があります。管理ポータルを使用してこのアクションを実行することはできません。

このコマンドを実行し、DateTime オブジェクトに対してのみ日付を指定すると、時刻は現地時刻の 00:00:00 であると見なされ、UTC に変換されます。

日付を含む時刻 (たとえば、-ForDate '2/1/2016 15:00:00') を指定すると、その日時は UTC に変換されます。 Get-AipServiceUserLog コマンドは、その UTC 期間のログを取得します。 使用状況ログは、"date" フィールド名に以前の日付 (UTC 時刻) の値が含まれている場合にのみ使用できます。 現在の日付の使用状況ログは使用できません。

ローカル時刻に必要な変換に対応するために、DateTime 値を変更する必要がある場合の例を参照してください。

保護の使用状況のログ記録と詳細な例については、「Azure In formation Protectionからの保護の使用状況のログ記録と分析」を参照してください。

例

例 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 で、UTC ではなく現地時刻の 2/2/2 のログをダウンロードすることを意味します。 日付に 12:00:00 の時刻を指定しなかった場合、ログには、2016 年 2 月 2 日の最初の 12 時間 (および前日の最後の 12 時間) のデータのみが含まれます。

例 4: UTC -offset 時刻変換を考慮して、日付範囲のユーザー ログを取得する

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 -offset 時刻の変換を考慮する必要がある場合がある方法を示しています。

米国ヒューストンにいます。つまり、コンピューターの現地時刻は UTC-6 であり、UTC ではなく現地時刻のログを 2016 年 2 月 2 日から 2/9 日までダウンロードする必要があります。

以前の日付と時刻を 18:00:00 に指定しなかった場合、2016 年 2 月 2 日の最初の 6 時間 (および終了日にはさらに 6 時間) のデータがログに表示されません。

パラメーター

-Force

このコマンドレットが、確認を求めずに、同じ日付または日付範囲の既存のログ ファイルを上書きすることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForDate

DateTime オブジェクトとして、ログ ファイルの日付 (および必要に応じて時刻) を指定します。

FromDate パラメーターを使用しない場合は、このパラメーターを使用します。

DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FromDate

DateTime オブジェクトとして、ログ ファイルの開始日 (および必要に応じて時刻) を指定します。

ForDate パラメーターを使用しない場合は、このパラメーターを使用します。

このパラメーターを指定しても、ToDateを指定しない場合、終了日はコマンドを実行した日になります。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NumberOfThreads

ログのダウンロードに使用するスレッドの数を指定します。

このパラメーターに使用できる値は 1 から 32 です。

既定値は 3 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

ログを保存するフォルダーの既存のパスを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ToDate

DateTime オブジェクトとして、ログ ファイルの終了日 (および必要に応じて時刻) を指定します。

必要に応じて、FromDate パラメーターを使用して特定の日付範囲を指定するときに、このパラメーターを指定します。 FromDate パラメーターを使用するときにこのパラメーターを指定しない場合、終了日はコマンドを実行した日になります。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False