Get-UnifiedAuditLogRetentionPolicy
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Microsoft Defender ポータルまたはMicrosoft Purview コンプライアンス ポータルで監査ログ保持ポリシーのプロパティを表示するには、Get-UnifiedAuditLogRetentionPolicy コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-UnifiedAuditLogRetentionPolicy
[-Operation <String>]
[-RecordType <AuditRecordType>]
[-RetentionDuration <UnifiedAuditLogRetentionDuration>]
[-UserId <String>]
[<CommonParameters>]
説明
監査ログの保持ポリシーは、管理者とユーザーのアクティビティによって生成される監査ログの保持期間を指定するために使用されます。 監査ログ保持ポリシーでは、監査されたアクティビティの種類、アクティビティが実行される Microsoft 365 サービス、またはアクティビティを実行したユーザーに基づいて、保持期間を指定できます。 詳細については、「監査ログ保持ポリシーを管理する」を参照してください。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Defender ポータルのアクセス許可」または「Microsoft Purview コンプライアンス ポータルのアクセス許可」を参照してください。
例
例 1
Get-UnifiedAuditLogRetentionPolicy | Sort-Object -Property Priority | Format-List Priority,Name,Description,RecordTypes,Operations,UserIds,RetentionDuration
この例では、organization内のすべての監査ログ保持ポリシーの構成可能なプロパティを一覧表示します。 また、このコマンドでは、ポリシーの優先順位が最も高いものから最も低い順に一覧表示されます。
例 2
Get-UnifiedAuditLogRetentionPolicy -RecordType ExchangeItem | Format-List Name,Description,RecordTypes,Operations,UserIds,RetentionDuration,Priority
この例では、監査レコードに適用されるすべての監査ログ保持ポリシーの構成可能なプロパティの一覧を示します。レコードの種類は ExchangeItem です。
パラメーター
-Operation
適用対象: セキュリティ & コンプライアンス
Operations パラメーターは、ポリシーで指定された操作によって結果をフィルター処理します。 このパラメーターで使用可能な値の一覧については、「 監査されたアクティビティ」を参照してください。
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RecordType
適用対象: セキュリティ & コンプライアンス
RecordType パラメーターは、ポリシーで定義されているレコードの種類によって結果をフィルター処理します。 使用可能な値の詳細については、「 AuditLogRecordType」を参照してください。
パラメーターのプロパティ
| 型: | AuditRecordType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RetentionDuration
適用対象: セキュリティ & コンプライアンス
RetentionDuration パラメーターは、ポリシーで指定された保持期間によってポリシーの結果をフィルター処理します。 有効な値は次のとおりです。
- ThreeMonths
- SixMonths
- NineMonths
- TwelveMonths
- TenYears
パラメーターのプロパティ
| 型: | UnifiedAuditLogRetentionDuration |
| 規定値: | None |
| 指定可能な値: | ThreeMonths, SixMonths, NineMonths, TwelveMonths, TenYears |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserId
適用対象: セキュリティ & コンプライアンス
UserIds パラメーターは、ポリシーで指定されたユーザーの ID によってポリシーの結果をフィルター処理します。
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。