Install-CsAdServerSchema
Tópico modificado em: 2012-03-23
Estende o esquema do Active Directory para permitir a instalação do Microsoft Lync Server 2010.
Sintaxe
Install-CsAdServerSchema [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Ldf <String>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Embora o Lync Server 2010 armazene a maioria de suas informações de configuração em seu próprio banco de dados, o software também se baseia no Serviços de Domínio Active Directory (AD DS) como local de armazenamento. Por exemplo: as informações relacionadas a usuários são armazenadas como parte de cada conta de usuário no Active Directory. Para fazer isso, o Lync Server 2010 deve armazenar esses valores em atributos que normalmente não fazem parte das contas comuns de usuário do Active Directory. Por sua vez, isso significa que deve-se "estender" o esquema do Active Directory: o esquema deve ser alterado, de modo a adicionar atributos personalizados (e outros itens) exigidos pelo Lync Server 2010.
A maneira mais fácil de estender o esquema do Active Directory consiste em utilizar o cmdlet Install-CsAdServerSchema. Normalmente, Install-CsAdServerSchema é executado como parte do processo de instalação do Lync Server 2010, mas, se necessário, os administradores podem executar o cmdlet a qualquer momento. Após o término da execução do cmdlet, pode se utilizar Get-CsAdServerSchema, para verificar se o esquema foi atualizado e se o Active Directory está pronto para a próxima etapa no processo de instalação.
Observe que, quando se executa o cmdlet Install-CsAdServerSchema, ele deve ter acesso ao esquema principal, a função principal de operações que gerencia o objeto do Active Directory e as definições de atributos. Se você estiver executando o Install-CsAdServerSchema em um computador diferente do esquema principal, o computador que hospeda o esquema principal deverá permitir acesso remoto ao Registro. Caso contrário, o Install-CsAdServerSchema deverá ser executado no próprio esquema principal.
As funções executadas por Install-CsAdServerSchema são similares às realizadas pelo seguinte comando do Microsoft Office Communications Server 2007 R2:
Lcscmd.exe /forest /action:SchemaPrep /SchemaType:Server
Quem pode executar este cmdlet: É necessário que você seja um administrador de esquema do Active Directory no domínio raiz e um administrador local no computador mestre de esquema para poder executar o cmdlet Install-CsAdServerSchema localmente.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
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-CsAdServerSchema estiver sendo executado em um computador com uma conta no domínio. |
GlobalSettingsDomainController |
Opcional |
Cadeia de caracteres |
FQDN de um controlador de domínio no seu domínio. Este parâmetro não será necessário se Install-CsAdServerSchema estiver sendo executado em um computador com uma conta no domínio. |
Ldf |
Opcional |
Cadeia de caracteres |
Caminho para a pasta que contém o arquivo .LDF a ser importado; o arquivo .LDF (Formato de intercâmbio de dados LDAP) contém as atualizações necessárias ao esquema do Active Directory. Se este parâmetro não for incluído, Install-CsAdServerSchema procurará o arquivo no caminho de instalação do Lync Server 2010 gravado no registro. Normalmente, o caminho da instalação será C:\Arquivos de programas\Microsoft Lync Server 2010\Deployment\Setup. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Report |
Opcional |
Cadeia de caracteres |
Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\ServerSchema.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-CsAdServerSchema não aceita entradas canalizadas.
Tipos de Retorno
Install-CsAdServerSchema não retorna qualquer valor ou objeto.
Exemplo
-------------------------- Exemplo 1 ------------------------
Install-CsAdServerSchema
O comando apresentado no Exemplo 1 determina o local do arquivo .LDF mediante a leitura da informação do registro e, em seguida, utiliza este arquivo para atualizar o esquema Active Directory.
-------------------------- Exemplo 2 ------------------------
Install-CsAdServerSchema -Ldf "C:\Schemas"
No Exemplo 2, o esquema do Active Directory é atualizado com informações retiradas de um arquivo de atualização de esquema, localizado na pasta C:\Schemas. A localização desta pasta é especificada usando-se o parâmetro Ldf.