New-SPConfigurationDatabase
Cria um novo banco de dados de configuração
Sintaxe
Default (Padrão)
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>]
Description
O cmdlet New-SPConfigurationDatabase cria um novo banco de dados de configuração no servidor de banco de dados especificado. Esta é a base de dados central de um novo farm do SharePoint.
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
New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential)
Este exemplo solicita que o usuário forneça credenciais de usuário para a conta padrão do Administrador do Farm.
EXEMPLO 2
New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -SkipRegisterAsDistributedCacheHost
Este exemplo pede ao utilizador para fornecer credenciais de utilizador para a conta de Administrador do Farm predefinida e ignora o registo do servidor como anfitrião de Cache Distribuída. Aplica-se apenas ao SharePoint Server 2013 e ao SharePoint Server 2016 SharePoint Server 2019.
EXEMPLO 3
New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -LocalServerRole Custom
Este exemplo pede ao utilizador para fornecer credenciais de utilizador para a conta de Administrador do Farm predefinida e define a Função de Servidor como Personalizada. Aplica-se apenas ao SharePoint Server 2016 SharePoint Server 2019.
Parâmetros
-AdministrationContentDatabaseName
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o nomes para o banco de dados de conteúdo de Administração Central do novo farm. Se nenhum nome for especificado, um nome padrão será usado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
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 |
-DatabaseCredentials
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o objeto Credencial para o usuário do banco de dados. Utilize este parâmetro caso você use a Autenticação do SQL Server. Se nenhuma credencial de banco de dados for fornecida, será usada a autenticação do Windows.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DatabaseFailOverServer
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o servidor parceiro SQL Server Database Mirror para a base de dados de Configuração e Administração Central.
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: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DatabaseName
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o nome do novo banco de dados de configuração.
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: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DatabaseServer
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o servidor de banco de dados no qual o banco de dados de configuração deve ser criado. Se nenhum valor for especificado, será usado o valor padrão.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DirectoryDomain
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o domínio do diretório para o novo farm. Se nenhum domínio for especificado, será usado o domínio onde está localizado o computador local.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DirectoryOrganizationUnit
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica a unidade organizacional do diretório para o novo banco de dados de configuração. Se nenhuma unidade organizacional for especificada, será usada a unidade organizacional onde está localizada o computador local.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-FarmCredentials
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica credenciais para a conta de Administrador do Farm.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-LocalServerRole
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Especifica a Função de Servidor. Opções válidas para todas as versões do SharePoint Server 2016, SharePoint Server 2019 são: Custom, SingleServerFarm, , ApplicationWebFrontEnd, , , DistributedCacheSearch
Com a adição do Pacote de Funcionalidades 1, as novas opções incluem: ApplicationWithSearch, WebFrontEndWithDistributedCache
Propriedades do parâmetro
| Tipo: | SPServerRole |
| 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 |
-Passphrase
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica a frase de senha segura para o novo farm. Essa senha é usada para associar outros computadores a esse farm.
Propriedades do parâmetro
| Tipo: | SecureString |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ServerRoleOptional
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Configura o farm para não exigir a especificação de uma função de servidor. Se nenhuma função de servidor for especificada, o servidor se torna padrão para a função Personalizada.
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 |
-SiteMapDatabaseName
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Não usar. Especifica o nome da base de dados do site Mapa do Site.
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 |
-SiteMapDatabaseServer
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Não usar. Especifica o nome do servidor da base de dados do site Mapa do Site.
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 |
-SkipRegisterAsDistributedCacheHost
Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019
Por padrão, todos os servidores no farm são registrados como um host de cache (isto é, DistributedCacheService está executando por padrão).
Use este parâmetro para não registrar o computador do servidor como um host de cache distribuído. Se você deseja ter um host de cache dedicado, use este parâmetro para garantir que o serviço de armazenamento em cache não está instalado no computador.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 9 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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.