Get-RetentionPolicyTag

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Get-RetentionPolicyTag cmdlet을 사용하면 보존 태그의 설정을 검색할 수 있습니다.

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

Syntax

Get-RetentionPolicyTag
   [[-Identity] <RetentionPolicyTagIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Get-RetentionPolicyTag
   [-Mailbox <MailboxIdParameter>]
   [-OptionalInMailbox]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Description

보존 태그는 메시지나 폴더에 메시지 보존 설정을 적용하는 데 사용됩니다. 보존 태그에는 다음 세 가지 유형이 있습니다.

보존 정책 태그
기본 정책 태그
개인 태그

보존 정책 태그는 받은 편지함, 지운 편지함 등의 기본 폴더에 적용됩니다. 개인 태그는 사용자가 항목과 폴더에 태그를 지정하는 데 사용할 수 있습니다. 기본 정책 태그는 사용자가 태그를 적용하지 않았거나 위치한 폴더에서 상속되지 않은 모든 항목에 적용됩니다. Get-RetentionPolicyTag cmdlet은 지정된 태그에 대한 모든 설정을 표시합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-RetentionPolicyTag

이 예에서는 모든 보존 태그를 반환합니다.

예 2

Get-RetentionPolicyTag -IncludeSystemTags

이 예에서는 개인 태그와 기본 태그뿐 아니라 시스템 태그도 반환됩니다.

예 3

Get-RetentionPolicyTag "Consolidated Messenger"

이 예에서는 Consolidated Messenger 태그의 설정이 반환됩니다.

예 4

Get-RetentionPolicyTag -Types Inbox,All | Format-Table Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize

다음은 받은 편지함 및 모든 형식의 모든 보존 태그를 반환하고 결과를 Format-Table 명령으로 파이프하여 Name, Type, RetentionEnabled, AgeLimitForRetention 및 RetentionAction 속성을 표시하는 예제입니다.

매개 변수

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 매개 변수는 태그의 이름을 지정합니다.

Type:	RetentionPolicyTagIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSystemTags

IncludeSystemTags 스위치는 시스템 태그를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

Mailbox 매개 변수는 지정된 사서함에 적용되는 보존 정책에 할당된 보존 태그를 반환합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

이 매개 변수는 기본 정책 태그(DPT) 및 개인 태그만 반환합니다. 보존 정책 태그를 반환하지 않습니다.

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OptionalInMailbox

OptionalInMailbox 매개 변수는 Mailbox 매개 변수와 함께 사용하여 지정된 사서함에 할당된 모든 옵트인 보존 태그를 반환합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

옵트인 보존 태그는 Set-RetentionPolicyTag -Mailbox -OptionalInMailbox 명령을 사용하여 사서함에 명시적으로 할당된 개인 태그입니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Types

Types 매개 변수는 반환되는 보존 태그의 유형을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.

일정
연락처
DeletedItems
초안
받은 편지함
JunkEmail
저널
참고
보낼 편지함
SentItems
작업
전체
RssSubscriptions
ConversationHistory
Personal

매개 변수에서 쉼표로 구분하여 여러 값을 사용할 수 있습니다.

Type:	ElcFolderType[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

Share via