Connect-SPConfigurationDatabase
Conecta el equipo servidor local a una granja de servidores.
Sintaxis
Connect-SPConfigurationDatabase
[-DatabaseName] <String>
[-SkipRegisterAsDistributedCacheHost]
[-Passphrase] <SecureString>
-DatabaseServer <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseFailOverPartner <String>]
[-LocalServerRole <SPServerRole>]
[-DatabaseConnectionEncryption <SqlConnectionEncryptOption>]
[-DatabaseServerCertificateHostName <String>]
[<CommonParameters>] Description
El cmdlet Connect-SPConfigurationDatabase conecta el servidor actual a la base de datos de configuración especificada.
Esencialmente, este cmdlet conecta el servidor a la granja de servidores. Si el equipo actual no puede conectarse con una granja de servidores, se muestra un mensaje de error similar al siguiente:
“Este equipo ya está conectado a una granja de servidores de SharePoint. Consulte: Dismount-SPConfigurationDatabase”
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
------------------EJEMPLO------------------
Connect-SPConfigurationDatabase -DatabaseServer "ServerName\InstanceName" -DatabaseName "SharePointConfigurationDatabaseName" -Passphrase (ConvertTo-SecureString "MyP@ssw0rd" -AsPlainText -Force)
Start-Service SPTimerv4En este ejemplo, se conecta el equipo servidor local a una granja de servidores configurada para usar la base de datos SharePointConfigurationDatabase en una instancia de SQL Server usando el nombre ServerName\InstanceName con la frase de contraseña MyP@ssw0rd.
Parámetros
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
| Tipo: | SPAssignmentCollection |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseConnectionEncryption
Especifica si se usa el cifrado TLS para la conexión entre SharePoint y la base de datos. Obligatorio requiere que se use el cifrado TLS. Si el cifrado TLS no se puede negociar correctamente, se producirá un error en la conexión. Opcional permite usar el cifrado TLS. Si el servidor de base de datos requiere cifrado TLS, se usará el cifrado TLS. De lo contrario, no se usará el cifrado TLS. Strict requiere que el cifrado TLS se use con TDS 8.0, que es la configuración de cifrado más segura. Si el cifrado TLS con TDS 8.0 no se puede negociar correctamente, se producirá un error en la conexión. Las bases de datos montadas en SharePoint antes de la actualización de características de la versión 24H2 se instalaron de forma predeterminada en Cifrado opcional. Si este parámetro no se especifica al montar una nueva base de datos en SharePoint después de instalar la actualización de características de la versión 24H2, el valor predeterminado es Obligatorio.
| Tipo: | SqlConnectionEncryptOption |
| Posición: | Named |
| Valor predeterminado: | Mandatory |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseCredentials
Especifica el objeto PSCredential que contiene el nombre de usuario y la contraseña que se usarán para la autenticación de SQL de la base de datos. Si no se especifica este parámetro, se usa el usuario actual.
El tipo debe ser un objeto PSCredential válido.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseFailOverPartner
Especifica el asociado de creación de reflejo de la base de datos para una instancia de SQL Server.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseName
Especifica el nombre de la base de datos de configuración con la que se va a conectar el servidor.
El tipo debe ser un nombre de base de datos válido (por ejemplo, DB1).
| Tipo: | String |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseServer
Especifica el servidor en el que se va a crear la base de datos de configuración. El valor predeterminado es el nombre del equipo local.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-DatabaseServerCertificateHostName
Establece el nombre de host que se va a usar al validar el certificado de servidor para la conexión.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-LocalServerRole
Especifica el Objeto MinRole asignado al servidor local.
| Tipo: | SPServerRole |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-Passphrase
Especifica la frase de contraseña segura para conectar el servidor actual a la base de datos de configuración.
El tipo debe ser una cadena segura válida, como, por ejemplo, MyBDCApp1serverkey.
| Tipo: | SecureString |
| Posición: | 9 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |
-SkipRegisterAsDistributedCacheHost
De forma predeterminada, todos los servidores de la granja se registran como host de caché (es decir, se ejecuta DistributedCacheService de forma predeterminada).
Use este parámetro para no registrar el equipo servidor como host de caché distribuida. Si quiere un host de caché dedicado, use este parámetro para asegurarse de que no se instale el servicio de almacenamiento en caché en el equipo.
| Tipo: | SwitchParameter |
| Posición: | 10 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
| Se aplica a: | SharePoint Server Subscription Edition |