Get-AipServiceDocumentLog
Azure Information Protection によって追跡されるドキュメントに関する保護情報を取得します。
このコマンドレットは、Azure Information Protection クラシック クライアントと統合ラベル付けクライアントの両方でサポートされており、以下で説明するように、使用方法が異なります。
構文
Default (既定)
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 つを指定する必要があります。
- コンテンツ名
- 所有者
ヒント
例
例 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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ContentName
ファイル拡張子を含む、追跡対象のドキュメントの完全な名前を指定します。
統合ラベル付けクライアントがある場合は、このパラメーターまたは Owner パラメーターを含める必要があります。または、両方を含めることができます。
ヒント
このパラメーターを使用する場合は、
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FromTime
DateTime オブジェクトとして、ログ ファイルの開始時刻 (含む) を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 システムロケールの設定に従って日付と時刻を指定します。
詳細については、「Get-Help Get-Date」と入力します。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Owner
ドキュメントを保護したユーザー (Rights Management の発行者または所有者) の電子メール アドレスを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ToTime
DateTime オブジェクトとして、ログ ファイルの停止時刻 (含む) を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。 システムロケールの設定に従って日付と時刻を指定します。
詳細については、「Get-Help Get-Date」と入力します。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。