Install-CsDatabase
Tópico modificado em: 2012-03-23
Instala um ou mais bancos de dados do Microsoft Lync Server 2010.
Sintaxe
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>]]
Descrição Detalhada
O Lync Server 2010 faz extenso uso de bancos de dados do SQL Server, desde o Repositório de Gerenciamento Central até o Banco de dados de arquivamento. Como regra geral, esses bancos de dados são configurados ao mesmo tempo que se instala o Lync Server 2010 ou uma função do Lync Server 2010 (como Servidor de Monitoramento) que exija um back-end de banco de dados. Depois que essa instalação tiver se processado, esses bancos de dados normalmente não precisarão ser reinstalados ou transferidos para novos locais.
Em raras ocasiões, no entanto, poderá ser necessário instalar manualmente um banco de dados do Lync Server 2010 por causa da necessidade de se transferir um banco de dados para outro servidor ou se um problema relacionado à instalação tiver causado uma falha na instalação do banco de dados. O cmdlet Install-CsDatabase permite instalar qualquer banco de dados do SQL Server usado pelo Lync Server 2010.
Ao se executar Install-CsDatabase, há basicamente três maneiras diferentes de gerenciar a configuração do banco de dados que estiver sendo instalado:
Opção 1 -- execute o cmdlet sem incluir um parâmetro que especifique os caminhos do banco de dados. Quando se executa Install-CsDatabase sem o parâmetro DatabasePath ou UseDefaultSqlPath, o cmdlet usa um algoritmo incorporado para selecionar o local de armazenamento dos registros e arquivos de dados do banco de dados. Observe que esse algoritmo incorporado funciona com o SQL Server independente. Ele não funcionará com um cluster do SQL Server. Para instalar um banco de dados em um cluster do SQL Server, o comando deverá incluir o parâmetro DatabasePath ou UseDefaultSqlPath.
Opção 2 -- execute o cmdlet juntamente com o parâmetro DatabasePath. Quando se executa Install-CsDatabase com o parâmetro DatabasePath, o algoritmo incorporado não é usado para selecionar o local do armazenamento dos registros e arquivos de dados do banco de dados. Em vez disso, os administradores podem selecionar o local desses registros e arquivos de dados. Para instalar os arquivos de dados e registros SQL Server no mesmo local, simplesmente especifique o caminho até a pasta na qual devem se armazenar esses dados. Por exemplo:
-DatabasePath C:\SqlData
Para armazenar arquivos de dados em um local e arquivos de registro em um outro local, especifique o caminho até cada pasta, separando os dois locais por meio de uma vírgula (evite colocar um espaço em branco antes ou depois da vírgula).
-DatabasePath C:\SqlLogs,D:\SqlData
Os arquivos de registro serão sempre armazenados no primeiro local especificado, enquanto os arquivos de dados serão armazenados no segundo local.
Em um back-end de pool, certos arquivos de registro podem ser armazenados de forma isolada em uma unidade. Se houver um back-end de pool com apenas uma unidade, os arquivos serão distribuídos da seguinte forma:
Unidade 1 – registro Rtcdyn, registro Rtc, outros registros, outros dados.
Se houver duas unidades, os arquivos serão distribuídos da seguinte forma:
Unidade 1 – registro Rtcdyn, registro Rtc.
Unidade 2 – outros registros, outros dados.
Com três unidades:
Unidade 1 – registro Rtcdyn.
Unidade 2 – registro Rtc.
Unidade 3 – outros registros, outros dados.
E com quatro unidades:
Unidade 1 – registro Rtcdyn.
Unidade 2 – registro Rtc.
Unidade 3 – outros registros.
Unidade 4 – outros dados.
Para obter mais informações e para examinar outras situações de instalação, consulte o Guia de Implantação do Lync Server 2010 Enterprise Edition.
Opção 3 -- execute o cmdlet juntamente com o parâmetro UseDefaultSqlPaths. Quando Install-CsDatabase for executado usando o parâmetro UseDefaultSqlPaths, o algoritmo incorporado não será usado para selecionar os locais de armazenamento dos registros e arquivos de dados do banco de dados. Em vez disso, o registro e os arquivos de dados serão armazenados nos locais especificados pelo caminho padrão do SQL Server (esses caminhos devem ser configurados antecipadamente por um administrador do SQL Server). Os arquivos de dados devem ser armazenados no local padrão para os arquivos de dados do SQL, enquanto os arquivos de registro são armazenados no local padrão para os arquivos de registro do SQL Server.
Antes de executar Install-CsDatabase, é necessário certificar-se de que os grupos RTCUniversalServerAdmins não receberam a atribuição de proprietários do banco de dados. Se esse grupo for listado como proprietário, o grupo possivelmente será excluído ao se chamar Install-CsDatabase.
Quem pode executar esse cmdlet: É necessário ser membro do domínio, um membro do grupo RTCUniversalReadOnlyAdmins, um administrador do SQL Server e um administrador local no computador em que o SQL Server estiver instalado para poder executar o cmdlet Install-CsDatabase localmente. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Install-CsDatabase"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
CentralManagementDatabase |
Opcional |
Parâmetro de opção |
Se esse parâmetro for incluído, Install-CsDatabase usará o parâmetro SqlServerFqdn para instalar o Repositório de Gerenciamento Central no computador especificado. Normalmente, esse parâmetro é usado apenas pelo Construtor de Topologias e é chamado somente uma vez, durante a configuração inicial. |
Clean |
Opcional |
Parâmetro de opção |
Se esse parâmetro for incluído, Install-CsDatabase excluirá e instalará novamente os bancos de dados conforme a necessidade. Se esse parâmetro não for incluído, Install-CsDatabase não substituirá qualquer banco de dados existente. Não é possível usar Clean e Update no mesmo comando. |
Collocated |
Opcional |
Parâmetro de opção |
Se houver, as funções de bancos de dados adicionais serão posicionadas conjuntamente ao Repositório de Gerenciamento Central. |
ConfiguredDatabases |
Opcional |
Parâmetro de opção |
Lê informações da topologia do Lync Server 2010 e instala os bancos de dados necessários no computador do SQL Server especificado ou no cluster do SQL Server. Os administradores que precisarem chamar Install-CsDatabase quase sempre precisarão usar esse parâmetro ao especificar os bancos de dados a serem instalados. |
DatabasePaths |
Opcional |
Cadeia de caracteres |
Especifica as unidades de disco e pastas nas quais podem ser armazenados os dados e os arquivos de log. Por exemplo: -DatabasePaths "D:\Logs","E:\Data". |
DatabaseType |
Opcional |
Cadeia de caracteres |
Permite instalar um banco de dados específico em um computador ou cluster do SQL Server específico. Via de regra, os administradores não devem executar Install-CsDatabase com o parâmetro DatabaseType, a menos que instruídos ao contrário pela equipe de suporte da Microsoft. Em vez disso, os administradores devem usar o parâmetro ConfiguredDatabases. O parâmetro DatabaseType exige que se saiba o tipo e local exatos de cada banco de dados usado na topologia, e ele será obrigatório somente se o comando Install-CsDatabase falhar ao ser executado com o parâmetro ConfiguredDatabases. Os valores válidos de DatabaseType são: Application Arquivamento Monitoramento Provisionamento User |
ExcludeCollocatedStores |
Opcional |
Parâmetro de opção |
Quando presente, suprime uma mensagem de aviso que informa que qualquer repositório de banco de dados com localização conjunta deve ser instalado no computador local. |
ForDefaultInstance |
Opcional |
Parâmetro de opção |
Quando for especificado, ele instrui Install-CsDatabase a atuar apenas em relação à instância padrão do SQL Server. Não é possível usar ForDefaultInstance e ForInstance no mesmo comando. |
ForInstance |
Opcional |
Cadeia de caracteres |
Quando for especificado, ele instrui Install-CsDatabase a atuar apenas em relação à instância especificada do SQL Server. Não é possível usar ForInstance e ForDefaultInstance no mesmo comando. |
GlobalCatalog |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) de um servidor de catálogo global no domínio. Este parâmetro não será necessário se Install-CsDatabase estiver sendo executado em um computador com uma conta no domínio. |
GlobalSettingsDomainController |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) de um controlador de domínio no qual estão armazenadas as definições globais. Se as definições globais estiverem armazenadas no contêiner Sistema do Serviços de Domínio Active Directory (AD DS), este parâmetro deverá apontar para o controlador de domínio raiz. Se as definições globais estiverem armazenadas no contêiner Configuration, qualquer controlador de domínio poderá ser utilizado e este parâmetro poderá ser omitido. |
LocalDatabases |
Opcional |
Parâmetro de opção |
Se esse parâmetro for incluído, Install-CsDatabase lerá a topologia do Lync Server 2010 e instalará bancos de dados e repositórios no computador local, conforme a necessidade. |
SkipPrepareCheck |
Opcional |
Parâmetro de opção |
Quando presente, faz com que Install-CsDatabase antecipe as verificações de preparo iniciais. |
SqlInstanceName |
Opcional |
Cadeia de caracteres |
Nome da instância do banco de dados na qual deve ser instalado o banco de dados. Uma instância de banco de dados é simplesmente um conjunto de processos em execução que fornece acesso aos arquivos do banco de dados. Se esse parâmetro for omitido, Install-CsDatabase usará a instância padrão do SQL Server. |
SqlServerFqdn |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) do computador no qual deve ser instalado o banco de dados. Por exemplo: -SqlServerFqdn atl-sql-001.litwareinc.com. |
Update |
Opcional |
Parâmetro de opção |
Quando presente, atualiza o banco de dados existente. Não é possível usar Update e Clean no mesmo comando. |
UseDefaultSqlPaths |
Opcional |
Parâmetro de opção |
Quando especificado, instrui o SQL Server a selecionar as unidades nas quais serão armazenados os dados e os arquivos de registro. |
Force |
Opcional |
Parâmetro de opção |
Quando presente, força a instalação do novo banco de dados, mesmo se já houver um banco de dados desse tipo em uso. |
Report |
Opcional |
Cadeia de caracteres |
Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\InstallDatabases.html" |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Install-CsDatabase não aceita a entrada canalizada.
Tipos de Retorno
Install-CsDatabase não retorna qualquer valor ou objeto.
Exemplo
-------------------------- Exemplo 1 ------------------------
Install-CsDatabase -ConfiguredDatabases -SqlServerFqdn atl-sql-001.litwareinc.com -DatabasePaths "E:\CSLog","F:\CSLog","G:\CSDB"
No Exemplo 1, Install-CsDatabase lê a topologia do Lync Server 2010 e, em seguida, instala todos os bancos de dados necessários no pool atl-sql-001.litwareinc.com
-------------------------- Exemplo 2 ------------------------
Install-CSDatabase -CentralManagementDatabase -SqlServerFqdn atl-sql-001.litwareinc.com -SqlInstanceName rtc -DatabasePaths "G:\CSDB"
O comando exibido no Exemplo 2 instala o Repositório de Gerenciamento Central no pool atl-sql-001.litwareinc.com. O banco de dados será instalado na instância rtc e utilizará a pasta G:\CSDB.