Get-UnifiedAuditLogRetentionPolicy
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Get-UnifiedAuditLogRetentionPolicy cmdlet을 사용하여 Microsoft Defender 포털 또는 Microsoft Purview 규정 준수 포털 감사 로그 보존 정책의 속성을 볼 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-UnifiedAuditLogRetentionPolicy
[-Operation <String>]
[-RecordType <AuditRecordType>]
[-RetentionDuration <UnifiedAuditLogRetentionDuration>]
[-UserId <String>]
[<CommonParameters>]
Description
감사 로그 보존 정책은 관리자 및 사용자 활동에 의해 생성된 감사 로그에 대한 보존 기간을 지정하는 데 사용됩니다. 감사 로그 보존 정책은 감사된 활동 유형, 활동이 수행되는 Microsoft 365 서비스 또는 활동을 수행한 사용자에 따라 보존 기간을 지정할 수 있습니다. 자세한 내용은 감사 로그 보존 정책 관리를 참조하십시오.
이 cmdlet을 사용하려면 보안 및 준수 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 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RecordType
적용 가능: 보안 & 규정 준수
RecordType 매개 변수는 정책에 정의된 레코드 형식으로 결과를 필터링합니다. 사용 가능한 값에 대한 자세한 내용은 AuditLogRecordType을 참조하세요.
매개 변수 속성
| 형식: | AuditRecordType |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RetentionDuration
적용 가능: 보안 & 규정 준수
RetentionDuration 매개 변수는 정책에 지정된 보존 기간을 기준으로 정책 결과를 필터링합니다. 유효한 값은 다음과 같습니다.
- ThreeMonths
- SixMonths
- NineMonths
- 12월
- TenYears
매개 변수 속성
| 형식: | UnifiedAuditLogRetentionDuration |
| Default value: | None |
| 허용되는 값: | ThreeMonths, SixMonths, NineMonths, TwelveMonths, TenYears |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserId
적용 가능: 보안 & 규정 준수
UserIds 매개 변수는 정책에 지정된 사용자의 ID로 정책 결과를 필터링합니다.
Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.