Compartilhar via

wscript

Aplica-se a: Windows Server (todas as versões com suporte)

O Host de Script do Windows fornece um ambiente no qual os usuários podem executar scripts em vários idiomas 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 de 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 personalizado. 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 a extensão .adminde arquivo.
Uma vantagem de usar extensões de nome de arquivo não padrão é que ele protege contra selecionar acidentalmente um script e executar 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 o .admin VBScript. Cada vez que você executa um script que usa uma .admin extensão de nome de 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 a faixa do Host de Script do Windows é exibida no console antes da execução do script.
O parâmetro /logo é o padrão e o oposto de /nologo.
/nologo Especifica que a faixa do Host de Script do Windows não é exibida antes da execução do script. O parâmetro /nologo é o oposto de /logo.
/s Salva as opções de prompt de comando atuais para o usuário atual.
/t:\<number> Especifica o tempo máximo que o script pode executar (em segundos). Você pode especificar até 32.767 segundos.
O padrão não é um limite de tempo.
/x Inicia o script no depurador.
ScriptArguments Especifica os argumentos passados ao script. Cada argumento de script deve ser precedido com uma barra (/).
/? Exibe a Ajuda no prompt de comando.

Observações

  • Executar essa 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 Inicial , digite cmd e selecione o prompt de comando.
  • Cada parâmetro é opcional. No entanto, você não pode especificar argumentos de script sem especificar um script. Se você não especificar um script ou argumentos de script, wscript.exe exibirá a caixa de diálogo Configurações do Host do Script 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 impede a execução excessiva de scripts definindo um temporizador. Quando o tempo excede o valor especificado, o wscript interrompe o mecanismo de script e encerra 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 sem 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 esse 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 Host de Script do Windows, consulte a visão geral do Host de Script do Windows.
  • O Host de Script do Windows pode usar arquivos de script .wsf . Cada arquivo .wsf pode usar vários mecanismos de script e executar vários trabalhos.