Ferramenta de linha de comando Stsadm (Windows SharePoint Services)
Atualizado em: 2009-10-22
Neste artigo:
Usando Stsadm
Stsadm não é interativo
Operações e propriedades disponíveis
O Windows SharePoint Services 3.0 inclui a ferramenta Stsadm para a administração via linha de comando de servidores e sites do Windows SharePoint Services. Stsadm está localizada 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 Stsadm.
O recurso Stsadm fornece um método de execução de tarefas administrativas do Windows SharePoint Services 3.0 na linha de comando ou com o uso de arquivos de lote ou scripts. Stsadm fornece acesso a operações não disponíveis com o uso do site 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 Stsadm
A ferramenta de linha de comando fornece acesso a todo o conjunto de operações do Windows SharePoint Services 3.0. Você pode usar o Stsadm na linha de comando ou com arquivos de lote ou scripts. O recurso 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ê chama o Stsadm, fornece uma operação e um conjunto de parâmetros de linha de comando sob a forma:
-operation OperationName -parameter value
Dica
Se um valor que você precise usar 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ê pode colocar a sequência de caracteres entre aspas ("). Por exemplo, se a URL de um site for http://my site, você pode inseri-la como "http://my site".
A maioria dos parâmetros de linha de comando também tem uma forma curta 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 use Server1_collab em Server1 e especifica o nome de usuário e a senha do banco de dados para conexão com:
stsadm -o setconfigdb -connect -ds Server1 -dn Server1_collab -du User1 -dp password
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 Windows SharePoint Services 3.0 e um banco de dados de configuração. |
-connect |
Especifica que já há um banco de dados de configuração a ser usado. |
-ds Server1 |
Especifica o nome do servidor que contém o banco de dados a ser usado. |
-dn Server1_collab |
Especifica o nome do banco de dados a ser usado nesse servidor. |
-du User1 |
Especifica um nome de usuário de administrador para o banco de dados. |
-dp password |
Especifica a senha do usuário. |
Stsadm não é interativa
Stsadm não é uma ferramenta interativa. Com Stsadm, você digita a operação e os parâmetros todos de uma vez. Você não será solicitado a preencher 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 da Stsadm, consulte Índice das operações e propriedades de Stsadm (Windows SharePoint Services).
As operações a seguir estão disponíveis somente 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 |
Parâmetros 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 (Windows SharePoint Services)