다음을 통해 공유

New-ComplianceSearch

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Server 2016, Exchange Server 2019, Security & Compliance

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

New-ComplianceSearch cmdlet을 사용하여 Exchange Server 2016 이상 및 Microsoft Purview 규정 준수 포털 규정 준수 검색을 만듭니다. 이 cmdlet을 사용하여 검색 기준을 정의할 수 있습니다.

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

Syntax

New-ComplianceSearch
   [-Name] <String>
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Case <String>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-LogLevel <ComplianceJobLogLevel>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-StatusMailRecipients <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

준수 검색에는 적어도 하나의 위치가 필요합니다. 예를 들어 ExchangeLocation 매개 변수를 사용하는 사서함 또는 SharePointLocation 매개 변수를 사용하는 SharePoint 사이트입니다.

New-ComplianceSearch cmdlet을 사용하여 준수 검색을 만든 후에는 Start-ComplianceSearch cmdlet을 사용하여 검색을 실행합니다.

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

온-프레미스 Exchange에서 이 cmdlet은 사서함 검색 역할에서 사용할 수 있습니다. 기본적으로 이 역할은 검색 관리 역할 그룹에만 할당됩니다.

보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.

예제

예 1

New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"

이 예에서는 Finance Department라는 메일 그룹의 모든 구성원을 검색하는 Hold-Project X라는 새 준수 검색을 만듭니다. 검색에서 ContentMatchQuery 매개 변수가 사용되지 않으므로 사서함의 모든 항목이 검색됩니다.

예 2

New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"

이 예에서는 Research Department라는 메일 그룹의 모든 구성원을 검색하는 Hold-Tailspin Toys라는 새 준수 검색을 만듭니다. 검색에서 ContentMatchQuery 매개 변수가 사용되므로 쿼리와 일치하는 메시지만 검색됩니다.

예 3

New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true

이 예에서는 비활성 사서함을 검색하고 모든 항목을 사서함에 반환하는 AnnBeebe-InactiveMailbox라는 새 준수 검색을 만듭니다. 비활성 사서함을 검색하려면 마침표(".") 앞에 추가하는 비활성 사서함의 기본 SMTP 주소를 사용해야 합니다. 또한 검색에서 비활성 사서함의 존재 유효성을 검사하지 않도록 AllowNotFoundExchangeLocationsEnabled 매개 변수를 포함해야 합니다.

매개 변수

-AllowNotFoundExchangeLocationsEnabled

AllowNotFoundExchangeLocationsEnabled 매개 변수는 규정 준수 검색에 일반 사용자 사서함 이외의 사서함을 포함할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 계속하기 전에 검색에서 사서함의 존재 유효성을 검사하지 않습니다. 이 값은 일반 사서함으로 확인되지 않는 사서함을 검색하려는 경우에 필요합니다.
  • $false: 검색은 계속하기 전에 사서함의 존재 유효성을 검사하려고 시도합니다. 일반 사용자 사서함이 아닌 사서함을 지정하면 검색에 실패합니다. 이 값은 기본값입니다.

이 매개 변수 값의 영향을 받는 사서함 유형은 다음과 같습니다.

  • 비활성 사서함
  • Office 응용 프로그램을 사용하는 Exchange Online 라이선스가 없는 사용자
  • 게스트 사용자 365명 Microsoft
  • ID가 Microsoft 365 조직과 동기화되는 온-프레미스 사용자
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Case

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Case 매개 변수는 새 규정 준수 검색을 연결할 eDiscovery 표준 사례의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

eDiscovery Premium 사례와 연결된 규정 준수 검색을 만들려면 이 매개 변수를 사용할 수 없습니다.

Name 매개 변수에 공백이 포함된 경우 Case 매개 변수를 사용할 때 ExchangeLocation 매개 변수의 값이 지워집니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-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 2016, Exchange Server 2019, Security & Compliance

-ContentMatchQuery

ContentMatchQuery 매개 변수는 콘텐츠 검색 필터를 지정합니다.

이 매개 변수는 텍스트 검색 문자열 또는 KQL(키워드 쿼리 언어)를 사용하여 서식이 지정된 쿼리를 사용합니다. 자세한 내용은 KQL(키워드 쿼리 언어) 구문 참조 및 eDiscovery에 대한 키워드 쿼리 및 검색 조건을 참조하세요.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Description

Description 매개 변수는 준수 검색에 대한 선택적 설명을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocation

ExchangeLocation 매개 변수는 포함할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

  • 일반 사용자 사서함. 다른 유형의 사서함(예: 비활성 사서함 또는 365명의 게스트 사용자 Microsoft)을 포함하는 것은 AllowNotFoundExchangeLocationsEnabled 매개 변수에 의해 제어됩니다.
  • 사서함
  • 모든 사서함에 대한 모두 값입니다. 이 값 자체만 사용할 수 있습니다.

사서함 또는 메일 그룹을 지정하려면 전자 메일 주소를 사용합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocationExclusion

이 매개 변수는 온-프레미스 Exchange에서만 작동합니다.

이 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용할 때 제외할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

  • ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
  • 사서함

사서함 또는 메일 그룹을 지정하려면 전자 메일 주소를 사용합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Force

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

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-HoldNames

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

HoldNames 매개 변수는 지정된 eDiscovery 케이스에서 보류된 콘텐츠 위치가 검색되도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다. 또한 Case 매개 변수를 사용하여 eDiscovery 케이스의 이름을 지정해야 합니다.

또한 콘텐츠 위치가 쿼리 기반 케이스 보류 상태가 될 경우 이 준수 검색을 실행하면 보류 중인 항목만 검색됩니다. 예를 들어 사용자가 특정 날짜 이전에 전송되었거나 만들어진 항목을 보존하는 쿼리 기반 케이스 보류 상태가 될 경우 이 준수 검색에 지정된 검색 조건을 사용하면 해당 항목만 검색됩니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeOrgContent

{{ Fill IncludeOrgContent Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeUserAppContent

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

IncludeUserAppContent 매개 변수는 조직에 일반 Microsoft 365 사용자 계정이 없는 사용자의 클라우드 기반 스토리지 위치를 검색하도록 지정합니다. 이러한 유형의 사용자에는 Office 응용 프로그램을 사용하는 Exchange Online 라이선스가 없는 사용자, Microsoft 게스트 사용자, ID가 Microsoft 365 조직과 동기화된 온-프레미스 사용자가 포함됩니다. 유효한 값은 다음과 같습니다.

  • $true: ExchangeLocation 매개 변수에 지정된 사용자의 클라우드 기반 스토리지 위치가 검색에 포함됩니다. ExchangeLocation 매개 변수에 All 값을 사용하는 경우 게스트 또는 온-프레미스 사용자의 클라우드 기반 스토리지 위치가 검색에 포함됩니다.
  • $false: ExchangeLocation 매개 변수에 지정된 사용자의 클라우드 기반 스토리지 위치는 검색에 포함되지 않습니다. 이 값은 기본값입니다.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Language

Language 매개 변수는 준수 검색의 언어를 지정합니다.

이 매개 변수에 대한 유효한 입력은 Microsoft .NET Framework CultureInfo 클래스에서 지원되는 문화권 코드 값입니다. 예를 들어 덴마크어의 경우 da-DK, 일본어의 경우 ja-JP입니다. 자세한 내용은 CultureInfo 클래스를 참조하세요.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-LogLevel

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

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

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

-Name

Name 매개 변수는 규정 준수 검색의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

Case 매개 변수를 사용하려는 경우 이 매개 변수 값에 공백을 사용하지 마세요. Name 매개 변수에 공백이 포함된 경우 Case 매개 변수를 사용할 때 ExchangeLocation 매개 변수의 값이 지워집니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-PublicFolderLocation

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

PublicFolderLocation 매개 변수는 검색에 모든 공용 폴더를 포함하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RefinerNames

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocation

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

SharePointLocation 매개 변수는 포함할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별하거나 모든 사이트를 포함하기 위해 All 값을 사용할 수 있습니다.

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

-SharePointLocationExclusion

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StatusMailRecipients

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

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

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

-WhatIf

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance