Ferramenta de linha de comando Stsadm (Office SharePoint Server)

Atualizado em: 2006-12-01

Neste artigo:

  • Usando o Stsadm

  • O Stsadm não é interativo

  • Operações e propriedades disponíveis

O Microsoft Office SharePoint Server 2007 inclui a ferramenta Stsadm para a administração via linha de comando de servidores e sites do Office SharePoint Server 2007. O Stsadm está localizado no caminho a seguir da unidade onde os Produtos e Tecnologias do SharePoint estão instalados: %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\bin. Você deve ser administrador no computador local para usar o Stsadm.

O Stsadm oferece um método de execução das tarefas administrativas do Office SharePoint Server 2007 na linha de comando ou usando arquivos de lote ou scripts. O Stsadm oferece acesso a operações não disponíveis usando o site da Administração Central, como a alteração da porta de administração. A ferramenta de linha de comando tem uma interface mais ágil do que a Administração Central e permite executar as mesmas tarefas. Há algumas operações e alguns parâmetros que só estão disponíveis com o uso da ferramenta de linha de comando Stsadm.

Usando o Stsadm

A ferramenta de linha de comando oferece acesso a todo o conjunto de operações do Office SharePoint Server 2007. Você pode usar o Stsadm na linha de comando ou com arquivos de lote ou scripts. O Stsadm deve ser executado no próprio servidor.

Para usar o Stsadm, você deve ser membro do grupo local de Administradores no servidor. Quando você invoca o Stsadm, fornece uma operação e um conjunto de parâmetros de linha de comando no formato:

-operação NomeDaOperação -parâmetro valor

Dica

Se um valor a ser usado com a ferramenta de linha de comando incluir um espaço ou caractere tratado como especial pela interface de linha de comando, como o E comercial (&), você poderá colocar a cadeia de caracteres entre aspas ("). Por exemplo, se a URL de um site for http://meu site, você poderá inseri-la como "http://meu site".

A maioria dos parâmetros de linha de comando também tem uma forma abreviada que pode ser usada no lugar do nome completo do parâmetro. Por exemplo, o comando a seguir define que o banco de dados de configuração usará Servidor1_colab no Servidor1 e especifica o nome de usuário e a senha do banco de dados a serem usados para a conexão:

stsadm -o setconfigdb -connect -ds Servidor1 -dn Servidor1_colab -du Usuário1 -dp senha

A tabela a seguir explica os comandos e parâmetros relativos a esse exemplo.

Comando ou parâmetro Definição

-o setconfigdb

Cria uma conexão entre o Office SharePoint Server 2007 e um banco de dados de configuração.

-connect

Especifica que já há um banco de dados de configuração a ser usado.

-ds Servidor1

Especifica o nome do servidor que contém o banco de dados a ser usado.

-dn Servidor1_colab

Especifica o nome do banco de dados a ser usado nesse servidor.

-du Usuário1

Especifica um nome de usuário de administrador para o banco de dados.

-dp senha

Especifica a senha do usuário.

O Stsadm não é interativo

O Stsadm não é uma ferramenta interativa. Com ele, você digita a operação e os parâmetros todos de uma vez. Não será solicitado o preenchimento de parâmetros ausentes durante a execução da operação. Se um parâmetro necessário estiver ausente, a operação falhará e você deverá digitar novamente a operação e os parâmetros.

Esse comportamento permite maior flexibilidade para comandos de lote, pois as ferramentas não solicitam informações após você enviar um comando. Se você desejar uma ferramenta mais interativa, experimente usar o modelo de objeto administrativo ou as páginas da Administração Central.

Operações e propriedades disponíveis

Para obter uma lista completa de operações e propriedades do Stsadm, consulte Índice das operações e propriedades de Stsadm (Office SharePoint Server).

As operações a seguir só estão disponíveis na linha de comando:

addcontentdb (a linha de comando é necessária para a adição de bancos de dados que precisam ser atualizados)

enumsolutions

renameserver

addsolution

enumtemplates

restore (nível de conjunto de sites)

addwppack

enumwppacks

retractsolution

backup (nível de conjunto de sites)

execadmsvcjobs

retractwppack

binddrservice

export

scanforfeatures

canceldeployment

forcedeletelist

setadminport

copyappbincontent

getadminport

setconfigdb

createadminvs

getproperty

setproperty

createsiteinnewdb

getsitelock

setworkflowconfig

databaserepair

import

spsearchdiacriticsensitive

deleteadminvs

installfeature

syncsolution

deleteconfigdb

migrateuser

uninstallfeature

deletesolution

provisionservice

unregisterwsswriter

deletewppack

refreshdms

updateaccountpassword

deploysolution

refreshsitedms

updatealerttemplates

deploywppack

registerwsswriter

updatefarmcredentials

displaysolution

removedrservice

upgradesolution

enumdeployments

removesolutiondeploymentlock

Os seguintes parâmetros estão disponíveis somente na linha de comando:

-force

-propertyname

-globalinstall

-propertyvalue

-newname

-servicename

-overwrite

-ssl

Consulte também

Conceitos

Índice das operações e propriedades de Stsadm (Office SharePoint Server)