New-SPEnterpriseSearchServiceApplication

Aggiunge un'applicazione del servizio di ricerca a una farm.

Sintassi

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>]

Descrizione

Questo cmdlet è utilizzato quando si configura inizialmente la funzionalità di ricerca o quando si aggiunge una nuova funzionalità di ricerca a una farm. SPEnterpriseSearchServiceApplication rappresenta un'aggregazione autonoma di contenuto indicizzato e proprietà disponibili per la ricerca e fornisce una classe di ancoraggio per l'impostazione di proprietà ricerca globale. Una farm può includere più applicazioni del servizio di ricerca.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO 1------------------

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

In questo esempio viene creata una nuova applicazione del servizio di ricerca denominata NewSSA in un nuovo pool di applicazioni.

Un'applicazione del servizio di ricerca creata in questo modo avrà una topologia di ricerca attiva, ma non componenti di ricerca.

------------------ESEMPIO 2------------------

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

In questo esempio viene creata una nuova applicazione del servizio di ricerca denominata NewSSA in un nuovo pool di applicazioni e viene specificato il nome del database.

Un'applicazione del servizio di ricerca creata in questo modo avrà una topologia di ricerca attiva, ma non componenti di ricerca.

Parametri

-AdminApplicationPool

Specifica il pool di applicazioni da utilizzare con SearchAdminWebServiceApplication associato a SearchServiceApplication. Se non viene specificato, verrà utilizzato ApplicationPool.

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPool

Specifica il pool di applicazioni IIS da usare per la nuova applicazione di ricerca.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; URL valido di un'applicazione di ricerca, nel formato https://server_name, o un'istanza di un oggetto SPIisWebServiceApplicationPool valido.

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CloudIndex

Quando CloudIndex è true, diventa un'applicazione del servizio di ricerca cloud che effettua una ricerca per indicizzazione sui contenuti locali in una soluzione di ricerca ibrida cloud.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Specifica il nome del database da creare per la nuova applicazione di ricerca.

Il tipo deve essere un nome valido di un database SQL Server, ad esempio SearchAppDB1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabasePassword

Specifica la password per l'ID utente usato per accedere al database dell'applicazione di ricerca in SQL Server.

Il tipo deve essere una password valida.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Specifica il nome del server host del database specificato in DatabaseName.

Il tipo deve essere un nome host SQL Server valido, ad esempio SQLServerHost1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseUsername

Specifica l'ID utente da utilizzare per accedere all'applicazione di ricerca SQL Server database.

Il tipo deve essere un nome utente valido, ad esempio NomeUtenteRicerca1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-FailoverDatabaseServer

Specifica il nome del server SQL che ospita le istanze mirror dei database di ricerca.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

Specifica i nomi della nuova applicazione di ricerca.

Il tipo deve essere un nome valido di un'applicazione di ricerca, ad esempio AppRicerca1.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Partitioned

Specifica che l'applicazione del servizio di ricerca utilizza la modalità ospitata su Web. La modalità ospitata su Web isola i risultati per una determinata sottoscrizione ospitata.

Questa proprietà non ha effetto su SharePoint Server 2019.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019