중요
제한된 SharePoint Search가 사용 중지되었습니다. 2026년 7월 31일부터 새 사용이 차단됩니다. 콘텐츠 검색을 위해 RCD( 제한된 콘텐츠 검색 )와 같은 포괄적인 데이터 컨트롤을 사용합니다.
제한된 SharePoint Search는 Microsoft 365 Copilot 채팅 및 에이전트 환경을 사용하는 고객을 위해 설계되었습니다. organization 관리자가 사이트 및 파일 권한을 철저히 검토하고 감사할 수 있는 시간을 허용하는 단기 솔루션으로 설계되었지만 장기적인 용도로 의도되거나 확장 가능하지는 않습니다. SharePoint 고급 관리 및 Microsoft Purview를 비롯한 포괄적인 데이터 보안 솔루션을 사용할 수 있습니다.
PowerShell 스크립트를 사용하여 제한된 SharePoint Search를 사용하도록 설정하고 관리하는 방법
기본적으로 제한된 SharePoint 검색은 사용하도록 설정되지 않습니다. 제한된 SharePoint Search를 사용하도록 설정하고 설정하려면 Microsoft 365에서 SharePoint 관리자 의 권한 이상이 있어야 합니다. 시나리오에 따라 수행해야 하는 몇 가지 작업은 다음과 같습니다.
- 제한된 검색의 현재 모드 가져오기
- 제한된 검색 사용 및 사용 안 함
- URL을 제공하여 허용 목록에 사이트 추가
- URL을 제공하여 허용된 목록에서 사이트 제거
- 허용 목록에 추가된 기존 URL 목록 가져오기
이 문서에서는 이러한 작업에 대해 PowerShell에서 관리자 스크립트를 사용하는 방법을 설명합니다.
시작하기 전에
PowerShell 관리자 스크립트를 실행하려면 SharePoint 관리자 이거나 Microsoft 365에서 동일한 권한이 있어야 합니다.
SharePoint 고급 관리를 위한 필수 구성 요소를 참조하세요.
이 문서에서 PowerShell 스크립트를 사용하기 전에 SharePoint Online PowerShell 모듈 요구 사항을 참조하세요.
제한된 SharePoint Search의 현재 모드 가져오기
제한된 SharePoint Search는 기본적으로 사용하지 않도록 설정됩니다. 이 기능의 현재 모드를 확인하려면 다음 명령을 실행할 수 있습니다.
Get-SPOTenantRestrictedSearchMode
모듈: Microsoft.Online.SharePoint.PowerShell
적용 대상: SharePoint Online
다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.
Get-SPOTenantRestrictedSearchMode
예
Get-SPOTenantRestrictedSearchMode
이 예제에서는 관리자가 테넌트에서 허용된 기존 목록을 가져올 수 있습니다. 결과는 현재 설정에 따라 "사용" 또는 "사용 안 함"일 수 있습니다.
제한된 검색 사용 또는 사용 안 함
제한된 검색 설정을 사용하거나 사용하지 않도록 설정합니다. 기본값은 disabled입니다. 설정을 처음 사용하도록 설정하면 허용 목록이 비어 있습니다. 제한된 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에서는 테넌트용 제한된 테넌트 검색 모드를 사용하지 않도록 설정합니다.
매개 변수
-Mode
제한된 테넌트 검색에 대한 모드를 설정합니다.
| 유형 | String |
|---|---|
| 위치: | 0 |
| 기본값: | Disabled |
| 필수: | True |
| 파이프라인 입력 수락: | False |
| 와일드카드 문자 허용: | False |
허용 목록에 사이트 추가
제한된 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 |
| 기본값: | None |
| 필수: | True |
| 파이프라인 입력 수락: | False |
| 와일드카드 문자 허용: | False |
-SitesListFileURL
테넌트가 제한된 테넌트 검색 모드로 설정된 경우 허용 목록에 추가할 수 있는 사이트 URL 목록이 있는 파일입니다.
| 유형 | String |
|---|---|
| 위치: | 0 |
| 기본값: | None |
| 필수: | True |
| 파이프라인 입력 수락: | False |
| 와일드카드 문자 허용: | False |
허용 목록에서 사이트 제거
다음 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 |
| 기본값: | None |
| 필수: | True |
| 파이프라인 입력 수락: | False |
| 와일드카드 문자 허용: | False |
-SitesListFileURL
테넌트가 제한된 테넌트 검색 모드로 설정된 경우 허용 목록에서 제거할 수 있는 사이트 목록이 있는 파일입니다.
| 유형 | String |
|---|---|
| 위치: | 0 |
| 기본값: | None |
| 필수: | True |
| 파이프라인 입력 수락: | False |
| 와일드카드 문자 허용: | False |
허용 목록에서 기존 URL 목록 가져오기
허용 목록에서 기존 URL 목록을 얻으려면 다음 PowerShell 명령을 실행합니다.
Get-SPOTenantRestrictedSearchAllowedList
모듈:Microsoft.Online.SharePoint.PowerShell
적용 대상: SharePoint Online
다중값 속성 구문 표에서 선택하는 구문은 cmdlet에 대한 매개 변수 값으로 지정됩니다. 예를 들어 다음 명령을 통해 다중값 속성에 여러 값을 추가할 수 있습니다.
Get-SPOTenantRestrictedSearchAllowedList
예
Get-SPOTenantRestrictedSearchAllowedList
이 예제에서는 관리자가 테넌트에서 기존 허용 목록을 가져오는 방법을 보여줍니다.