Set-ComplianceSearch

구문

Default (기본값)

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

예제

예 1

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

예 2

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

예 3

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

매개 변수

-AddExchangeLocation

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

매개 변수 속성

매개 변수 집합

-AddExchangeLocationExclusion

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

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

매개 변수 속성

매개 변수 집합

-AddSharePointLocation

적용 가능: 보안 & 규정 준수

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

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

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

매개 변수 집합

-AddSharePointLocationExclusion

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-AllowNotFoundExchangeLocationsEnabled

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

• 비활성 사서함
• Office 응용 프로그램을 사용하는 Exchange Online 라이선스가 없는 사용자
• 게스트 사용자
• ID가 Microsoft 365 organization 동기화되는 온-프레미스 사용자

매개 변수 속성

매개 변수 집합

-Confirm

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-ContentMatchQuery

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-Description

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

매개 변수 속성

매개 변수 집합

-ExchangeLocation

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

매개 변수 집합

-ExchangeLocationExclusion

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

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

매개 변수 속성

매개 변수 집합

-Force

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-HoldNames

적용 가능: 보안 & 규정 준수

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

HoldNames 매개 변수는 지정된 eDiscovery 사례에서 보류 중인 콘텐츠 위치를 검색할 수 있음을 지정합니다. 이 매개 변수에는 All 값을 사용합니다. eDiscovery 케이스와 관련된 준수 검색에 대해서만 이 매개 변수를 사용할 수 있습니다.

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

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

매개 변수 속성

매개 변수 집합

-Identity

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

• 이름
• JobRunId(GUID)

JobRunId(GUID)

매개 변수 속성

매개 변수 집합

-IncludeOrgContent

적용 가능: 보안 & 규정 준수

{{ Fill IncludeOrgContent Description }}

매개 변수 속성

매개 변수 집합

-IncludeUserAppContent

적용 가능: 보안 & 규정 준수

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

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

• $true: Exchange 위치 매개 변수에 지정된 사용자의 클라우드 기반 스토리지 위치가 검색에 포함됩니다. ExchangeLocation 매개 변수에 All 값을 사용하는 경우 게스트 또는 온-프레미스 사용자의 클라우드 기반 스토리지 위치가 검색에 포함됩니다.
• $false: ExchangeLocation 매개 변수에 지정된 사용자의 클라우드 기반 스토리지 위치는 검색에 포함되지 않습니다. 이 값은 기본값입니다.

매개 변수 속성

매개 변수 집합

-Language

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-Name

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

매개 변수 속성

매개 변수 집합

-PublicFolderLocation

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-RefinerNames

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-RemoveExchangeLocation

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

매개 변수 속성

매개 변수 집합

-RemoveExchangeLocationExclusion

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

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

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

매개 변수 속성

매개 변수 집합

-RemovePublicFolderLocation

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-RemoveSharePointLocation

적용 가능: 보안 & 규정 준수

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

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

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

매개 변수 집합

-RemoveSharePointLocationExclusion

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-SharePointLocation

적용 가능: 보안 & 규정 준수

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

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

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

매개 변수 집합

-SharePointLocationExclusion

적용 가능: 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

-WhatIf

적용 가능: Exchange Server 2016, Exchange Server 2019, 보안 & 규정 준수

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

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

매개 변수 속성

매개 변수 집합

CommonParameters