Referência de linha de comando para o Assistente de Configuração de Produtos e Tecnologias do SharePoint (Office SharePoint Server)

Atualizado em: 2008-04-17

Em Produtos e Tecnologias do SharePoint, você poderá usar a ferramenta de linha de comando psconfig.exe como uma interface alternativa para executar diversas operações que controlam a forma como se configura os Produtos e Tecnologias do SharePoint. Você deve ser membro do grupo Administradores no computador local para executar essas operações.

Neste artigo

  • Como usar os comandos de psconfig.exe

  • Comandos e parâmetros disponíveis

Como usar os comandos de psconfig.exe

Quando você executa o psconfig.exe pela linha de comando, pode especificar comandos para controlar a forma como a ferramenta é executada. Para executar psconfig.exe na linha de comando, navegue até a pasta %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\bin e digite os comandos usando a seguinte sintaxe:

Psconfig.exe -cmd <command> [optional parameters]

A tabela de referência da próxima seção contém vários exemplos. Também há Ajuda disponível a partir da interface da linha de comando. Para exibi-la, digite na linha de comando:

psconfig.exe -?

Para obter Ajuda sobre um comando específico, digite:

psconfig.exe -help <command name>

Os comandos em psconfig.exe precisam ser executados em uma ordem específica para funcionarem corretamente. Se você usar o Assistente de Configuração de Produtos e Tecnologias do SharePoint para configurar a sua instalação, ele chamará os comandos (também conhecidos como tarefas de configuração) na ordem correta. No entanto, se você usar a linha de comando para executar psconfig.exe, precisará garantir a execução das tarefas na ordem correta. Os comandos de psconfig.exe devem ser executados na seguinte ordem:

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (somente para instalações autônomas)

  8. applicationcontent

  9. upgrade

Importante

Se o psconfig.exe detectar que o farm de servidores precisa ser atualizado, iniciará automaticamente uma atualização ao ser executado (mesmo se você não tiver escolhido o comando upgrade).

Você pode especificar que todos os comandos sejam executados em uma única sequência de linha de comando. Se você fizer isso, o psconfig.exe executará todos os comandos na ordem correta. Por exemplo, na linha de comando, você poderá executar um comando semelhante a:

psconfig.exe –cmd configdb <parameters>
–cmd helpcollections <parameters>
–cmd secureresources <parameters>
–cmd services <parameters>
–cmd installfeatures <parameters>
–cmd adminvs <parameters>
–cmd evalprovision <parameters>
–cmd applicationcontent <parameters>

Comandos e parâmetros disponíveis

No Assistente de Configuração de Produtos e Tecnologias do SharePoint, as opções de linha de comando a seguir são reconhecidas.

Comando Descrição, parâmetros e exemplos

?

Exibe os comandos disponíveis para uso com psconfig.exe.

Exemplo

psconfig.exe -?

help <command name>

Exibe os comandos disponíveis para uso com psconfig.exe. Se um nome de comando for especificado, exibirá ajuda para esse comando.

Exemplo

psconfig.exe -help adminvs

adminvs

Gerencia o aplicativo Web da Administração Central do SharePoint no computador local. Utiliza os seguintes parâmetros opcionais:

[-provision]

Configura o aplicativo Web da Administração Central do SharePoint neste servidor. A configuração cria um novo aplicativo Web da Administração Central do SharePoint e um pool de aplicativos executado sob a conta do administrador do farm de servidores.

[-unprovision]

Desconfigura o aplicativo Web da Administração Central do SharePoint neste servidor. A desconfiguração remove o aplicativo Web da Administração Central do SharePoint e seu pool de aplicativos.

[-port <port number>]

A porta do aplicativo Web da Administração Central do SharePoint é uma configuração global do farm de servidores. Ao alterar a porta, um trabalho do serviço Timer do SharePoint é expedido para sincronizar a porta em todos os aplicativos Web da Administração Central do SharePoint no farm de servidores. Caso uma porta não seja especificada, a porta usada para os aplicativos Web da Administração Central do SharePoint existentes no farm de servidores será usada. Se um aplicativo Web da Administração Central do SharePoint não tiver sido configurado no farm de servidores, a porta padrão escolhida será aleatória caso não seja especificada.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

O provedor de autenticação do aplicativo Web da Administração Central do SharePoint é uma configuração global do farm de servidores. Ao alterar o provedor de autenticação, um trabalho do serviço Timer do SharePoint é expedido para sincronizar o provedor em todos os aplicativos Web da Administração Central do SharePoint do farm de servidores. Se onlyusentlm for especificado, o NTLM será o provedor de autenticação exclusivo para todos os aplicativos Web da Administração Central do SharePoint. Todos os outros provedores de autenticação serão desabilitados e o NTLM será o único permitido. Se enablekerberos for especificado, a autenticação Kerberos será habilitada para todos os aplicativos Web da Administração Central do SharePoint. Se um provedor de autenticação não for especificado, o provedor usado para os aplicativos Web da Administração Central do SharePoint existentes no farm de servidores será usado. Se um aplicativo Web da Administração Central do SharePoint não tiver sido configurado no farm de servidores, o provedor de autenticação Kerberos será habilitado caso um provedor de autenticação não seja especificado.

Exemplos

psconfig.exe -cmd adminvs -provision -port 8080 -windowsauthprovider onlyusentlm

psconfig.exe -cmd adminvs -unprovision

applicationcontent

Gerencia conteúdo de aplicativo compartilhado. Usa os seguintes parâmetros obrigatórios:

-install

Copia dados de aplicativos compartilhados (por exemplo, arquivos de recurso, binários de aplicativo Web) para diretórios virtuais de aplicativo Web.

Exemplo

psconfig.exe -cmd applicationcontent -install

configdb

Cria, conecta ou desconecta este servidor do farm de servidores. Utiliza os seguintes parâmetros opcionais:

[-create]

Cria um novo banco de dados de configuração e estabelece um novo farm de servidores. Se esse servidor já estiver conectado a um banco de dados de configuração, o servidor será desconectado primeiro e depois o novo banco de dados de configuração será criado.

[-disconnect]

Desconecta este servidor do banco de dados de configuração e depois desconecta este servidor do farm de servidores.

[-connect]

Conecta-se a um banco de dados de configuração existente e depois adiciona este servidor a um farm de servidores existente. Se este servidor já estiver conectado a um banco de dados de configuração, o servidor será desconectado primeiro e depois conectado ao banco de dados de configuração existente.

[-server <SQLServerName>]

O computador executando o SQL Server onde o banco de dados de configuração está localizado.

[-database <SQLDatabaseName>]

O nome do banco de dados de configuração.

[-dbuser <value>]

O nome de usuário usado para autenticação SQL.

[-dbpassword <value>]

A senha usada para autenticação SQL.

[-user <Domain\User>]

A conta de usuário do administrador do farm de servidores.

[-password <Password>]

A senha da conta de usuário do administrador do farm de servidores.

[-addomain <value>]

O nome do domínio do Active Directory usado para o farm de servidores.

[-adorgunit <value>]

O nome da unidade organizacional do Active Directory usado para o farm de servidores.

[-admincontentdatabase <SQLAdminContentDatabaseName>]

O nome do banco de dados de conteúdo do aplicativo Web da Administração Central.

Exemplos

psconfig.exe -cmd configdb -create -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

-user <DOMAIN\username> -password <password>

-addomain <domain_name> -adorgunit <org_unit>

-admincontentdatabase <Database_name>

psconfig.exe -cmd configdb -disconnect

psconfig.exe -cmd configdb -connect -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

evalprovision

Configura este servidor como um servidor autônomo (modo de avaliação). Utiliza os seguintes parâmetros obrigatórios e opcionais:

-provision

Executa configuração de modo autônomo neste servidor.

[-port <port number>]

O número da porta atribuído ao aplicativo Web padrão do SharePoint. Se não especificado, a porta 80 será usada. Se um aplicativo Web do SharePoint já existir e estiver usando a porta, o site existente será substituído. Se um site existente estiver usando a porta e se não for um aplicativo Web do SharePoint, o site será desabilitado e um novo aplicativo Web do SharePoint será criado usando a porta.

[-overwrite]

Especifica se será preciso substituir qualquer site existente do Microsoft Windows SharePoint Services 3.0 durante a instalação. Se não especificado, o site não será excluído.

Exemplo

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

Gerencia conjuntos de ajuda. Usa os seguintes parâmetros obrigatórios:

-installall

Instala todos os conjuntos de ajuda disponíveis.

Exemplo

psconfig.exe -cmd helpcollections -installall

installfeatures

Registra qualquer recurso dos Produtos e Tecnologias do SharePoint localizado no sistema de arquivos deste servidor no farm de servidores.

Exemplo

psconfig.exe -cmd installfeatures

quiet

Executa o Assistente de Configuração de Produtos e Tecnologias do SharePoint em modo silencioso. A saída é gravada no arquivo de log chamado PSCONFIG.EXE_MM_DD_AA_HH_MM_SS_MS.log, onde "_MM_DD_AA_HH_MM_SS_MS" é a data e a hora completas em que o utilitário foi executado. O arquivo de log é armazenado no diretório %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\LOGS.

Exemplo

psconfig.exe -cmd quiet

secureresources

Executa a imposição de segurança de recurso dos Produtos e Tecnologias do SharePoint no servidor. Por exemplo, a segurança é imposta em arquivos, pastas e chaves do registro.

Exemplo

psconfig.exe -cmd secureresources

services

Gerencia serviços dos Produtos e Tecnologias do SharePoint. Utiliza os seguintes parâmetros opcionais:

[-install]

Registra os serviços no farm de servidores localizado neste servidor.

[-provision]

Configura os serviços localizados neste servidor e os define como online caso os Produtos e Tecnologias do SharePoint tenham sido instalados no modo autônomo. A configuração de serviços também garante que eles sejam registrados.

Exemplo

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

Executa a configuração dos Produtos e Tecnologias do SharePoint com base no modo de instalação. Também repara a configuração. Se o produto ou a tecnologia foi instalado em modo autônomo, a configuração autônoma será concluída. Se o produto ou a tecnologia não estiver em modo autônomo, você deverá concluir a configuração inicial usando o Assistente de Configuração de Produtos e Tecnologias do SharePoint, em vez do utilitário de linha de comando psconfig.exe. Para executar o assistente, no menu Iniciar, aponte para Todos os Programas, Ferramentas Administrativas e clique em Assistente de Configuração de Produtos e Tecnologias do SharePoint.

Se você quiser reparar uma instalação autônoma, execute primeiro setup /repair (para obter mais informações, consulte o sistema de Ajuda da Instalação) e depois -setup de psconfig.exe. Para instalações de farm de servidores, depois de executar setup /repair, use o Assistente de Configuração de Produtos e Tecnologias do SharePoint, em vez do utilitário de linha de comando psconfig.exe.

Utiliza o seguinte parâmetro opcional:

[-lcid <1033>]

O ID de localidade (LCID) que especifica o idioma de instalação.

Exemplo

psconfig.exe -cmd setup

standaloneconfig

Executa uma configuração autônoma para os Produtos e Tecnologias do SharePoint. Utiliza os seguintes parâmetros opcionais:

[-lcid <1033>]

O ID de localidade (LCID) que especifica o idioma de instalação.

Exemplo

psconfig.exe -cmd standaloneconfig

upgrade

Executa uma atualização dos Produtos e Tecnologias do SharePoint. Esse comando será automaticamente executado durante a execução do Assistente de Configuração de Produtos e Tecnologias do SharePoint, caso o produto ou a tecnologia precise ser atualizado. Utiliza os seguintes parâmetros opcionais:

[-wait]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint não retornará até a conclusão da atualização. Se não especificado, o assistente retornará depois da expedição de um trabalho do Serviço Timer do SharePoint para executar a atualização. Para exibir o status do trabalho de atualização, você pode acessar o aplicativo Web da Administração Central do SharePoint usando seu navegador da Web.

[-force]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint interromperá qualquer ação de atualização em execução e reiniciará a atualização.

[-reghostonupgrade]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint redefinirá todo o conteúdo da versão de definição do site durante a atualização.

[-finalize]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint finalizará a atualização atual. Execute esta ação somente depois de atualizar todos os sites e não precisar mais de uma conexão à versão anterior. Você não será capaz de desfazer essa ação.

[-inplace <v2v|b2b>]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint executará uma atualização no local. Se v2v for especificado, uma atualização no local de versão a versão será executada. Se b2b for especificado, uma atualização no local de compilação a compilação será executada.

[-sidebyside]

Se especificado, o Assistente de Configuração de Produtos e Tecnologias do SharePoint executará uma atualização gradual.

Exemplos

psconfig.exe -cmd upgrade -inplace v2v -wait
psconfig.exe -cmd upgrade -sidebyside -reghostonupgrade
psconfig.exe -cmd upgrade -finalize

Baixar este manual

Este tópico está incluído no seguinte manual baixável para facilitar a leitura e a impressão:

Consulte a lista completa de livros disponíveis no site de manuais que podem ser baixados do Office SharePoint Server 2007.