次の方法で共有


Get-AipServiceDocumentLog

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

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

構文

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

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

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

  • ドキュメントのコンテンツ ID(ドキュメント名が使用可能な場合)。
  • Rights Management の所有者と Rights Management の発行者。
  • アクセス権が付与されたユーザーとグループ。
  • ドキュメントを保護する保護テンプレート ID または特定の使用権限。
  • 有効期限、オフライン アクセス、または失効設定。

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

詳細については、「 Rights Management の所有者」および「IRights Management 発行者」を参照してください。

統合ラベル付けクライアントで使用する場合、クエリはドキュメント名、所有者の電子メール、またはその両方に基づいています。

次のパラメーターの少なくとも 1 つを指定する必要があります。

  • ContentName
  • 所有者

ヒント

ContentName パラメーターを使用する場合は、FromTime パラメーターと ToTime パラメーターを使用して、コンテンツを特定の期間にフィルター処理することをお勧めします。

例 1: (統合ラベル付けクライアントのみ) 特定の期間に保護された特定のファイル名を持つ追跡対象のすべてのドキュメントに関する保護情報を取得する

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

このコマンドは、クエリを実行し、2020 年 12 月に保護されたファイル名 test.docxを使用して、テナントに格納されているすべての追跡対象ドキュメントに関する保護情報を返します。

例 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

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

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

-ContentName

ファイル拡張子を含む、追跡対象のドキュメントの完全な名前を指定します。

統合ラベル付けクライアントがある場合は、このパラメーターまたは Owner パラメーターを含める必要があります。または、両方を含めることができます。

ヒント

このパラメーターを使用する場合は、 FromTimeToTime の日付フィルターを使用して、返されるデータをフィルター処理することをお勧めします。

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

-FromTime

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

詳細を表示するには「Get-Help Get-Date」を入力します。

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

-Owner

ドキュメントを保護したユーザー (Rights Management の発行者または所有者) の電子メール アドレスを指定します。

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

-ToTime

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

詳細を表示するには「Get-Help Get-Date」を入力します。

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

-WhatIf

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

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