다음을 통해 공유

제한된 SharePoint 검색에 PowerShell 스크립트 사용

  • 아티클

중요

제한된 SharePoint Search는 Microsoft 365 Copilot 고객을 위해 설계되었습니다. 자세한 내용은 여기 및 제한된 SharePoint 검색 개요를 참조하세요.

기본적으로 제한된 SharePoint 검색 은 사용하도록 설정되지 않습니다. 제한된 SharePoint Search를 사용하도록 설정하고 설정하려면 Microsoft 365에서 SharePoint 관리자이상의 역할이 있어야 합니다. 시나리오에 따라 수행해야 하는 몇 가지 작업은 다음과 같습니다.

  • 제한된 검색에 대해 설정된 현재 모드 가져오기

  • 제한된 SharePoint 검색 사용 및 사용 안 함

  • URL을 제공하여 허용 목록에 사이트 추가

  • URL을 제공하여 허용된 목록에서 사이트 제거

  • 허용 목록에 추가된 기존 URL 목록 가져오기

 이 문서에서는 이러한 작업에 대해 PowerShell에서 관리자 스크립트를 사용하는 방법을 설명합니다.

시작하기 전에

다음 관리자 스크립트를 실행하려면 Microsoft 365의 SharePoint 관리자이상 이어야 합니다. 이 문서의 PowerShell 스크립트를 사용하기 전에 다음을 수행해야 합니다.

  1. 아직 다운로드하지 않은 경우 최신 SharePoint Online 관리 셸을 다운로드합니다.

    참고

    이전 버전의 SharePoint Online 관리 셸을 설치한 경우 프로그램 추가/제거로 이동하여 "SharePoint Online 관리 셸"을 제거합니다.

  2. Microsoft 365의 Microsoft 365에서SharePoint 관리자 이상으로 SharePoint에 연결합니다. 자세한 방법은 SharePoint Online 관리 셸 시작을 참조하세요.

제한된 SharePoint Search는 기본적으로 사용하지 않도록 설정됩니다. 이 기능의 현재 모드를 확인하려면 다음 스크립트를 실행할 수 있습니다.

Get-SPOTenantRestrictedSearchMode

모듈: Microsoft.Online.SharePoint.PowerShell

적용 대상: SharePoint Online

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Get-SPOTenantRestrictedSearchMode

예 

Get-SPOTenantRestrictedSearchMode

이 예제에서는 관리자가 테넌트에서 허용된 기존 목록을 가져올 수 있습니다. 결과는 현재 설정에 따라 '사용' 또는 '사용 안 함'일 수 있습니다.

제한된 검색 설정 사용 또는 사용 안 함

기본값을 사용하지 않도록 설정하여 제한된 검색 설정을 사용하거나 사용하지 않도록 설정합니다. 처음으로 설정을 사용하도록 설정하면 허용 목록이 비어 있습니다. 제한된 SharePoint Search를 사용하거나 사용하지 않도록 설정하려면 다음을 실행할 수 있습니다.

Set-SPOTenantRestrictedSearchMode

모듈: Microsoft.Online.SharePoint.PowerShell

적용 대상: SharePoint Online

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

예 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled  

예제 1은 테넌트에서 제한된 테넌트 검색 모드를 설정하거나 사용하도록 설정합니다.

예 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled  

예제 2에서는 테넌트용 제한된 테넌트 검색 모드를 사용하지 않도록 설정합니다.

매개 변수

-모드

제한된 테넌트 검색에 대한 모드를 설정합니다.

유형 String
위치: 0
기본값: 사용 안 함
필수: True
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

허용된 목록에 사이트 추가

제한된 SharePoint Search를 사용하도록 설정하면 문자열 또는 csv 파일의 허용 목록에 사이트 URL을 추가할 수 있습니다.

Add-SPOTenantRestrictedSearchAllowedList

모듈:Microsoft.Online.SharePoint.PowerShell

적용 대상: SharePoint Online

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

예 1

Add-SPOTenantRestrictedSearchAllowedList -SitesList @(“[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)”, “[https://contoso.sharepoint.com/sites/Benefits](https://contoso.sharepoint.com/sites/Benefits)”)

이 예제에서는 관리자가 허용된 목록에 사이트를 추가할 수 있습니다.

예 2

Add-SPOTenantRestrictedSearchAllowedList  -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

  이 예제에서는 관리자가 CSV 파일을 제공하여 허용된 목록에 사이트를 추가할 수 있습니다. URL 열에 사이트 URL 목록을 추가합니다.

매개 변수

-SitesList

허용된 목록의 사이트 목록입니다.

유형 String
위치: 0
기본값: 없음
필수: True
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

-SitesListFileURL

테넌트가 제한된 테넌트 검색 모드로 설정된 경우 허용 목록에 추가할 수 있는 사이트 URL 목록이 있는 파일입니다.

유형 String
위치: 0
기본값: 없음
필수: True
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

허용 목록에서 사이트 제거

PowerShell 스크립트를 사용하여 문자열 또는 csv 파일에 사이트 URL을 제공하여 허용된 목록에서 사이트를 제거할 수 있습니다.

Remove-SPOTenantRestrictedSearchAllowedList

모듈:Microsoft.Online.SharePoint.PowerShell

적용 대상: SharePoint Online

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

예 1

Remove-SPOTenantRestrictedSearchAllowedList -SitesList @(“[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)”, “[https://contoso.sharepoint.com/sites/HR](https://contoso.sharepoint.com/sites/HR)”)

예제 1을 사용하면 관리자가 허용된 목록에 있는 사이트를 제거할 수 있습니다.

예 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

예제 2를 사용하면 관리자가 CSV 파일을 제공하여 허용된 목록에 사이트를 추가할 수 있습니다.

매개 변수

-SitesList

허용 목록에서 제거될 사이트 목록입니다.

유형 String
위치: 0
기본값: 없음
필수: True
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

-SitesListFileURL

테넌트가 제한된 테넌트 검색 모드로 설정된 경우 허용 목록에서 제거할 수 있는 사이트 목록이 있는 파일입니다.

유형 String
위치: 0
기본값: 없음
필수: True
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

허용된 목록에서 기존 URL 목록 가져오기

다음 PowerShell 스크립트를 실행하여 허용된 목록에서 기존 URL 목록을 가져올 수 있습니다.

Get-SPOTenantRestrictedSearchAllowedList

모듈:Microsoft.Online.SharePoint.PowerShell

적용 대상: SharePoint Online

다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.

Get-SPOTenantRestrictedSearchAllowedList
```  

**Example**

```powershell
Get-SPOTenantRestrictedSearchAllowedList

이 예제에서는 관리자가 테넌트에서 허용된 기존 목록을 가져올 수 있습니다.