Get-AipServiceTrackingLog

Azure Information Protection によって保護されたドキュメントの追跡情報を取得します。

このコマンドレットは、Azure Information Protectionクラシック ラベル付けクライアントと統合ラベル付けクライアントの両方でサポートされており、以下で説明するように、使用法が異なります。

構文

Get-AipServiceTrackingLog
   -ContentId <Guid>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Get-AipServiceTrackingLog コマンドレットは、追跡対象のドキュメントに関する保護情報を返すクエリを実行します。

返される情報には、次のものが含まれます。

  • ドキュメントのコンテンツ ID(ドキュメント名が使用可能な場合)。
  • Rights Management 発行者。
  • ドキュメントにアクセスしたユーザー、いつ、どの場所からアクセスしたか。
  • ドキュメントを保護するために使用された保護テンプレート ID または特定の使用権限、およびアクセスが許可または拒否されたかどうか。
  • IsHiddenInfo プロパティ。常に false になります。 このプロパティは、追跡が無効になっているユーザーのイベントを非表示にするために使用されます。

ログに含めるエントリの開始時間と終了時間を指定できます。 出力は、PowerShell コンソールで PowerShell オブジェクトの一覧として返されます。

Get-AipServiceTracking コマンドレットは、指定された contentID を持つ保護されたドキュメントに関する追跡情報を返します。

特定のドキュメントの contentID を取得するには、 Get-AipServiceDocumentLog コマンドレットを使用します。

例 1: contentId を使用して特定のドキュメントの追跡データを取得する

PS C:\>Get-AipServiceDocumentLog -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

このコマンドは、特定のドキュメントの追跡情報を返すクエリを実行します。contentID 値は c03bf90c-6e40-4f3f-9ba0-2bcd77524b87 です。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-ContentId

追跡データを返すドキュメントの contentID 値を指定します。

特定のドキュメントの contentID を取得するには、 Get-AipServiceDocumentLog コマンドレットを使用します。

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

-FromTime

DateTime オブジェクトとしてログ ファイルの開始時刻 (両端を含む) を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 システム ロケールの設定に従って、日付と時刻を指定します。 詳細を表示するには「Get-Help Get-Date」を入力します。

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

-ToTime

DateTime オブジェクトとしてログ ファイルの停止時間 (両端を含む) を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 システム ロケールの設定に従って、日付と時刻を指定します。 詳細を表示するには「Get-Help Get-Date」を入力します。

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

-UserEmail

ユーザーの電子メール アドレスを指定します。 コマンドレットは、この電子メール アドレスを持つユーザーによって保護またはアクセスされたドキュメントの追跡情報を取得します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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