Partilhar via

wscript

Aplica-se a: Windows Server (Todas as versões suportadas)

O Windows Script Host fornece um ambiente no qual os usuários podem executar scripts em várias linguagens que usam vários modelos de objeto para executar tarefas.

Sintaxe

wscript [<scriptname>] [/b] [/d] [/e:<engine>] [{/h:cscript|/h:wscript}] [/i] [/job:<identifier>] [{/logo|/nologo}] [/s] [/t:<number>] [/x] [/?] [<ScriptArguments>]

Parâmetros

Parâmetro Descrição
scriptname Especifica o caminho e o nome do arquivo de script.
/b Especifica o modo em lote, que não exibe alertas, erros de script ou prompts de entrada. O parâmetro /b é o oposto de /i.
/d Inicia o depurador.
/e Especifica o mecanismo usado para executar o script. Esse parâmetro permite executar scripts que usam uma extensão de nome de arquivo personalizada. Sem o parâmetro /e, você só pode executar scripts que usam extensões de nome de arquivo registradas. Por exemplo, se você tentar executar este comando:
cscript test.admin
Você recebe esta mensagem de erro: Erro de entrada: Não há nenhum mecanismo de script para extensão .adminde arquivo .
Uma vantagem de usar extensões de nome de arquivo não padrão é que ele protege contra a seleção dupla acidental de um script e a execução de algo que você realmente não queria executar.
Usar essa extensão não cria uma associação permanente entre a extensão de nome de arquivo e VBScript .admin . Cada vez que você executa um script que usa uma extensão de nome de .admin arquivo, você precisa usar o parâmetro /e.
/h:cscript Registra cscript.exe como o host de script padrão para executar scripts.
/h:wscript Registra wscript.exe como o host de script padrão para executar scripts. Esse comportamento é o padrão quando a opção /h é omitida.
/i Especifica o modo interativo, que exibe alertas, erros de script e prompts de entrada.
O parâmetro /i é o padrão e o oposto de /b.
/job:\<identifier> Executa o trabalho identificado pelo identificador em um arquivo de script .wsf .
/logo Especifica que o banner do Windows Script Host é exibido no console antes da execução do script.
O parâmetro /logo é o padrão e o oposto de /nologo.
/nologo Especifica que o banner do Windows Script Host não é exibido antes da execução do script. O parâmetro /nologo é o oposto de /logo.
/s Salva as opções atuais do prompt de comando para o usuário atual.
/t:\<number> Especifica o tempo máximo que o script pode ser executado (em segundos). Você pode especificar até 32.767 segundos.
O padrão é sem limite de tempo.
/x Inicia o script no depurador.
ScriptArguments Especifica os argumentos passados para o script. Cada argumento de script deve ser precedido de uma barra (/).
/? Exibe a Ajuda no prompt de comando.

Observações

  • A execução dessa tarefa não exige que você tenha credenciais administrativas. Considere executar essa tarefa como um usuário sem credenciais administrativas como uma prática recomendada de segurança.
  • Para abrir um prompt de comando, na tela Iniciar , digite cmd e selecione prompt de comando.
  • Cada parâmetro é opcional. No entanto, não é possível especificar argumentos de script sem especificar um script. Se você não especificar um script ou nenhum argumento de script, wscript.exe exibirá a caixa de diálogo Configurações do Host de Scripts do Windows . Use a caixa de diálogo para definir propriedades de script globais para todos os scripts que wscript.exe executados no computador local.
  • O parâmetro /t evita a execução excessiva de scripts definindo um temporizador. Quando o tempo excede o valor especificado, wscript interrompe o mecanismo de script e termina o processo.
  • Os arquivos de script do Windows geralmente têm uma das seguintes extensões de nome de arquivo: .wsf, .vbs.js.
  • Se você selecionar duas vezes um arquivo de script com uma extensão que não tenha associação, a caixa de diálogo Abrir com será exibida. Selecione wscript ou cscript e, em seguida, selecione Sempre usar este programa para abrir este tipo de arquivo. Isso registra wscript.exe ou cscript.exe como o host de script padrão para arquivos desse tipo de arquivo.
  • Você pode definir propriedades para scripts individuais. Para obter mais informações sobre o Windows Script Host, consulte Visão geral do Windows Script Host.
  • O Windows Script Host pode usar arquivos de script .wsf . Cada arquivo .wsf pode usar vários mecanismos de script e executar vários trabalhos.