次の方法で共有


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 パラメーターを含める必要があります。または、両方を含めることができます。

先端

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

型: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