Get-AipServiceDocumentLog

リファレンス

モジュール:: AIPService

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

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

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

-ContentName

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

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

ヒント

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

-Owner

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

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

-ToTime

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