Install-CsDatabase
上一次修改主题: 2012-03-23
安装一个或多个 Microsoft Lync Server 2010 数据库。
语法
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>]]
详细说明
Lync Server 2010 广泛使用 SQL Server 数据库,包括从中央管理存储到存档数据库的各种数据库。一般而言,会在安装 Lync Server 2010 或安装需要数据库后端的 Lync Server 2010 角色(如监控服务器)的同时安装这些数据库。安装之后,通常无需重新安装这些数据库或将其移动到新位置。
但是,在极少的情况下,您可能需要手动安装 Lync Server 2010 数据库;这可能是因为您需要将一个数据库移动到另一个服务器,或者因为与设置相关的问题导致数据库安装失败。Install-CsDatabase cmdlet 提供了一种安装 Lync Server 2010 使用的任何 SQL Server 数据库的方法。
运行 Install-CsDatabase 时,处理要安装的数据库配置的方法基本有三种:
选项 1 -- 在未包含指定数据库路径的参数的情况下运行该 cmdlet。在不带 DatabasePath 或 UseDefaultSqlPath 参数的情况下运行 Install-CsDatabase 时,该 cmdlet 会使用内置算法选择数据库日志和数据文件的存储位置。请注意,此内置算法对于独立的 SQL Server 有用,但对 SQL Server 群集不起作用。要在 SQL Server 群集上安装数据库,您的命令中必须包含 DatabasePath 或 UseDefaultSqlPath 参数。
选项 2 -- 带 DatabasePath 参数运行该 cmdlet。运行带 DatabasePath 参数的 Install-CsDatabase 时,将不使用内置算法选择数据库日志和数据文件的存储位置。管理员可以为这些日志和数据文件选择位置。要将数据文件和 SQL Server 日志安装在同一位置,只需指定要用于存储数据的文件夹的路径即可。例如:
-DatabasePath C:\SqlData
要将数据文件存储在一个位置而日志文件存储在另一位置,请指定每个文件夹的路径,并使用逗号分隔这两个位置(请注意,逗号前后不要有空格):
-DatabasePath C:\SqlLogs,D:\SqlData
日志文件将始终存储在指定的第一个位置,而数据文件将存储在第二个位置。
在池后端中,某些日志文件可能独自存储在驱动器上。如果您的池后端具有一个驱动器,则文件的分布如下所示:
驱动器 1 – Rtcdyn 日志;Rtc 日志;其他日志;其他数据。
如果具有两个驱动器,则文件的分布如下所示:
驱动器 1 – Rtcdyn 日志;Rtc 日志。
驱动器 2 – 其他日志;其他数据。
具有三个驱动器:
驱动器 1 – Rtcdyn 日志。
驱动器 2 – Rtc 日志。
驱动器 3 – 其他日志;其他数据。
具有四个驱动器:
驱动器 1 – Rtcdyn 日志。
驱动器 2 – Rtc 日志。
驱动器 3 – 其他日志。
驱动器 4 – 其他数据。
有关详细信息及其他安装方案,请参阅《Lync Server 2010 Enterprise Edition 部署指南》。
选项 3 -- 带 UseDefaultSqlPaths 参数运行该 cmdlet。运行带 UseDefaultSqlPaths 参数的 Install-CsDatabase 时,将不使用内置算法选择数据库日志和数据文件的存储位置。日志和数据文件将存储在由 SQL Server 默认路径(SQL Server 管理员必须提前配置好这些路径)指定的位置。数据文件将存储在默认 SQL Server 数据文件位置,而日志文件将存储在默认 SQL Server 日志文件位置。
在运行 Install-CsDatabase 之前,必须先确保 RTCUniversalServerAdmins 组尚未分配为数据库所有者。如果该组已列为所有者,则在调用 Install-CsDatabase 时,该组可能会被删除。
谁能运行此 cmdlet:只有域的成员、RTCUniversalReadOnlyAdmins 组成员、SQL Server 管理员以及安装 SQL Server 的计算机上的本地管理员,才能在本地运行 Install-CsDatabase cmdlet。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Install-CsDatabase"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
CentralManagementDatabase |
可选 |
开关参数 |
如果包含此参数,则 Install-CsDatabase 会使用 SqlServerFqdn 参数将中央管理存储安装在指定的计算机上。此参数通常只由 拓扑生成器使用,并且通常只在初始安装期间调用一次。 |
Clean |
可选 |
开关参数 |
如果包括此参数,Install-CsDatabase 将根据需要删除并重新安装数据库。如果未包括此参数,则 Install-CsDatabase 将不会覆盖任何现有数据库。不能在同一个命令中同时使用 Clean 和 Update。 |
Collocated |
可选 |
开关参数 |
如果存在,则其他数据库角色将与中央管理存储并置在一起。 |
ConfiguredDatabases |
可选 |
开关参数 |
从 Lync Server 2010 拓扑中读取信息,并将必需的数据库安装在指定的 SQL Server 计算机或 SQL Server 群集中。在指定要安装的数据库时,需要调用 Install-CsDatabase 的管理员几乎总是使用此参数。 |
DatabasePaths |
可选 |
字符串 |
指定可用于存储数据和日志文件的驱动器和文件夹;例如:-DatabasePaths "D:\Logs", "E:\Data"。 |
DatabaseType |
可选 |
字符串 |
用于将特定数据库安装在特定 SQL Server 计算机或 SQL Server 群集中。一般而言,管理员不应运行带有 DatabaseType 参数的 Install-CsDatabase,除非 Microsoft 支持人员另行指示。管理员通常应使用 ConfiguredDatabases 参数。DatabaseType 参数要求您知道拓扑中使用的每个数据库的准确类型和位置,并且仅当 Install-CsDatabase 命令使用 ConfiguredDatabases 参数运行失败时,才需要 DatabaseType 参数。 DatabaseType 的有效值包括: Application Archiving Monitoring Provision User |
ExcludeCollocatedStores |
可选 |
开关参数 |
存在此参数时,将会阻止生成一条警告消息,即,告知您所有并置的数据库存储都必须安装在本地计算机上。 |
ForDefaultInstance |
可选 |
开关参数 |
指定了此参数时,将指示 Install-CsDatabase 仅针对默认 SQL Server 实例运行。不能在同一个命令中同时使用 ForDefaultInstance 和 ForInstance。 |
ForInstance |
可选 |
字符串 |
指定了此参数时,将指示 Install-CsDatabase 仅针对指定的 SQL Server 实例运行。不能在同一个命令中同时使用 ForInstance 和 ForDefaultInstance。 |
GlobalCatalog |
可选 |
字符串 |
域中的全局编录服务器的完全限定域名 (FQDN)。如果要使用您域中的帐户在计算机上运行 Install-CsDatabase,则不必指定此参数。 |
GlobalSettingsDomainController |
可选 |
字符串 |
用于存储全局设置的域控制器的完全限定域名 (FQDN)。如果全局设置存储在 Active Directory 域服务 (AD DS) 的“系统”容器中,则此参数必须指向根域控制器。如果全局设置存储在“配置”容器中,则可以使用任何域控制器,并且可以省略此参数。 |
LocalDatabases |
可选 |
开关参数 |
如果包括了此参数,则 Install-CsDatabase 将会读取 Lync Server 2010 拓扑,并根据需要在本地计算机上安装数据库和存储。 |
SkipPrepareCheck |
可选 |
开关参数 |
存在此参数时,将会导致 Install-CsDatabase 放弃其初始准备检查。 |
SqlInstanceName |
可选 |
字符串 |
要在其中安装数据库的数据库实例的名称。数据库实例就是一组正在运行的进程,用于提供对数据库文件的访问。如果省略此参数,则 Install-CsDatabase 将使用默认 SQL Server 实例。 |
SqlServerFqdn |
可选 |
字符串 |
要在其中安装数据库的计算机的完全限定域名 (FQDN)。例如:-SqlServerFqdn atl-sql-001.litwareinc.com。 |
Update |
可选 |
开关参数 |
存在此参数时,将会更新现有数据库。不能在同一个命令中同时使用 Update 和 Clean。 |
UseDefaultSqlPaths |
可选 |
开关参数 |
指定了此参数时,将指示 SQL Server 选择将用于存储数据和日志文件的驱动器。 |
Force |
可选 |
开关参数 |
存在此参数时,将会强制安装新数据库,即使该类型的现有数据库当前正在使用亦如此。 |
Report |
可选 |
字符串 |
用于指定在该 cmdlet 运行时创建的日志文件的文件路径。例如:-Report "C:\Logs\InstallDatabases.html" |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Install-CsDatabase 不接受通过管道传递的输入。
返回类型
Install-CsDatabase 不会返回任何值或对象。
示例
-------------------------- 示例 1 --------------------------
Install-CsDatabase -ConfiguredDatabases -SqlServerFqdn atl-sql-001.litwareinc.com -DatabasePaths "E:\CSLog","F:\CSLog","G:\CSDB"
在示例 1 中,Install-CsDatabase 在 Lync Server 2010 拓扑中读取信息,然后将所有必需的数据库安装在池 atl-sql-001.litwareinc.com 中。
-------------------------- 示例 2 --------------------------
Install-CSDatabase -CentralManagementDatabase -SqlServerFqdn atl-sql-001.litwareinc.com -SqlInstanceName rtc -DatabasePaths "G:\CSDB"
示例 2 中显示的命令将中央管理存储安装在池 atl-sql-001.litwareinc.com 中。该数据库将安装在 rtc 实例中,并且使用文件夹 G:\CSDB。