Get-AppRetentionCompliancePolicy
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Get-AppRetentionCompliancePolicy 사용하여 앱 보존 규정 준수 정책을 봅니다. 앱 보존 & 레이블 지정 정책은 정책을 scope 관리하는 새로운 방법을 대상으로 합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-AppRetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-RetentionRuleTypes]
[<CommonParameters>]
Description
*-AppRetentionCompliance* cmdlet은 적응형 정책 범위가 있는 정책 및 Teams 채팅, Teams 채널 및 비공개 채널, Viva Engage 채팅 및 Viva Engage 커뮤니티 메시지를 포함하는 모든 정적 정책에 사용됩니다. 결국 대부분의 보존 위치 및 정책 유형에 대해 이러한 cmdlet을 사용합니다. *-RetentionCompliance* cmdlet은 주로 Exchange 및 SharePoint 위치를 계속 지원합니다. *-AppRetentionCompliance* cmdlet을 사용하여 만든 정책의 경우 포함된 모든 워크로드에 대해 포함되거나 제외된 범위 목록만 설정할 수 있습니다. 즉, 워크로드당 하나의 정책을 만들어야 할 수 있습니다.
이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
Get-AppRetentionCompliancePolicy | Format-Table Name,GUID
이 예제에서는 모든 앱 보존 규정 준수 정책의 요약 목록을 반환합니다.
예 1
Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"
이 예제에서는 Contoso Viva Engage 라는 앱 보존 규정 준수 정책에 대한 자세한 정보를 반환합니다.
매개 변수
-DistributionDetail
적용 가능: 보안 & 규정 준수
DistributionDetail 스위치가 DistributionResults 속성에 자세한 정책 배포 정보를 반환합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ErrorPolicyOnly
적용 가능: 보안 & 규정 준수
{{ Fill ErrorPolicyOnly Description }}
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: 보안 & 규정 준수
Identity 매개 변수는 보려는 앱 보존 규정 준수 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- GUID
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | PolicyIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-RetentionRuleTypes
적용 가능: 보안 & 규정 준수
RetentionRuleTypes 스위치는 결과에서 RetentionRuleTypes 속성의 값을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
RetentionRuleTypes 속성을 보려면 명령을 서식 cmdlet으로 파이프해야 합니다. 예를 들면 Get-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes와 같습니다. RetentionRuleTypes 스위치를 사용하지 않으면 값이 비어 있는 것처럼 보입니다.
매개 변수 속성
| 형식: | SwitchParameter |
| 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를 참조하세요.