다음을 통해 공유


New-ComplianceSearchAction

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

New-ComplianceSearchAction cmdlet을 사용하여 Exchange Server 및 Microsoft Purview 규정 준수 포털 콘텐츠 검색에 대한 작업을 만듭니다.

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

구문

New-ComplianceSearchAction
   [-SearchName] <String[]>
   [-Export]
   [-ActionName <String>]
   [-ArchiveFormat <ComplianceExportArchiveFormat>]
   [-Confirm]
   [-FileTypeExclusionsForUnindexedItems <String[]>]
   [-EnableDedupe <Boolean>]
   [-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
   [-Force]
   [-Format <ComplianceDataTransferFormat>]
   [-IncludeCredential]
   [-IncludeSharePointDocumentVersions <Boolean>]
   [-JobOptions <Int32>]
   [-NotifyEmail <String>]
   [-NotifyEmailCC <String>]
   [-ReferenceActionName <String>]
   [-Region <String>]
   [-Report]
   [-RetentionReport]
   [-RetryOnError]
   [-Scenario <ComplianceSearchActionScenario>]
   [-Scope <ComplianceExportScope>]
   [-SearchNames <String[]>]
   [-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
   [-ShareRootPath <String>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]
New-ComplianceSearchAction
   [-SearchName] <String[]>
   [-Preview]
   [-ActionName <String>]
   [-Confirm]
   [-Force]
   [-Format <ComplianceDataTransferFormat>]
   [-IncludeCredential]
   [-JobOptions <Int32>]
   [-ReferenceActionName <String>]
   [-Region <String>]
   [-RetryOnError]
   [-Scenario <ComplianceSearchActionScenario>]
   [-SearchNames <String[]>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]
New-ComplianceSearchAction
   [-SearchName] <String[]>
   [-Purge]
   [-PurgeType <ComplianceDestroyType>]
   [-ActionName <String>]
   [-Confirm]
   [-Force]
   [-Format <ComplianceDataTransferFormat>]
   [-IncludeCredential]
   [-JobOptions <Int32>]
   [-Region <String>]
   [-ReferenceActionName <String>]
   [-RetryOnError]
   [-Scenario <ComplianceSearchActionScenario>]
   [-SearchNames <String[]>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

New-ComplianceSearch cmdlet을 사용하여 콘텐츠 검색을 만들고 Start-ComplianceSearch cmdlet을 사용하여 실행한 후에는 New-ComplianceSearchAction cmdlet을 사용하여 검색 작업을 검색에 할당합니다.

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

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

Microsoft 365에서 이 cmdlet을 실행하는 데 사용하는 계정에는 유효한 Microsoft 365 라이선스가 할당되어 있어야 합니다.

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

예제

예 1

New-ComplianceSearchAction -SearchName "Project X" -Preview

이 예제에서는 Project X라는 콘텐츠 검색에 대한 미리 보기 검색 작업을 만듭니다.

예 2

New-ComplianceSearchAction -SearchName "Project X" -Export

이 예제에서는 Project X라는 콘텐츠 검색에 대한 내보내기 검색 작업을 만듭니다.

참고: 2025년 5월 26일 이후에는 이 예제가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

예 3

New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete

다음은 피싱 메시지 제거라는 콘텐츠 검색에서 반환된 검색 결과를 삭제하는 예제입니다. Purge 매개 변수를 사용할 때는 인덱싱되지 않은 항목이 삭제되지 않습니다.

예 4

New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream

이 예제에서는 "Case 321 All Sites"라는 콘텐츠 검색에서 반환된 결과를 내보냅니다. 검색 결과는 압축되어 단일 ZIP 파일로 내보냅니다. 검색에 Exchange 위치가 포함된 경우 검색 결과는 사서함당 하나의 PST 파일로 내보내집니다.

참고: 2025년 5월 26일 이후에는 이 예제가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

매개 변수

-ActionName

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

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

ActionName 매개 변수는 콘텐츠 검색 작업의 이름을 지정합니다. SearchName 매개 변수에서 여러 콘텐츠 검색을 지정하는 경우에만 이 매개 변수를 사용합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ArchiveFormat

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

이 매개 변수는 더 이상 사용되지 않으며 더 이상 사용되지 않습니다.

Exchange 검색 결과의 형식을 지정하려면 ExchangeArchiveFormat 매개 변수를 사용합니다. SharePoint 및 OneDrive 검색 결과의 형식을 지정하려면 SharePointArchiveFormat 매개 변수를 사용합니다.

형식:ComplianceExportArchiveFormat
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

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

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

이 cmdlet에는 기본 제공 일시 중지가 있으므로 을 사용하여 -Confirm:$false 확인을 건너뜁니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableDedupe

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

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

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

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ExchangeArchiveFormat

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

이 매개 변수에는 보안 & 준수 PowerShell의 내보내기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

ExchangeArchiveFormat 매개 변수는 Exchange 검색 결과를 내보내는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

  • PerUserPst: 각 사서함에 대해 하나의 PST 파일입니다.
  • SinglePst: 내보낸 모든 메시지를 포함하는 하나의 PST 파일입니다.
  • SingleFolderPst: 전체 내보내기용 단일 루트 폴더가 있는 하나의 PST 파일입니다.
  • IndividualMessage: 각 메시지를 .msg 메시지 파일로 내보냅니다. 이 값은 기본값입니다.
  • PerUserZip: 각 사서함에 대해 하나의 ZIP 파일입니다. 각 ZIP 파일에는 사서함에서 내보낸 .msg 메시지 파일이 포함됩니다.
  • SingleZip: 모든 사서함에 대한 하나의 ZIP 파일입니다. ZIP 파일에는 모든 사서함에서 내보낸 모든 .msg 메시지 파일이 포함됩니다. 이 출력 설정은 PowerShell에서만 사용할 수 있습니다.

SharePoint 및 OneDrive 검색 결과의 형식을 지정하려면 SharePointArchiveFormat 매개 변수를 사용합니다.

형식:ComplianceExportArchiveFormat
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Export

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

이 매개 변수에는 보안 & 준수 PowerShell의 내보내기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

내보내기 스위치는 콘텐츠 검색에 대한 작업을 지정하여 검색 조건과 일치하는 전체 결과 집합을 내보냅니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

보고서에서 검색된 각 항목에 대한 정보만 반환하려면 Report 스위치를 사용합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FileTypeExclusionsForUnindexedItems

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

FileTypeExclusionsForUnindexedItems는 인덱싱할 수 없으므로 제외할 파일 형식을 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

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

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

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Format

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

Security & Compliance PowerShell에서 이 매개 변수에는 내보내기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

Format 매개 변수는 Export 스위치를 사용하는 경우 검색 결과의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • FxStream: PST 파일로 내보냅니다. 이 옵션은 Microsoft Purview 규정 준수 포털 검색 결과를 내보낼 때 사용할 수 있는 유일한 옵션입니다.
  • Mime: .eml 메시지 파일로 내보냅니다. cmdlet을 사용하여 검색 결과를 내보낼 때 기본값입니다.
  • Msg: .msg 메시지 파일로 내보냅니다.
형식:ComplianceDataTransferFormat
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IncludeCredential

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

IncludeCredential 스위치는 결과에 자격 증명을 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IncludeSharePointDocumentVersions

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

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

IncludeSharePointDocumentVersions 매개 변수는 Export 스위치를 사용할 때 문서의 이전 버전을 내보낼지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 문서의 모든 버전을 내보냅니다.
  • $false: 현재 게시된 토픽 버전만 내보냅니다. 이 값은 기본값입니다.
형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-JobOptions

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

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

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NotifyEmail

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

Security & Compliance PowerShell에서 이 매개 변수에는 내보내기 역할이 필요합니다. 기본적으로 eDiscovery Manager 역할 그룹에만 할당됩니다.

NotifyEmail 매개 변수는 Export 스위치를 사용하는 경우 검색 결과의 전자 메일 주소 대상을 지정합니다.

지정한 받는 사람은 메시지의 To: 필드에 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NotifyEmailCC

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

Security & Compliance PowerShell에서 이 매개 변수에는 내보내기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

NotifyEmailCC 매개 변수는 Export 스위치를 사용하는 경우 검색 결과의 전자 메일 주소 대상을 지정합니다.

지정한 받는 사람은 메시지의 Cc: 필드에 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Preview

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

Security & Compliance PowerShell에서 이 매개 변수에는 미리 보기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

미리 보기 스위치는 콘텐츠 검색에 대한 작업을 지정하여 검색 조건과 일치하는 결과를 미리 봅니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Purge

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

참고: 보안 & 준수 PowerShell에서 이 스위치는 검색 및 제거 역할에서만 사용할 수 있습니다. 기본적으로 이 역할은 조직 관리 및 데이터 조사자 역할 그룹에만 할당됩니다.

제거 스위치는 콘텐츠 검색에 대한 작업을 지정하여 검색 조건과 일치하는 항목을 제거합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

  • 사서함마다 한 번에 최대 10개의 항목을 제거할 수 있습니다. 메시지를 검색하고 제거하는 기능은 인시던트 응답 도구로 고안되었으므로 이러한 제한은 사서함에서 메시지가 빠르게 제거되도록 합니다. 이 작업은 사용자 사서함을 정리하기 위한 것이 아닙니다.

    : 10개 이상의 항목을 제거하려면 위치당 최대 100개의 항목을 제거할 수 있는 microsoft Graph API ediscoverySearch: purgeData를 참조하세요.

  • 단일 콘텐츠 검색을 사용하여 최대 50,000개의 사서함에서 항목을 제거할 수 있습니다. 50,000개 이상의 사서함에서 항목을 제거하려면 별도의 콘텐츠 검색을 만들어야 합니다. 자세한 내용은 Microsoft 365 organization 전자 메일 메시지 검색 및 삭제를 참조하세요.

  • 이 스위치를 사용할 때는 인덱스되지 않은 항목이 사서함에서 제거되지 않습니다.

  • PurgeType 매개 변수의 값은 항목이 제거되는 방법을 제어합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PurgeType

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

참고: 보안 & 준수 PowerShell에서 이 매개 변수는 검색 및 제거 역할에서만 사용할 수 있습니다. 기본적으로 이 역할은 조직 관리 및 데이터 조사자 역할 그룹에만 할당됩니다.

PurgeType 매개 변수는 작업이 Purge일 때 항목을 제거하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

  • SoftDelete: 삭제된 항목 보존 기간이 만료될 때까지 제거된 항목은 사용자가 복구할 수 있습니다.
  • HardDelete(클라우드에만 해당): 제거된 항목은 사서함에서 영구적으로 제거된 것으로 표시되며 다음에 관리되는 폴더 도우미에서 사서함을 처리할 때 영구적으로 제거됩니다. 사서함에서 단일 항목 복구를 사용하도록 설정하면 삭제된 항목 보존 기간이 만료된 후 제거된 항목이 영구적으로 제거됩니다.
형식:ComplianceDestroyType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReferenceActionName

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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Region

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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Report

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

보고서 스위치는 검색 조건과 일치하는 결과(전체 결과 집합 대신 각 항목에 대한 정보)에 대한 보고서를 내보내는 콘텐츠 검색에 대한 작업을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RetentionReport

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

RetentionReport 스위치는 콘텐츠 검색이 보존 보고서를 내보내는 작업을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RetryOnError

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

RetryOnError 스위치는 전체 작업을 완전히 다시 실행하지 않고 실패한 항목에 대한 작업을 다시 시도할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Scenario

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

Security & Compliance PowerShell에서 이 매개 변수에는 미리 보기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

Scenario 매개 변수는 시나리오 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • AnalyzeWithZoom: Microsoft Purview eDiscovery 프리미엄 처리를 위한 검색 결과를 준비합니다.
  • 일반: 검색 결과를 로컬 컴퓨터로 내보냅니다. 전자 메일은 .pst 파일로 내보내집니다. SharePoint 및 OneDrive 문서는 기본 Office 형식으로 내보내집니다.
  • GenerateReportsOnly
  • 인벤토리
  • RetentionReports
  • TriagePreview
형식:ComplianceSearchActionScenario
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Scope

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

Scope 매개 변수는작업이 Export인 경우에 포함할 항목을 지정합니다. 유효한 값은 다음과 같습니다.

  • IndexedItemsOnly
  • UnindexedItemsOnly
  • BothIndexedAndUnindexedItems
형식:ComplianceExportScope
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SearchName

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

SearchName 매개 변수는 콘텐츠 검색 작업과 연결할 기존 콘텐츠 검색의 이름을 지정합니다. 여러 콘텐츠 검색을 쉼표로 구분하여 지정할 수 있습니다.

| Get-ComplianceSearch 명령을 실행하여 콘텐츠 검색을 찾을 수 있습니다. Format-Table -Auto Name,Status.

형식:String[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SearchNames

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

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

SearchNames 매개 변수는 콘텐츠 검색 작업과 연결할 기존 콘텐츠 검색의 이름을 지정합니다. 콘텐츠 검색 이름을 쉼표로 구분합니다.

| Get-ComplianceSearch 명령을 실행하여 콘텐츠 검색 이름을 찾을 수 있습니다. Format-Table -Auto Name,Status.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SharePointArchiveFormat

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

이 매개 변수에는 내보내기 역할이 필요합니다. 기본적으로 이 역할은 eDiscovery Manager 역할 그룹에만 할당됩니다.

SharePointArchiveFormat 매개 변수는 SharePoint 및 OneDrive 검색 결과를 내보내는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

  • IndividualMessage: 압축되지 않은 파일을 내보냅니다. 이 값은 기본값입니다.
  • PerUserZip: 각 사용자에 대해 하나의 ZIP 파일입니다. 각 ZIP 파일에는 사용자에 대해 내보낸 파일이 포함됩니다.
  • SingleZip: 모든 사용자에 대한 하나의 ZIP 파일입니다. ZIP 파일에는 모든 사용자의 내보낸 모든 파일이 포함됩니다. 이 출력 설정은 PowerShell에서만 사용할 수 있습니다.

Exchange 검색 결과의 형식을 지정하려면 ExchangeArchiveFormat 매개 변수를 사용합니다.

형식:ComplianceExportArchiveFormat
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ShareRootPath

적용 가능: Exchange Server 2016, Exchange Server 2019

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

참고: 2025년 5월 26일 이후에는 이 매개 변수가 더 이상 작동하지 않습니다. 자세한 내용은 Microsoft Purview eDiscovery 예정된 변경 내용을 참조하세요.

{{ ShareRootPath 설명 채우기 }}

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Version

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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

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

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False