Search-Mailbox

참조

모듈:: ExchangePowerShell

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

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

Search-Mailbox cmdlet을 사용하면 사서함을 검색하고 결과를 지정된 대상 사서함에 복사하거나 원본 사서함에서 메시지를 삭제할 수 있습니다.

참고: 클라우드 기반 환경에서는 New-ComplianceSearch 및 관련 eDiscovery cmdlet을 위해 Search-Mailbox cmdlet이 더 이상 사용되지 않습니다.

기본적으로 Search-Mailbox 사서함 검색 또는 사서함 가져오기 내보내기 역할에서만 사용할 수 있으며 이러한 역할은 역할 그룹에 할당되지 않습니다. 이 cmdlet을 사용하려면 역할 그룹(예: 조직 관리 역할 그룹)에 역할 중 하나 또는 둘 다를 추가해야 합니다. 사서함 가져오기 내보내기 역할만 DeleteContent 매개 변수에 액세스할 수 있습니다. 역할 그룹에 역할을 추가하는 방법에 대한 자세한 내용은 역할 그룹에 역할 추가를 참조하세요.

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

Syntax

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-EstimateResultOnly]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      -TargetFolder <String>
      -TargetMailbox <MailboxIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-LogLevel <LoggingLevel>]
      [-LogOnly]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Description

Search-Mailbox cmdlet을 사용하여 지정된 사서함의 메시지를 검색하고 다음 작업을 수행할 수 있습니다.

지정된 대상 사서함으로 메시지를 복사합니다.
원본 사서함에서 메시지를 삭제합니다. 메시지를 삭제하려면 사서함 가져오기 내보내기 관리 역할이 할당되어 있어야 합니다.
단일 항목 복원을 수행하여 사용자의 복구 가능한 항목 폴더에서 항목을 복원합니다.
복구 가능한 항목 하드 할당량에 도달할 때 사서함의 복구 가능한 항목 폴더를 정리합니다.

예제

예 1

Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full

이 예에서는 Joe Healy의 사서함을 검색하고 검색 결과를 DiscoveryMailbox의 JoeHealy-ProjectHamilton 폴더에 복사합니다.

예 2

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

이 예에서는 April Stewart의 사서함에서 제목에 "Your bank statement" 구가 포함된 메시지를 검색하고 관리자 사서함의 SearchAndDeleteLog 폴더에 결과를 로깅합니다. 메시지는 대상 사서함에 복사되지 않습니다.

예 3

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent

이 예에서는 April Stewart의 사서함에서 제목에 "Your bank statement" 구가 포함된 메시지를 검색하고 원본 사서함에서 메시지를 삭제합니다. 이 DeleteContent 스위치를 사용하려면 사서함 가져오기 내보내기 관리 역할이 할당되어 있어야 합니다.

예 4

Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full

이 예에서는 조직의 모든 사서함에서 "election", "candidate" 또는 "vote"라는 단어가 포함된 메시지를 검색합니다. 검색 결과는 AllMailboxes-Election 폴더의 사서함 검색에 복사됩니다.

매개 변수

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
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

-DeleteContent

참고: 이 스위치를 사용하려면 사서함 가져오기 내보내기 관리 역할이 할당되어야 합니다. 기본적으로 이 역할은 모든 역할 그룹(조직 관리 포함)에 할당되지 않습니다. 일반적으로 기본 설정 또는 사용자 지정 역할 그룹에 역할을 할당합니다.

DeleteContent 스위치는 검색에서 반환된 메시지가 원본 사서함에서 영구 삭제되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

TargetMailbox 매개 변수와 함께 이 스위치를 사용하면 메시지가 대상 사서함에 복사되고 원본 사서함에서 제거됩니다. 검색에 대한 로깅 수준을 Basic 또는 Full로 설정한 경우 로그를 저장할 대상 사서함 및 대상 폴더를 지정해야 합니다. 대상 사서함으로 복사하지 않고 원본 사서함에서 메시지를 삭제하려면 TargetMailbox, TargetFolder 및 LogLevel 매개 변수를 지정하지 않아야 합니다.

DeleteContent 스위치를 사용하여 콘텐츠를 삭제하기 전에 예 2와 같이 LogOnly 매개 변수를 사용하여 검색 매개 변수를 테스트하는 것이 좋습니다.

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

-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

-DoNotIncludeArchive

DoNotIncludeArchive 스위치는 사용자의 보관 사서함을 검색에 포함하지 않도록 지정합니다. 이 스위치에는 값을 지정할 필요가 없습니다.

기본적으로 보관 사서함은 항상 검색됩니다.

Exchange Online 사서함에 대해 자동 확장 보관을 사용하도록 설정하면 사용자의 기본 보관 사서함만 검색됩니다. 보조 보관 사서함은 검색에 포함되지 않습니다.

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

-EstimateResultOnly

EstimateResultOnly 스위치는 메시지의 총 수와 크기에 대한 추정치만 반환합니다. 메시지는 대상 사서함에 복사되지 않습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

TargetMailbox 매개 변수와 함께 이 스위치를 사용할 수 없습니다.

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

-Force

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

DeleteContent 스위치를 사용하여 메시지를 영구적으로 삭제할 때 이 스위치를 사용하여 확인 프롬프트를 숨깁니다.

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

-Identity

Identity 매개 변수는 검색할 사서함의 ID를 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

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

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

-IncludeUnsearchableItems

IncludeUnsearchableItems 스위치에는 검색 결과에서 Exchange Search에서 인덱싱할 수 없는 항목이 포함됩니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-LogLevel

LogLevel 매개 변수는 검색 로깅 수준을 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.

표시 안 함: 로그가 유지되지 않습니다.
기본: 쿼리 및 쿼리를 실행한 사람에 대한 기본 정보가 유지됩니다.
전체: 기본 로그 수준에서 유지되는 정보 외에도 전체 로그 수준은 검색 결과의 전체 목록을 추가합니다.

기본 로그 수준은 Basic입니다.

이 매개 변수를 포함하면 전자 메일 메시지가 만들어지고 TargetMailbox 매개 변수로 지정된 사서함으로 전송됩니다. 로그 파일(Search Results.csv이라는 CSV 형식 파일)은 이 전자 메일 메시지에 첨부되며 TargetFolder 매개 변수로 지정된 폴더에 있습니다. 로그 파일에는 Search-Mailbox cmdlet을 실행할 때 검색 결과에 포함된 각 메시지에 대한 행이 포함되어 있습니다.

Type:	LoggingLevel
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

-LogOnly

LogOnly 스위치는 검색을 수행하지만 로그만 생성합니다. 검색에서 반환된 메시지는 대상 사서함에 복사되지 않습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

로깅 수준은 LogLevel 매개 변수를 사용하여 지정합니다.

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

-SearchDumpster

SearchDumpster 스위치는 검색에 복구 가능한 항목 폴더를 포함할지 여부를 지정합니다. 복구 가능한 항목 폴더는 지운 편지함 폴더에서 삭제된 항목 또는 사서함 데이터베이스에서 제거될 때까지 영구 삭제된 항목을 저장합니다.

기본적으로 복구 가능한 항목 폴더는 항상 검색에 포함됩니다. 검색에서 복구 가능한 항목 폴더를 제외하려면 정확한 구문 -SearchDumpster:$false인 를 사용합니다.

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

-SearchDumpsterOnly

SearchDumpsterOnly 스위치는 지정된 사서함의 복구 가능한 항목 폴더만 검색되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

복구 가능한 항목 폴더는 지운 편지함 폴더에서 삭제된 항목 또는 사서함 데이터베이스에서 제거될 때까지 영구 삭제된 항목을 저장합니다.

또한 이 스위치를 DeleteContent 스위치와 함께 사용하여 복구 가능한 항목 폴더에서 메시지를 삭제하고 폴더 크기를 줄일 수 있습니다.

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

-SearchQuery

SearchQuery 매개 변수는 KQL(키워드 쿼리 언어)을 사용하여 서식이 지정된 검색 문자열 또는 쿼리를 지정합니다. Exchange의 KQL에 대한 자세한 내용은 In-Place eDiscovery에 대한 메시지 속성 및 검색 연산자를 참조하세요.

이 매개 변수를 비워 두면 모든 메시지가 반환됩니다.

참고: 검색 쿼리가 지정된 경우 Search-Mailbox cmdlet은 사서함당 최대 10000개 결과를 반환합니다.

Type:	String
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

-TargetFolder

TargetFolder 매개 변수는 대상 사서함에 검색 결과가 저장되는 폴더 이름을 지정합니다. 폴더는 실행 시 대상 사서함에 만들어집니다.

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

-TargetMailbox

TargetMailbox 매개 변수는 검색 결과가 복사되는 대상 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

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

TargetFolder 매개 변수와 함께 이 매개 변수를 사용해야 합니다. EstimateResultOnly 스위치와 함께 이 매개 변수를 사용할 수 없습니다.

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

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Aliases:	wi
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은 데이터를 반환하지 않습니다.