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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-LocalServerRole
Specifica il ruolo del server. Opzioni valide per tutte le versioni di SharePoint Server 2016, SharePoint Server 2019 sono: Custom
, SingleServerFarm
, , Application
, WebFrontEnd
, DistributedCache
Search
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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |