다음을 통해 공유

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

중요

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

PowerShell 스크립트를 사용하여 제한된 SharePoint Search를 사용하도록 설정하고 관리하는 방법

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

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

시작하기 전에

PowerShell 관리자 스크립트를 실행하려면 SharePoint 관리자 이거나 Microsoft 365에서 동일한 권한이 있어야 합니다.

이 문서의 PowerShell 스크립트를 사용하기 전에 다음 단계를 수행해야 합니다.

  1. 그렇지 않은 경우 최신 SharePoint Online 관리 셸 다운로드합니다.

    참고

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

  2. SharePoint 관리자 또는 Microsoft 365의 Microsoft 365에서 동등한 사용 권한으로 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

참고

모든 SharePoint 사이트 URL 목록을 생성하려면 SharePoint 온라인 관리 센터로 이동하여 활성 사이트 로 이동하고 내보내기를 선택합니다. 내보낸 목록에는 클래식 사이트도 포함됩니다. 인덱싱하지 않으려는 사이트를 이 목록에서 제거합니다. 최대 100 개의 URL을 포함할 수 있습니다.

이 예제에서는 관리자가 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

예 

Get-SPOTenantRestrictedSearchAllowedList

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

  • Last updated on