Get-UnifiedAuditLogRetentionPolicy

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

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

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

構文

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

説明

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

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

例 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RecordType

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

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

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

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

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

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

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

入力

出力