다음을 통해 공유

Get-UnifiedAuditLogRetentionPolicy

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Security & Compliance

이 cmdlet은 보안 & 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 & 준수 PowerShell을 참조하세요.

Get-UnifiedAuditLogRetentionPolicy cmdlet을 사용하여 Microsoft 365 Defender 포털 또는 Microsoft Purview 규정 준수 포털 감사 로그 보존 정책의 속성을 볼 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

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

Description

감사 로그 보존 정책은 관리자 및 사용자 활동에 의해 생성된 감사 로그에 대한 보존 기간을 지정하는 데 사용됩니다. 감사 로그 보존 정책은 감사된 활동 유형, 활동이 수행되는 Microsoft 365 서비스 또는 활동을 수행한 사용자에 따라 보존 기간을 지정할 수 있습니다. 자세한 내용은 감사 로그 보존 정책 관리를 참조하십시오.

보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 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
  • 12월
  • 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로 정책 결과를 필터링합니다.

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