wscript

  • Artigo

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

O Host do Windows Script 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 registrado. Por exemplo, se você tentar executar este comando:
cscript test.admin
Você receberá esta mensagem de erro: Erro de entrada: não há mecanismo de script para a extensão de arquivo .admin.
Uma vantagem de usar extensões de nome de arquivo não padrão é que isso protege contra a seleção dupla acidental de um script e a execução de algo indesejado.
Usar essa extensão não cria uma associação permanente entre a extensão de nome de arquivo .admin e o VBScript. Sempre que você executar um script que usa uma extensão de nome de arquivo .admin, será necessário 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 é o comportamento 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 seja 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 seja exibida antes da execução do script. O parâmetro /nologo é o oposto de /logo.
/s Salva as opções do 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 é sem limite de tempo.
/x Inicia o script no depurador.
ScriptArguments Especifica os argumentos passados ao script. Cada argumento de script deve ser precedido por uma barra (/).
/? Exibe a ajuda no prompt de comando.

Comentários

  • A execução desta tarefa não exige que você possua credenciais administrativas. Considere executar essa tarefa como um usuário sem credenciais administrativas, como uma melhor prática de segurança.
  • Para abrir um prompt de comando, na tela Inicial, digite cmd e selecione 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 de Script do Windows. Use a caixa de diálogo para definir propriedades de script global para todos os scripts que wscript.exe executa no computador local.
  • O parâmetro /t impede a execução excessiva de scripts definindo um temporizador. Quando o tempo excede o valor especificado, wscript interrompe o mecanismo do 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 os arquivos desse tipo de arquivo.
  • É possível definir propriedades para scripts individuais. Para obter mais informações sobre o Host de Script do Windows, confira 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.