Set-SPEnterpriseSearchResultSource

  • 참조
모듈:
sharepoint-server
적용 대상:
SharePoint Server Subscription Edition

결과 원본의 속성을 설정합니다.

Syntax

Set-SPEnterpriseSearchResultSource
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationType <FederationAuthType>]
   [-AutoDiscover <Boolean>]
   [-Confirm]
   [-Description <String>]
   -Identity <ResultSourcePipeBind>
   [-MakeDefault <Boolean>]
   [-Name <String>]
   [-Owner <SearchObjectOwner>]
   [-Password <String>]
   [-ProviderId <Guid>]
   [-QueryTemplate <String>]
   [-RemoteUrl <String>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-SsoId <String>]
   [-UserName <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

이 cmdlet은 사용자가 만든 결과 원본의 속성을 업데이트합니다. 이 cmdlet은 중앙 관리의 "결과 원본 관리" 페이지를 통해 지원되는 것과 동일한 업데이트 작업을 지원합니다. MakeDefault 매개 변수를 사용하여 기본 결과 원본을 변경하는 것 이외의 모든 업데이트 작업에 대한 결과 원본은 기본 제공 원본일 수 없습니다(기본 제공 원본에는 true로 설정된 BuiltIn 속성이 있음). SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

--------------------예제 1---------------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"

다음은 결과 원본의 이름을 업데이트하고 결과 원본의 ID를 결과 원본 인스턴스로 지정하는 예제입니다. 이 업데이트 작업에는 SearchApplication 및 Owner가 필요하지 않습니다.

---------------예제 2---------------

$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"

다음은 결과 원본에 대한 설명을 업데이트하는 예제이며, 결과 원본의 ID는 이름으로 지정됩니다.

매개 변수

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AuthenticationType

결과 원본에 대한 인증 유형을 지정합니다. 매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

특정 인증 유형 집합은 각 검색 공급자 유형에 대해 지원되며 매개 변수가 지정되지 않은 경우 인증 유형은 기본적으로 검색 공급자 유형에 따라 지원됩니다.

이 cmdlet은 다음과 같은 인증 메커니즘 및 해당 형식 집합을 지원합니다. 기본 SharePoint 인증(FederationAuthType.LocalNTAuth), 기본 인증(FederationAuthType.SingleAccountBasicAuth - UserName 및 암호 지정), 기본값 원격 SharePoint 인증(FederationAuthType.PerUserBasicAuth), Single Sign-On(FederationAuthType.SSO - SsoId를 지정해야함), 익명(FederationAuthType.Anonymous), 다이제스트 인증( FederationAuthType.SingleAccountDigest - UserName 및 Password 지정), NTLM 애플리케이션 풀 ID(FederationAuthType.ApplicationPoolIdentity), NTLM 사용자 이름 및 암호(FederationAuthType.SingleAccountNTLM - UserName 및 Password 지정).

로컬 SharePoint Search/로컬 SharePoint 사람 Search 공급자를 사용하는 경우 FederationAuthType.LocalNTAuth(기본값) 및 FederationAuthType.SingleAccountBasicAuth가 지원됩니다.

원격 SharePoint Search/원격 SharePoint 사람 Search 공급자를 사용하는 경우 FederationAuthType.PerUserBasicAuth(기본값) 및 FederationAuthType.SSO가 지원됩니다.

OpenSearch 1.0/1.1 검색 공급자를 사용하는 경우 FederationAuthType.Anonymous(기본값), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM 및 FederationAuthType.ApplicationPoolIdentity 인증 유형이 지원됩니다.

모든 인증 유형은 열거형 FederationAuthType에 나열됩니다.

Type:FederationAuthType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AutoDiscover

결과 원본에 대해 Exchange 서버 엔드포인트의 자동 검색을 사용할지 여부를 지정합니다.

값을 true($true)로 설정하면 자동 검색이 사용됩니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

Exchange 검색 공급자를 사용할 때에만 적용됩니다.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

명령을 실행하기 전에 사용자에게 확인 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Description

결과 원본에 대한 설명을 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

업데이트할 결과 원본을 지정합니다.

형식은 12345678-90ab-cdef-1234-567890bcdefgh 형식에 유효한 GUID 문자열, 유효한 결과 원본 이름(예: "Custom SharePoint Result Source") 또는 유효한 Source 개체의 인스턴스여야 합니다.

Type:ResultSourcePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-MakeDefault

Owner 매개 변수로 지정된 범위에 대해 결과 원본을 기본 결과 원본으로 설정할지 여부를 지정합니다.

매개 변수를 지정하지 않으면 기본 결과 원본이 변경되지 않습니다.

값을 true($true)로 설정하면 결과 원본이 기본값으로 설정됩니다.

값을 false($false)로 설정하면 결과 원본을 기본값으로 설정해서는 안 되며, 이 경우 업데이트할 결과 원본이 현재 기본값인 경우 원래 기본 결과 원본("로컬 SharePoint 결과")이 다시 기본값으로 설정됩니다.

팁: Makedefault를 사용할 때 이름이나 GUID 문자열 ID가 아닌 인스턴스를 ID로 사용하여 결과 원본을 기본값으로 설정해야 하는 수준(값이 true인 경우) 또는 기본값이 원래(값이 false인 경우)로 다시 설정해야 하는 수준을 지정하는 데만 Owner를 사용하도록 명확하게 지정합니다.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Name

결과 원본의 이름을 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

이름은 각 관리 수준에서 고유해야 합니다.

예를 들어 한 사이트의 두 결과 원본은 이름을 공유할 수 없지만 한 사이트의 결과 원본 하나와 사이트 모음에서 제공한 결과 원본 하나는 이름을 공유할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Owner

해당 결과 원본을 사용할 수 있는 범위를 정의하는 검색 개체 소유자를 지정합니다.

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Password

결과 원본에 연결하는 데 사용할 사용자 자격 증명의 암호를 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

인증 유형(AuthenticationType)이 사용자 자격 증명을 사용하는 유형(FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest 또는 FederationAuthType.SingleAccountNTLM)으로 설정된 경우에 사용됩니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ProviderId

결과 원본에서 사용할 검색 공급자를 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

Guid 또는 GUID 문자열로 지정되며 다음, 즉 FA947043-6046-4F97-9714-40D4C113963D(로컬 SharePoint 검색), E4BCC058-F133-4425-8FFC-1D70596FFD33(로컬 SharePoint 사용자 검색), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7(원격 SharePoint 검색), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA(원격 SharePoint 사용자 검색), 3A17E140-1574-4093-BAD6-E19CDF1C0122(Exchange 검색), 3A17E140-1574-4093-BAD6-E19CDF1C0121(OpenSearch 1.0/1.1) 중 하나여야 합니다.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-QueryTemplate

결과 원본의 쿼리 변환 서식 파일을 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

들어오는 쿼리는 이 새 쿼리 텍스트를 대신 사용하도록 서식 파일에 따라 변경됩니다. 쿼리 변수 "{searchTerms}"를 사용하여 새 텍스트에 들어오는 쿼리를 포함합니다. 이를 사용하여 결과의 범위를 지정합니다.

예를 들어 OneNote 항목만 반환하려면 새 텍스트를 "{searchTerms} fileextension=one"으로 설정합니다. 그러면 들어오는 쿼리 "sharepoint"가 "sharepoint fileextension=one"이 됩니다. 기본값은 {searchTerms}입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RemoteUrl

결과 원본의 연결 URL 서식 파일을 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

이 매개 변수를 사용하는 검색 공급자, 즉 원격 SharePoint 검색, 원격 SharePoint 사용자 검색, OpenSearch 1.0/1.1 및 Exchange(AutoDiscover가 설정되지 않은 경우)를 사용할 때 설정해야 합니다.

다른 검색 공급자를 사용할 때에는 이 매개 변수가 무시됩니다.

원격 SharePoint 검색/원격 SharePoint 사용자 검색의 경우 원격 SharePoint 팜의 루트 사이트 모음 주소를 지정합니다.

OpenSearch 1.0/1.1의 경우 OpenSearch 원본의 URL을 지정하고, 쿼리 변수 "{searchTerms}"를 사용하여 URL에 쿼리를 포함합니다.

이 쿼리 변수는 자동으로 쿼리로 대체됩니다. Exchange의 경우 결과를 검색할 Exchange EWS URL을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SearchApplication

검색 응용 프로그램을 지정합니다.

형식은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 유효한 GUID, 유효한 검색 응용 프로그램 이름(예: SearchApp1) 또는 유효한 SearchServiceApplication 개체의 인스턴스여야 합니다.

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SsoId

결과 원본에 연결하는 데 사용할 역방향 프록시 인증서 보안 저장소 ID를 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

인증 유형(AUthenticationType)이 FederationAuthType.SSO(Single Sign-On)로 설정된 경우 지정해야 합니다.

역방향 프록시를 통해 인트라넷에 연결하는 경우 역방향 프록시를 인증하는 데 사용되는 인증서가 저장된 Single Sign On 항목의 SSO ID를 입력합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UserName

결과 원본에 연결하는 데 사용할 사용자 자격 증명의 사용자 이름을 지정합니다.

매개 변수를 지정하지 않으면 값이 변경되지 않습니다.

인증 유형(AuthenticationType)이 사용자 자격 증명을 사용하는 유형(FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest 또는 FederationAuthType.SingleAccountNTLM)으로 설정된 경우에 사용됩니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition