Install-CsDatabase
Última modificación del tema: 2012-03-23
Instala una o varias bases de datos de Microsoft Lync Server 2010.
Sintaxis
Install-CsDatabase -LocalDatabases <SwitchParameter> [-Clean <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-ForDefaultInstance <SwitchParameter>] [-ForInstance <String>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -CentralManagementDatabase <SwitchParameter> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Collocated <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-SqlInstanceName <String>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -ConfiguredDatabases <SwitchParameter> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-ExcludeCollocatedStores <SwitchParameter>] [-Force <SwitchParameter>] [-ForDefaultInstance <SwitchParameter>] [-ForInstance <String>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -DatabaseType <Application | Archiving | Monitoring | User | Provision> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Collocated <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-SqlInstanceName <String>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync Server 2010 utiliza en gran medida las bases de datos de SQL Server, desde Almacén de administración central hasta Base de datos de archivado. En general, las bases de datos se configuran simultáneamente al instalar Lync Server 2010, o al instalar un rol de Lync Server 2010 (como, por ejemplo, un Servidor de supervisión) que requiera un back-end de base de datos. Tras realizar la instalación, no suele ser necesario volver a instalar las bases de datos ni trasladarlas a otras ubicaciones.
Sin embargo, en casos excepcionales, es posible que necesite instalar una base de datos de Lync Server 2010 manualmente, porque necesite transferir una base de datos a otro servidor, o porque algún problema haya provocado que no se incluya la base de datos durante la instalación. El cmdlet Install-CsDatabase permite instalar cualquiera de las bases de datos de SQL Server que utiliza Lync Server 2010.
Al ejecutar Install-CsDatabase, hay tres formas básicas de administrar la configuración de la base de datos que se instala:
Opción 1: ejecutar el cmdlet sin incluir ningún parámetro que especifique las rutas de las bases de datos. Cuando se ejecuta Install-CsDatabase sin el parámetro DatabasePath o UseDefaultSqlPath, el cmdlet utiliza un algoritmo integrado para elegir una ubicación de almacenamiento donde se guardarán los archivos de datos y los registros de las bases de datos. Tenga en cuenta que este algoritmo integrado funciona con un SQL Server independiente, no con un clúster de SQL Server. Para instalar una base de datos en un clúster de SQL Server, el comando debe incluir el parámetro DatabasePath o UseDefaultSqlPath.
Opción 2: ejecutar el cmdlet junto con el parámetro DatabasePath. Cuando se ejecuta Install-CsDatabase con el parámetro DatabasePath, no se utiliza el algoritmo integrado para elegir la ubicación de almacenamiento donde se guardarán los archivos de datos y los registros de las bases de datos. Por el contrario, los administradores pueden seleccionar la ubicación de los archivos de datos y registros. Para instalar los archivos de datos y los registros de SQL Server en la misma ubicación, sólo tiene que especificar la ruta de acceso de la carpeta donde se almacenarán los datos. Por ejemplo:
-DatabasePath C:\DatosSql
Para almacenar los archivos de datos en una ubicación y los archivos de registro, en otra, especifique la ruta de acceso de cada carpeta; separe ambas ubicaciones con una coma (sin espacio antes ni después de la coma):
-DatabasePath C:\RegistrosSql,D:\DatosSql
Los archivos de registro siempre se almacenarán en la primera ubicación; los de datos, en la segunda.
En el back-end de un grupo, es posible que se almacenen ciertos archivos de registro en una unidad de forma independiente. Si el back-end de su grupo tiene una sola unidad, los archivos se distribuirán como sigue:
Unidad 1: registro de Rtcdyn, registro de Rtc, otros registros y otros datos.
Si tiene dos unidades, los archivos se distribuirán así:
Unidad 1: registro de Rtcdyn y registro de Rtc.
Unidad 2: otros registros y otros datos.
Con tres unidades:
Unidad 1: registro de Rtcdyn.
Unidad 2: registro de Rtc.
Unidad 3: otros registros y otros datos.
Y con cuatro unidades:
Unidad 1: registro de Rtcdyn.
Unidad 2: registro de Rtc.
Unidad 3: otros registros.
Unidad 4: otros datos.
Para obtener más información, y para ver más casos de instalación, consulte la Guía de implementación de Lync Server 2010 Enterprise Edition.
Opción 3: ejecutar el cmdlet junto con el parámetro UseDefaultSqlPaths. Cuando se ejecuta Install-CsDatabase con el parámetro UseDefaultSqlPaths, no se utiliza el algoritmo integrado para elegir las ubicaciones de almacenamiento donde se guardarán los archivos de datos y los registros de las bases de datos. Por el contrario, los archivos de datos y registros se almacenan en las ubicaciones especificadas por las rutas de acceso predeterminadas de SQL Server (estas rutas debe configurarlas previamente un administrador de SQL Server). Los archivos de datos se almacenarán en la ubicación de archivos de datos de SQL Server predeterminada, mientras que los archivos de registro se almacenarán en la ubicación de archivos de registro de SQL Server predeterminada.
Antes de ejecutar Install-CsDatabase, debe comprobar que el grupo RTCUniversalServerAdmins no se ha asignado como propietario de la base de datos. Si este grupo aparece como propietario, es posible que dicho grupo se elimine al llamar a Install-CsDatabase.
Quién puede ejecutar este cmdlet: debe ser miembro del dominio, miembro del grupo RTCUniversalReadOnlyAdmins, los administradores de SQL Server y los administradores locales del equipo donde está instalado SQL Server pueden ejecutar localmente el cmdlet Install-CsDatabase. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Install-CsDatabase"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
CentralManagementDatabase |
Opcional |
Parámetro modificador |
Si se incluye este parámetro, Install-CsDatabase utilizará el parámetro SqlServerFqdn para instalar el Almacén de administración central en el equipo especificado. Normalmente, este parámetro lo utiliza solamente Topology Builder y sólo se llama al parámetro una vez, durante la instalación inicial. |
Clean |
Opcional |
Parámetro modificador |
Si se incluye este parámetro, Install-CsDatabase eliminará y reinstalará las bases de datos según sea necesario. Si este parámetro no se incluye, Install-CsDatabase no sobrescribirá ninguna base de datos instalada. No puede usar Clean y Update en el mismo comando. |
Collocated |
Opcional |
Parámetro modificador |
Si está presente, se instalarán roles de base de datos adicionales junto con el Almacén de administración central. |
ConfiguredDatabases |
Opcional |
Parámetro modificador |
Lee información de la topología de Lync Server 2010, e instala las bases de datos necesarias en el equipo SQL Server especificado o el clúster de SQL Server. Los administradores que necesiten llamar a Install-CsDatabase deberán usar este parámetro en la mayoría de los casos para especificar las bases de datos que se instalarán. |
DatabasePaths |
Opcional |
Cadena de caracteres |
Especifica las unidades de disco duro y carpetas en las que pueden almacenarse datos y archivos de registro, por ejemplo: -DatabasePaths "D:\Registros","E:\Datos". |
DatabaseType |
Opcional |
Cadena de caracteres |
Permite instalar una base de datos específica en un equipo SQL Server determinado o un grupo de servidores SQL Server. Normalmente, los administradores no deben ejecutar Install-CsDatabase con el parámetro DatabaseType, salvo que el personal de asistencia de Microsoft indique lo contrario. En general, los administradores deben utilizar el parámetro ConfiguredDatabases. Para usar el parámetro DatabaseType es necesario saber cuál es el tipo y la ubicación exacta de cada base de datos de la topología, y sólo es necesario si no es posible ejecutar el comando Install-CsDatabase con el parámetro ConfiguredDatabases. Los valores admitidos para DatabaseType son: Application Archiving Monitoring Provision User |
ExcludeCollocatedStores |
Opcional |
Parámetro modificador |
Si se especifica, suprime un mensaje de error que informa de que los almacenes de base de datos deben instalarse en el equipo local. |
ForDefaultInstance |
Opcional |
Parámetro modificador |
Si se especifica, indica a Install-CsDatabase que sólo debe aplicarse a la instancia de SQL Server predeterminada. No puede usar ForDefaultInstance y ForInstance en el mismo comando. |
ForInstance |
Opcional |
Cadena de caracteres |
Si se especifica, indica a Install-CsDatabase que sólo debe aplicarse a la instancia de SQL Server especificada. No puede usar ForInstance y ForDefaultInstance en el mismo comando. |
GlobalCatalog |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) de un servidor de catálogo global del dominio. Este parámetro no es necesario si se ejecuta Install-CsDatabase en un equipo con una cuenta en su dominio. |
GlobalSettingsDomainController |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) de un controlador de dominio en el que se almacena la configuración global. Si la configuración global se almacena en el contenedor del sistema de Active Directory Domain Services (AD DS), este parámetro debe hacer referencia al controlador de dominio raíz. Si la configuración global está almacenada en el contenedor de configuración, se puede usar cualquier controlador de dominio y omitir este parámetro. |
LocalDatabases |
Opcional |
Parámetro modificador |
Si se incluye este parámetro, Install-CsDatabase leerá la topología de Lync Server 2010 e instalará bases de datos y almacenes según sea necesario en el equipo local. |
SkipPrepareCheck |
Opcional |
Parámetro modificador |
Si se especifica, Install-CsDatabase omitirá las comprobaciones de preparación iniciales. |
SqlInstanceName |
Opcional |
Cadena de caracteres |
Nombre de la instancia de base de datos en la que se instalará la base de datos. Una instancia de base de datos es sencillamente un conjunto de procesos en ejecución que permiten tener acceso a los archivos de base de datos. Si no se especifica este parámetro, Install-CsDatabase usará la instancia de SQL Server predeterminada. |
SqlServerFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del equipo en el que se instalará la base de datos. Por ejemplo: -SqlServerFqdn atl-sql-001.litwareinc.com. |
Update |
Opcional |
Parámetro modificador |
Si se especifica, actualiza la base de datos. No puede usar Update y Clean en el mismo comando. |
UseDefaultSqlPaths |
Opcional |
Parámetro modificador |
Si se especifica, indica a SQL Server que debe seleccionar las unidades en las que se almacenarán los datos y archivos de registro. |
Force |
Opcional |
Parámetro modificador |
Si se especifica, fuerza la instalación de una nueva base de datos, incluso si ya hay una base de datos del mismo tipo en uso. |
Report |
Opcional |
Cadena de caracteres |
Permite especificar la ruta del archivo de registro creado al ejecutar el cmdlet. Por ejemplo: -Report "C:\Registros\InstallDatabases.html" |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Install-CsDatabase no acepta la entrada por canalización.
Tipos de valores devueltos
Install-CsDatabase no devuelve ningún valor u objeto.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Install-CsDatabase -ConfiguredDatabases -SqlServerFqdn atl-sql-001.litwareinc.com -DatabasePaths "E:\CSLog","F:\CSLog","G:\CSDB"
En el Ejemplo 1, Install-CsDatabase lee la topología de Lync Server 2010 e instala las bases de datos necesarias en el grupo de servidores atl-sql-001.litwareinc.com.
-------------------------- Ejemplo 2 ------------------------
Install-CSDatabase -CentralManagementDatabase -SqlServerFqdn atl-sql-001.litwareinc.com -SqlInstanceName rtc -DatabasePaths "G:\CSDB"
El comando del Ejemplo 2 instala el Almacén de administración central en el grupo de servidores atl-sql-001.litwareinc.com. La base de datos se instalará en la instancia rtc y usará la carpeta G:\CSDB.