Get-UnifiedAuditLogRetentionPolicy

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Security & Compliance

このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。詳細については、「セキュリティ & コンプライアンス PowerShell」を参照してください。

Microsoft 365 Defender ポータルまたはMicrosoft Purview コンプライアンスポータルで監査ログ保持ポリシーのプロパティを表示するには、Get-UnifiedAuditLogRetentionPolicy コマンドレットを使用します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-UnifiedAuditLogRetentionPolicy
   [-Operation <String>]
   [-RecordType <AuditRecordType>]
   [-RetentionDuration <UnifiedAuditLogRetentionDuration>]
   [-UserId <String>]
   [<CommonParameters>]

説明

監査ログの保持ポリシーは、管理者とユーザーのアクティビティによって生成される監査ログの保持期間を指定するために使用されます。監査ログ保持ポリシーでは、監査されたアクティビティの種類、アクティビティが実行されるMicrosoft 365 サービス、またはアクティビティを実行したユーザーに基づいて、保持期間を指定できます。詳細については、「監査ログ保持ポリシーを管理する」を参照してください。

セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。詳細については、「Microsoft 365 Defender ポータルのアクセス許可」または「Microsoft Purview コンプライアンスポータルのアクセス許可」を参照してください。

例

例 1

Get-UnifiedAuditLogRetentionPolicy | Sort-Object -Property Priority | Format-List Priority,Name,Description,RecordTypes,Operations,UserIds,RetentionDuration

この例では、組織内のすべての監査ログ保持ポリシーの構成可能なプロパティの一覧を示します。また、このコマンドでは、ポリシーの優先順位が最も高いものから最も低い順に一覧表示されます。

例 2

Get-UnifiedAuditLogRetentionPolicy -RecordType ExchangeItem | Format-List Name,Description,RecordTypes,Operations,UserIds,RetentionDuration,Priority

この例では、監査レコードに適用されるすべての監査ログ保持ポリシーの構成可能なプロパティの一覧を示します。レコードの種類は ExchangeItem です。

パラメーター

-Operation

Operations パラメーターは、ポリシーで指定された操作によって結果をフィルター処理します。このパラメーターで使用可能な値の一覧については、「監査されたアクティビティ」を参照してください。

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RecordType

RecordType パラメーターは、ポリシーで定義されているレコードの種類によって結果をフィルター処理します。使用可能な値の詳細については、「 AuditLogRecordType」を参照してください。

Type:	AuditRecordType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionDuration

RetentionDuration パラメーターは、ポリシーで指定された保持期間によってポリシーの結果をフィルター処理します。有効な値は次のとおりです。

ThreeMonths
SixMonths
NineMonths
TwelveMonths
TenYears

Type:	UnifiedAuditLogRetentionDuration
Accepted values:	ThreeMonths, SixMonths, NineMonths, TwelveMonths, TenYears
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-UserId

UserIds パラメーターは、ポリシーで指定されたユーザーの ID によってポリシーの結果をフィルター処理します。