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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentId

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

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

Type:String
Aliases:cf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FromTime

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ToTime

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserEmail

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False