Compartilhar via


New-SPEnterpriseSearchServiceApplication

Adiciona um aplicativo de serviço de pesquisa a um farm.

Sintaxe

Default (Padrão)

New-SPEnterpriseSearchServiceApplication
    [[-Name] <String>]
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseName <String>]
    [-DatabasePassword <SecureString>]
    [-DatabaseServer <String>]
    [-DatabaseUsername <String>]
    [-Partitioned]
    [-WhatIf]
    [-AdminApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
    [-CloudIndex <Boolean>]
    [-FailoverDatabaseServer <String>]
    [<CommonParameters>]

Description

Este cmdlet é usado quando a funcionalidade de pesquisa é inicialmente configurada ou quando um novo aplicativo de pesquisa compartilhado é adicionado a um farm. SPEnterpriseSearchServiceApplication representa uma agregação autónoma de conteúdos indexados e propriedades disponíveis para pesquisa e fornece uma classe de âncora para definir propriedades pesquisa global. Um farm pode incluir vários aplicativos de serviço de pesquisa.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps'
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool

Este exemplo cria uma nova aplicação de serviço de pesquisa denominada NewSSA num novo conjunto aplicacional.

Um aplicativo de serviço de pesquisa criado desta forma terá uma topologia de pesquisa ativa, mas nenhum componente de pesquisa.

EXEMPLO 2

$appPool = New-SPServiceApplicationPool -Name 'SharePoint Web Services Default' -Account 'CONTOSO\ServiceApps'
New-SPEnterpriseSearchServiceApplication -Name "Search Service Application" -ApplicationPool $appPool -DatabaseName SearchServiceAppDB

Este exemplo cria uma nova aplicação de serviço de pesquisa denominada NewSSA num novo conjunto aplicacional e especifica o nome da Base de Dados.

Um aplicativo de serviço de pesquisa criado desta forma terá uma topologia de pesquisa ativa, mas nenhum componente de pesquisa.

Parâmetros

-AdminApplicationPool

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o pool de aplicativos a ser usado com o SearchAdminWebServiceApplication associado ao SearchServiceApplication. Caso não seja especificado, ApplicationPool será usado.

Propriedades do parâmetro

Tipo:SPIisWebServiceApplicationPoolPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ApplicationPool

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o conjunto aplicacional do IIS a utilizar para a nova aplicação de pesquisa.

O tipo tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um URL válido de uma aplicação de pesquisa, no formulário https://server_name; ou uma instância de um objeto SPIisWebServiceApplicationPool válido.

Propriedades do parâmetro

Tipo:SPIisWebServiceApplicationPoolPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CloudIndex

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Quando CloudIndex for verdadeira, ela se torna um aplicativo de serviço de pesquisa na nuvem que rastreia conteúdo local em uma solução de pesquisa híbrida na nuvem.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseName

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do banco de dados a ser criado para o novo aplicativo de pesquisa.

O tipo tem de ser um nome válido de uma base de dados SQL Server, por exemplo SearchAppDB1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabasePassword

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a palavra-passe do ID de utilizador que é utilizada para aceder à base de dados da aplicação de pesquisa no SQL Server.

O tipo deve ser uma senha válida.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do servidor host para o banco de dados especificado em DatabaseName.

O tipo tem de ser um nome de anfitrião SQL Server válido, por exemplo, SQLServerHost1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseUsername

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o ID de utilizador a utilizar para aceder à aplicação de pesquisa SQL Server base de dados.

O tipo deve ser um nome do usuário válido, por exemplo, SearchUserName1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FailoverDatabaseServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do servidor SQL que hospeda as instâncias de espelhamento dos bancos de dados de pesquisa.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica os nomes do novo aplicativo de pesquisa.

O tipo deve ser um nome válido de um aplicativo de pesquisa, por exemplo, SearchApp1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Partitioned

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que o aplicativo de serviço de pesquisa usa o modo hospedado na Web. O modo hospedado na Web segrega resultados para uma determinada inscrição hospedada.

Esta propriedade não tem efeito no SharePoint Server 2019.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.