다음을 통해 공유

Set-ComplianceSearch

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

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

Set-ComplianceSearch cmdlet을 사용하여 Exchange Server 2016 이상 및 Microsoft Purview 규정 준수 포털 실행하지 않는 규정 준수 검색을 수정합니다.

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

Syntax

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

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

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

예제

예 1

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

다음은 Project X라는 기존 규정 준수 검색을 변경하는 예제입니다. Exchange 검색 범위가 모든 사서함으로 변경됩니다.

예 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

이 예제에서는 Microsoft Purview 규정 준수 포털 eDiscovery 사례와 연결된 기존 규정 준수 검색을 변경합니다. 검색 범위가 선택한 사서함 및 SharePoint 사이트 검색에서 eDiscovery 케이스에 보류된 모든 콘텐츠 위치 검색으로 변경됩니다.

예 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

다음은 기존 규정 준수 검색의 언어 설정을 중국어로 변경하는 예제입니다.

검색 쿼리(ContentMatchQuery 매개 변수에 지정됨)에서 영어 이외의 키워드를 사용하는 경우 언어 설정을 변경해야 할 수 있습니다.

매개 변수

-AddExchangeLocation

AddExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

  • 일반 사용자 사서함. 다른 유형의 사서함(예: 비활성 사서함 또는 365명의 게스트 사용자 Microsoft)을 포함하는 것은 AllowNotFoundExchangeLocationsEnabled 매개 변수에 의해 제어됩니다.
  • 사서함

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

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

-AddExchangeLocationExclusion

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

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

  • 일반 사용자 사서함. 다른 유형의 사서함(예: 비활성 사서함 또는 365명의 게스트 사용자 Microsoft)을 포함하는 것은 AllowNotFoundExchangeLocationsEnabled 매개 변수에 의해 제어됩니다.
  • 사서함

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

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

-AddSharePointLocation

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

AddSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에 추가할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

-AddSharePointLocationExclusion

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

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

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

-AllowNotFoundExchangeLocationsEnabled

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

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

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

  • 비활성 사서함
  • Office 응용 프로그램을 사용하는 Exchange Online 라이선스가 없는 사용자
  • 게스트 사용자
  • 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

-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 매개 변수에 의해 제어됩니다.
  • 사서함
  • 모든 사서함에 대한 모두 값입니다. 이 값 자체만 사용할 수 있습니다.

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

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

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

-ExchangeLocationExclusion

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

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

  • 일반 사용자 사서함. 다른 유형의 사서함(예: 비활성 사서함 또는 365명의 게스트 사용자 Microsoft)을 포함하는 것은 AllowNotFoundExchangeLocationsEnabled 매개 변수에 의해 제어됩니다.
  • 사서함

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

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 값을 사용합니다. eDiscovery 케이스와 관련된 준수 검색에 대해서만 이 매개 변수를 사용할 수 있습니다.

규정 준수 검색의 콘텐츠 위치에 사서함이 포함된 경우 ExchangeLocation 매개 변수를 값 $null 사용해야 합니다. 마찬가지로 규정 준수 검색에 SharePoint 사이트가 포함된 경우 값 $null SharePointLocation 매개 변수도 사용해야 합니다.

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

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

-Identity

Identity 매개 변수는 수정할 준수 검색을 지정합니다.

이 매개 변수를 사용할 경우 Identity 매개 변수가 필요하지만 해당 값은 무시됩니다. 예를 들어 Identity 매개 변수에 대해 000 값을 사용합니다.

  • 이름
  • JobRunId(GUID)

JobRunId(GUID)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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: Exchange 위치 매개 변수에 지정된 사용자의 클라우드 기반 스토리지 위치가 검색에 포함됩니다. 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

-Name

이 매개 변수는 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, 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

-RemoveExchangeLocation

RemoveExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에서 제거할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

  • 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

-RemoveExchangeLocationExclusion

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

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

  • 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

-RemovePublicFolderLocation

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

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

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

-RemoveSharePointLocation

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

RemoveSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에서 제거할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

-RemoveSharePointLocationExclusion

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

이 매개 변수는 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

-WhatIf

WhatIf 스위치는 보안 & 준수 PowerShell에서 작동하지 않습니다.

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

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