New-SPConfigurationDatabase

Crea un nuovo database di configurazione.

Sintassi

New-SPConfigurationDatabase
   [-DatabaseName] <String>
   [-DatabaseServer] <String>
   [[-DirectoryDomain] <String>]
   [[-DirectoryOrganizationUnit] <String>]
   [[-AdministrationContentDatabaseName] <String>]
   [[-DatabaseCredentials] <PSCredential>]
   [-FarmCredentials] <PSCredential>
   [-Passphrase] <SecureString>
   [-SkipRegisterAsDistributedCacheHost]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-DatabaseFailOverServer <String>]
   [-LocalServerRole <SPServerRole>]
   [-ServerRoleOptional]
   [<CommonParameters>]

Descrizione

Il cmdlet New-SPConfigurationDatabase crea un nuovo database di configurazione nel server di database specificato. Questo è il database centrale per una nuova farm di SharePoint.

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

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential)

Questo esempio consente di richiedere all'utente di fornire le credenziali per l'account predefinito dell'amministratore della farm.

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

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -SkipRegisterAsDistributedCacheHost

In questo esempio viene richiesto all'utente di specificare le credenziali utente per l'account amministratore della farm predefinito e viene ignorata la registrazione del server come host cache distribuita. Si applica a SharePoint Server 2013 e SharePoint Server 2016, solo SharePoint Server 2019.

------------------ESEMPIO 3-----------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -LocalServerRole Custom

In questo esempio viene richiesto all'utente di specificare le credenziali utente per l'account amministratore della farm predefinito e viene impostato il ruolo del server su Personalizzato. Si applica a SharePoint Server 2016, solo SharePoint Server 2019.

Parametri

-AdministrationContentDatabaseName

Specifica il nome del database del contenuto di Amministrazione centrale per la nuova farm. Se non viene specificato alcun nome, verrà utilizzato un nome predefinito.

Type:String
Position:5
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

-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

-DatabaseCredentials

Specifica l'oggetto Credential per l'utente di database. Utilizzare questo parametro se si applica l'autenticazione di SQL Server. Se non si specificano credenziali di database, verrà utilizzata l'autenticazione di Windows.

Type:PSCredential
Position:6
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

-DatabaseFailOverServer

Specifica il SQL Server server partner mirror del database per il database di configurazione e amministrazione centrale.

Type:String
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

-DatabaseName

Specifica il nome del nuovo database di configurazione.

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

-DatabaseServer

Specifica il server di database in cui creare il database di configurazione. Se non si specifica un valore, verrà utilizzato il valore predefinito.

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

-DirectoryDomain

Specifica il dominio della directory per la nuova farm. Se non si specifica un dominio, verrà utilizzato il dominio a cui appartiene il computer locale.

Type:String
Position:3
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

-DirectoryOrganizationUnit

Specifica l'unità organizzativa della directory per il nuovo database di configurazione. Se non si specifica un'unità organizzativa, verrà utilizzata l'unità organizzativa a cui appartiene il computer locale.

Type:String
Position:4
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

-FarmCredentials

Specifica le credenziali per l'account dell'amministratore della farm.

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

-LocalServerRole

Specifica il ruolo del server. Opzioni valide per tutte le versioni di SharePoint Server 2016, SharePoint Server 2019 sono: Custom, SingleServerFarm, , Application, WebFrontEnd, DistributedCacheSearch

Con l'aggiunta di Feature Pack 1, le nuove opzioni includono: ApplicationWithSearch, WebFrontEndWithDistributedCache

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

-Passphrase

Specifica la passphrase sicura per la nuova farm. Questa passphrase viene utilizzata per aggiungere altri computer alla farm.

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

-ServerRoleOptional

Configura la farm in modo che non sia necessario specificare un ruolo del server. Se non viene specificato nessun ruolo del server, per impostazione predefinita al server viene assegnato il ruolo personalizzato.

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

-SiteMapDatabaseName

Non utilizzare. Specifica il nome del database del sito della mappa del sito.

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

-SiteMapDatabaseServer

Non utilizzare. Specifica il nome del server del databse del sito della mappa del sito.

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

-SkipRegisterAsDistributedCacheHost

Per impostazione predefinita, tutti i server della farm vengono registrati come host della cache, ovvero per impostazione predefinita viene eseguito il servizio DistributedCacheService.

Utilizzare questo parametro per non registrare il computer server come host della cache distribuita. Se si desidera disporre di un host della cache dedicata, utilizzare questo parametro per assicurarsi che il servizio di memorizzazione nella cache non venga installato nel computer.

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