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