Windows Script Host

Novatec Editora
www.novateceditora.com.br
Roberto G. A. Veiga
Windows
Script Host
Guia de Consulta Rpida
Guia de Consulta Rpida Windows Script Host de

Roberto G. A. Veiga.
Copyright 2000 da Novatec Editora Ltda.
Todos os direitos reservados. proibida a reproduo
desta obra, mesmo parcial, por qualquer processo, sem

prvia autorizao, por escrito, do autor e da Editora.
ISBN: 8585184825
Novatec Editora Ltda.
Rua Cons. Moreira de Barros 1084 Conj. 01

02018012 So Paulo SP Brasil
Tel.: (0xx11) 69596529
Fax: (0xx11) 69508869
Email: novatec@novateceditora.com.br
Site:www.novateceditora.com.br
Marcas registradas
Microsoft, Windows, Windows NT, Active Directory,

ActiveXeInternetInformationServersomarcasregistradas
da Microsoft Corporation nos Estados Unidos e em outros
pases.Outrasmarcassodepropriedadedeseusrespectivos
fabricantes.
3
Sumrio
Introduo .......................................................................... 5
Por que usar o WSH?................................................... 6

Instalao ..................................................................... 7
Executando um script WSH............................................... 8
Utilizando o WScript ................................................... 8
Utilizando o CScript .................................................... 8
Arquivos .WSH ................................................................. 9
Utilizao de Elementos XML ........................................ 10
Arquivos .WSF .......................................................... 10
Objetos do WSH.............................................................. 16
Objeto Wscript ........................................................... 16
Objeto WshArguments............................................... 21
Objeto WshShell ........................................................ 22
Objeto WshNetwork .................................................. 31
Objeto WshCollection ............................................... 35
Objeto WshEnvironment ........................................... 36
Objeto WshShortcut................................................... 38
Objeto WshSpecialFolders ........................................ 40
Objeto WshURLShortcut........................................... 41
Objeto Dictionary ............................................................ 43
FileSystemObject............................................................. 46
Objeto Drive .............................................................. 55
Objeto File ................................................................. 58
Objeto Folder ............................................................. 62
Objeto TextStream ..................................................... 68
Recursos Avanados ........................................................ 73
Classes WIN32 .......................................................... 73

ADSI .......................................................................... 74
Scripts de Logon ........................................................ 75
Windows Script Components..................................... 76
Criptografando Scripts do WSH ................................ 77
VBScript .......................................................................... 78
Funes, constantes e objetos do VBScript ............... 86
Objeto Err ................................................................. 87
Objeto RegExp .......................................................... 88
Informaes Adicionais ................................................... 93
Introduo
O Windows Script Host, ou simplesmente WSH, um
ambientedescriptingparaaplataformaWindowsde32bits
queveiosubstituiralinguagembatchherdadadoMSDOS.
Permite a desenvolvedores, administradores de sistemas e
consultores de informtica desenvolverem scripts para a
realizao de vrias tarefas dentro do Windows, desde as
mais simples, como exibir texto numa caixa de mensagem,
at as mais complexas, como manipular os objetos do
Active Directory via ADSI.
A principal caracterstica do WSH o fato de ser
independentedelinguagemdeprogramao,oquesignifica
que qualquer linguagem, desde que disponha de um
mecanismo de scripting (interpretador) compatvel com a
tecnologiaActiveX,podeserutilizadanodesenvolvimento
de scripts do WSH. A Microsoft oferece dois mecanismos
de scripting o do VBScript e o do JavaScript , mas
possvel encontrar outros mecanismos de scripting para
linguagenspopulares,comoPerl,TclouPython,fornecidos
por outros fabricantes.
Abaixo, um exemplo de script do WSH o qual utiliza o
VBScript como linguagem de programao que exibe a
fraseAl,mundo!numacaixademensagemdoWindows:
Exemplo
Rem Exibe a frase Al, mundo!. Para test-lo, salve como um
arquivo com
extenso .vbs e depois execute-o:
Wscript.Echo Al, mundo!
Ao executar o arquivo .vbs, ser exibida a seguinte caixa de

mensagem:
ParaosprogramadoresASP,oWSHparecerbemfamiliar.
De fato, o ASP um ambiente de scripting, ou host, para
o Microsoft Internet Information Server, assim como o
WSH,comoditoanteriormente,umambientedescripting
para a plataforma Windows. Ambos so compatveis com a
tecnologia ActiveX da Microsoft.
Introduo
EsteguiaabordaraversomaisrecentedoWSH,a2.0,que
traz consigo a verso 5.1 do Windows Script Engine e
acrescentaapossibilidadedeutilizaodalinguagemXML
no desenvolvimento de scripts.
Muita informao adicional sobre o WSH e outras
tecnologiasdescriptingdaMicrosoftpodeserobtidanosite
http://msdn.microsoft.com/scripting. esse site que voc
deveacessarembuscadenovidadessobreoWSH,incluindo
novas verses e patches de atualizao.
Existem outros sites que tambm oferecem informaes
sobre o WSH. Trs que eu sugiro so:
http://wsh.superexpert.com,
http://www.devguru.come
http://wsh.glazier.co.nz.
Por que usar o WSH?

Um script WSH pode ser executado tanto a partir do
Windows quanto a partir do prompt da linha de
comando.
WSH independente de linguagem de programao, o
que d ao desenvolvedor de scripts liberdade para
utilizarasualinguagemfavorita,desdequeelasuporte
a tecnologia ActiveX da Microsoft.

A partir da verso 2.0 do WSH, possvel utilizar a
XML,inclusivereutilizandoantigosarquivosdescript
.vbs e .js dentro de um nico arquivo .wsf.
Baixa utilizao de memria do sistema.
Mapeamento automtico de extenses de arquivo, o
que siginifca que o WSH entregar a execuo de
arquivoscomextenso.vbsdiretamenteaointerpretador
VBScript e de arquivos .js ao interpretador JScript.
No preciso nenhum programa especial para gerar
scripts do WSH, pois no so nada alm de arquivos de
texto. O bom e velho Notepad d conta do recado.
Introduo
Instalao
O WSH vem instalado por padro no Windows 98 (verso
1.0) e no Windows 2000 (verso 2.0). No Windows 95 e no
Windows NT ele deve ser instalado como um componente
adicional. O arquivo de instalao, chamado ste51en.exe
para a verso 5.1 em ingls do pacote Windows Script
Engine, pode ser baixado gratuitamente, via download, do
sitehttp://msdn.microsoft.com/scripting.
A instalao do WSH no Windows 95 ou no NT, como a de
qualquer componente extra do Windows, extremamente
rpida e descomplicada. Basta executar o arquivo de
instalao e nenhuma outra ao ser requerida do usurio
que no a de responder SIM quando for solicitado e clicar
no boto OK no final do processo. No Windows 98 e no
2000, a deciso de ter o WSH instalado ou no, pode ser
tomada na instalao do Sistema Operacional, quando
surge a janela Componentes Opcionais. O WSH pode ser
encontradodentrodeAcessriosaoclicarnobotoDetalhes.
Posteriormente,oWSHpodeserinstalado/desinstaladoem
Painel de Controle Adicionar/Remover Programas
Instalao do Windows Acessrios.
poca em que estava escrevendo este guia, a Microsoft
estava liberando a verso 5.5 do Windows Script Engine,
que tambm utiliza a verso 2.0 do WSH mas, por outro
lado, traz melhorias para os mecanismos de scripting do
VBScript e do JScript.
Introduo
Executando um script WSH

Existem duas maneiras de executar um script WSH:
Utilizando o WScript
O WScript.exe permite que os arquivos do WSH sejam
executados a partir do Windows. Para executar um arquivo
do WSH utilizando o WScript.exe, voc pode:
Dar duplo clique no arquivo.
Entrar o caminho completo e o nome do arquivo em
Iniciar Executar e clicar em OK.
Entrar Wscript.exe seguido do caminho completo e do
nome do arquivo em Iniciar Executar e clicar em
OK.
Utilizando o CScript
O CScript.exe, por outro lado, permite que os arquivos do
WSH sejam executados a partir do prompt da linha de
comando. Para usar o CScript, utilize a seguinte sintaxe:
cscript [ opes ] [ script ] [ parmetros ]
Argumento Descrio
opes
//I Habilita o modo interativo.
//B Desabilita o modo interativo; o script executado
em segundo plano.
//T:nn Habilitatime-out.Opadronolimit.Quandoalgum
valor for especificado, o script s poder ser
executado at que ele seja atingido.
//logo Exibe uma mensagem sobre o WSH.
//nologo No exibe a mensagem sobre o WSH.
//H:valor Valor tanto pode ser CScript quanto WScript. Esse
parmetro registra um ou outro como a aplicao
padro para executar scripts. Se omitido,
WScript.exe ser assumido.
//S Salvaasatuaisconfiguraesdalinhadecomando.
//? Mostra a utilizao dos comandos do CScript.exe.
//E:engine Executa o script com o mecanismo de scripting
especificado em engine.
//D Habilita o depurador.
//X Carrega o programa no depurador.
//Job:<JobID> Executa o JobID especificado em um arquivo .wsf.
script Nome do arquivo script.
parmetros Parmetros passados ao script. Devem ser
precedidos por uma barra (/).
Exemplo
Executa o script chamado x.vbs com o parmetro //nologo
e habilitando o
depurador:
C:\>cscript //nologo //D x.vbs
Executando um script WSH
Arquivos .WSH
Osarquivos.wshsoarquivosdetextoondesoarmazenadas
configuraes especficas de um script. Ele criado
automaticamente quando so alteradas as propriedades do
script conforme demonstrado abaixo.
Para criar um arquivo .wsh:
1. D um clique com o boto direito do mouse sobre um
arquivo de script.
2. No menu de contexto escolha Propriedades. Abaixo,
apginadepropriedadesdoarquivox.vbsnoambiente
Windows 2000:
3. Altere as configuraes que quiser na pgina de
propriedades.
4. Clique no boto OK.
O contedo do arquivo .wsh criado seria semelhante a este:
[ScriptFile]
Path=C:\x.vbs
[Options]
Timeout=0
DisplayLogo=1
BatchMode=0
Quando for executar o arquivo .wsh atravs da linha de
comando, ou da caixa de dilogo Executar, d duplo clique

no arquivo, que o WScript.exe ou o CScript.exe ler o
arquivo em busca das configuraes definidas para o script
ao qual o arquivo .wsh estiver associado e, s ento, o script
ser executado. importante ressaltar que a criao do
arquivo .wsh no elimina a necessidade da existncia do
arquivo de script.
Arquivos .WSH
10
Utilizao de Elementos XML

AeXtensibleMarkupLanguage(XML),emalgunspontos,
semelhante HTML, pois tambm uma linguagem de
formatao de contedo para exibio de documentos,
principalmentenaInternet.Agrandeefundamentaldiferena
que a XML no est restrita a tags predefinidas como a
HTML,oqueoferecemuitaflexibilidadeaodesenvolvedor.
A XML um padro aberto e de se esperar que sua
utilizao s aumente nos prximos anos.
Se voc no tiver muita familiaridade com a XML,
infelizmenteesteguianodeverseroseupontodepartida.
Sugiro que voc adquira o Guia de Consulta Rpida da
Novatec sobre a XML, ou ento procure informaes na
Internet, em sites como o http://www.microsoft.com/
workshop/xml ou o http://msdn.microsoft.com/xml.
Para poder usar a XML necessrio que haja um analisador
da linguagem instalado na mquina. O Windows Script
Host2.0vemcomesseanalisador.Lembresequescriptsdo
WSHqueutilizemaXMLdeveroteraextensodearquivo
.wsf.
Arquivos .WSF
Os arquivos .wsf so justamente arquivos de script que
utilizam tags XML e que podem, dentre outras coisas,
executarsimultaneamentecdigoemVBScripteemJScript.
Portanto, eles no esto atrelados diretamente a nenhum
mecanismodescriptingesocapazesdeutilizarmaisdeum
ao mesmo tempo, desde que os mecanismos de scripting
sejam compatveis com a tecnologia ActiveX. Abaixo, um
exemplo de arquivo .wsf:
<?XML version=1.0" ?>
<job>
<script language=VBScript>
<![CDATA[
Wscript.Echo Windows Script Host eh quente!
]]>
</script>
</job>
Elementos XML
11
Elementos da XML
Na tabela abaixo esto listados os elementos da linguagem
XML que podero ser usados em scripts do WSH:
Elementos Descrio
<?XML ?> Indica que um arquivo deve ser analisado por um
analisador XML.
<?job ?> Indica se o WSH dever exibir mensagens de erro
durante a execuo do script e se dever acionar o
depurador quando da ocorrncia de um erro
<job> Define um job dentro de um arquivo .wsf.
<object> Cria um objeto.
<package> Permitequemaisdeumjobsejadefinidodentrode
um arquivo .wsf.
<reference> Usada para incluir uma referncia a uma biblioteca
externa ao script.
<resource> Isola dados dentro de um arquivo de script.
<script> Insere um bloco de cdigo escrito em VBScript ou
JScript dentro de um arquivo .wsf.
<![CDATA[...]]> Evita que o analisador XML falhe ao encontrar
palavras reservadas da linguagem em cdigo de
script escrito em VBScript ou JScript.
<?XML ?>
Indicaqueumarquivodeveseranalisadoporumanalisador
XML. Deve ser inserido no incio do arquivo.
<?XML version=verso >
Parmetro Descrio
version Verso da XML sendo executada.
<?job ?>
Especificaatributosparatratamentodeerros,informando
aoWSHsedeveounoserexibidaumamensagemdeerro
durante a execuo do script e, caso ocorra algum erro, se
o depurador dever ou no ser acionado.
<?job error=varboolean debug=varboolean ?>
Parmetro Descrio
error Booleano. Habilita (True) ou no (False) a exibio de
mensagens de erro durante a execuo do script.
debug Booleano. Aciona (True) ou no (False) o depurador
quando ocorrer um erro na execuo do script.
Exemplo
<job>
<?job error=true debug=true?>
WScript.Echo Ol mundo!
</script>
</job>
Elementos XML
12
<job>
Define um job dentro de um arquivo .wsf. Um job uma
tarefa a ser executada quando o script for chamado.
<job [id=JobID]>
Cdigo a ser executado
</job>
Parmetro Descrio
id Nome pelo qual ser feita referncia ao job dentro do
script e atravs do qual poder ser executado a partir
da linha de comando.
Exemplo
Utilizao da tag <job > para definir mais de um job dentro de
um arquivo .wsf:
<package>
<job id=Ol>
WScript.Echo Ol!
</script>
</job>
<job id=Adeus>
WScript.Echo Adeus!
</script>
</job>
</package>
<object>
Cria um novo objeto dentro do arquivo .wsf. Semelhante
tag de mesmo nome do HTML. A tag object define um
objeto global dentro do cdigo do script, que pode ser
acessado por cdigo escrito em VBScript ou JScript.
<object id=objID [progid=progID |
classid=clsid:GUID] />
Parmetro Descrio
id Nome pelo qual o objeto ser conhecido no script.
progid Nomedaclasseapartirdaqualpoderserdefinidoum
objeto.
classid Cdigo da classe a partir da qual poder ser definido
um objeto.
Exemplo
<job>
<object id=WshShell progid=WScript.Shell/>
<![CDATA[
WshShell.Popup WshShell eh um objeto declarado atravs da
tag <object >.
]]>
</script>
</job>
Elementos XML
13
<package>
Permite que haja mltiplos jobs dentro de um mesmo
arquivo .wsf. A utilizao de package opcional quando
h apenas um job no script.
<package>
Jobs
</package>
Exemplo
Utilizao da tag <package > em um arquivo .wsf com vrios
jobs:
<package>
<job id=Um>
WScript.Echo Job Um.
</script>
</job>
<job id=Dois>
WScript.Echo Job Dois.
</script>
</job>
<job id=Trs>
WScript.Echo Job Trs.
</script>
</job>
</package>
<reference>
Esta tag utilizada quando se quer fazer uso de objetos
existentes em uma biblioteca externa ao script.
<reference [object=progID | guid=typelibGUID]
[version=version_info] />
Parmetro Descrio
object Nome da classe a partir da qual um objeto de uma
biblioteca externa pode ser instanciado.
guid O guid da biblioteca qual est sendo feita referncia.
version Versodabibliotecaaqualestsendofeitareferncia.
Se nenhum valor for fornecido, ser assumido 1.0.
Exemplo
Utilizao da tag <reference > para acessar o objeto Recordset
do ADO:
<?XML version=1.0 ?>
<package>
<job>
<reference object=ADODB.Recordset/>
WScript.Echo adUseClient = + CStr(adUseClient)
</script>
</job>
</package>
Elementos XML
14
<resource>
Armazena dados de texto ou numricos para posterior
utilizao dentro do script.
<resource id=resourceID>
dado
</resource>
Exemplo
Utilizao da tag <resource> para armazenar um valor:
<?XML version=1.0 ?>
<job>
<resource id=mensagem>
WSH eh legal!
</resource>
strMensagem = getResource(mensagem)
WScript.Echo strMensagem
</script>
</job>
Parmetro Descrio
id Nomepeloqualserfeitarefernciaaorecursodentro
do script. Dever ser fornecido como argumento
funogetResource()paraqueseobtenhaovalordos
dados isolados pela tag.
<script>
Insereumblocodecdigodentrodoscript,especificando
tambmalinguagemqueestsendoutilizada.Semelhante
tag de mesmo nome encontrada no HTML.
<script language=linguagem [src=arquivo]>
Cdigo
</script>
Parmetro Descrio
language Especificaalinguagemaserutilizada.Atualmenteso
suportadas as linguagens VBScript e JScript.
src A localizao de um arquivo externo, contendo cdigo
de script, a ser includo no arquivo .wsf.
Elementos XML
15
<![CDATA[...]]>
<![CDATA[...]]> no propriamente uma instruo da
XML. Sua nica funo impedir que o analisador XML
falheaoanalisarumarquivo.wsfquecontenhacdigoem
VBScript ou JScript onde se encontrem palavras ou
caracteres reservados da XML.
<![CDATA[
Cdigo
]]>
Exemplos
O exemplo a seguir mostra o uso de <![CDATA[...]]> para
impedir que o
analisador XML falhe ao analisar um arquivo .wsf:
<job>
<![CDATA[
Rem eh um caractere reservado da linguagem XML
WScript.Echo Ol Mundo!
]]>
</script>
</job>
Elementos XML
16
Objetos do WSH
Um script do WSH pode fazer uso de qualquer objeto COM
registrado na mquina em que estiver sendo executado,
sendo que ele prprio fornece alguns objetos intrnsecos
que oferecem funcionalidades interessantes. So eles:
Objeto Wscript
O objeto Wscript o principal objeto fornecido pelo WSH.
Atravsdelepodemserinstanciadostodososdemaisobjetos
do WSH (WshShell, WshNetwork, WshShortcut, etc.)
utilizando o mtodo CreateObject(). Alm disso, o objeto
Wscript fornece mtodos e propriedades relacionados ao
prprio script.
Palavra-Chave
ProgID N/A.
CLSID 60254CA2-953b-11CF-8C96-00AA00B8708C.
Propriedades
Application Fornece a interface IDispatch para o objeto
Wscript.
Arguments Argumentos passados na linha de comando.
BuildVersion Retorna a build version do arquivo executvel
do WSH.
FullName Caminho completo para o executvel WSH.
Interactive Se True, o script ser executado em modo
interativo, caso False, o script ser executado
em segundo plano.
Name Nome amigvel do objeto Wscript (propriedade
padro).
Path Nome da pasta onde reside o executvel do
WSH.
ScriptFullName Caminhocompletoparaoscriptqueestsendo
executado pelo WSH.
ScriptName Nome do arquivo de script que est sendo
executado pelo WSH.
StdErr Retorna o fluxo de erro padro.
StdIn Retorna o fluxo de entrada padro.
StdOut Retorna o fluxo de sada padro.
TimeOut Especifica o tempo mximo em que o script
poder ser executado.
Version Uma string contendo a verso do WSH.
Mtodos
CreateObject Criaeestabeleceumaconexocomumobjeto.
DisconnectObject Disconecta um objeto previamente
conectado.
Echo Exibe uma caixa de mensagem.
GetObject Retorna um objeto de automao de arquivo.
Quit Terminaaexecuodoscriptcomumcdigode
erro especfico.
Sleep Interrompe a execuo do script durante um
perodo de tempo determinado.
Objetos do WSH
17
Propriedades do objeto Wscript

Application
Fornece a interface IDispatch para o objeto Wscript.
Utilizado para se fazer referncia a uma instncia do
objeto Wscript.
Set objWscript = Wscript.Application
Arguments
ForneceumacoleodeobjetosWshArguments;permite
recuperar argumentos passados para um script do WSH.
Set objArgs = Wscript.Arguments
Exemplo
Rem Exibe todos os argumentos da linha de comando:
For I = 0 to objArgs.Count - 1
Wscript.Echo objArgs(I)
Next
BuildVersion
Retorna a build version do arquivo executvel do WSH
(cscript.exe ou wscript.exe) utilizado para executar o script.
lngBuildVersion = Wscript.BuildVersion
Exemplo
Rem Exibe a build version do arquivo wscript.exe:
lngBuildVersion = Wscript.BuildVersion
Wscript.Echo lngBuildVersion
FullName
Fornece uma string contendo o caminho completo para o
executvel do WSH.
strFullName = Wscript.FullName
Exemplo
Rem Exibe o caminho completo para o Wscript.exe:
strFullName = Wscript.FullName
Wscript.Echo strFullName
Interactive
Especifica se o script ser executado em modo interativo

(True),permitindointeraocomousurio,ouemsegundo
plano (False). Em segundo plano, mtodos como Echo,
InputBox ou MsgBox no funcionaro.
Wscript.Interactive = True|False
Exemplo
Rem Exibir a frase Modo Interativo numa caixa de
mensagem, pois a
propriedade Interactive foi definida como True:
Wscript.Interactive = True
Wscript.Echo Modo Interativo
Objetos do WSH
18
Name
Fornece uma string contendo o nome amigvel do objeto
WScript. Essa a propriedade padro.
strName = Wscript.Name
Exemplo
Rem Exibe o nome amigvel do objeto Wscript:
strName = Wscript.Name
Wscript.Echo strName
Path
Fornece uma string contendo o nome da pasta onde o
executvel do WSH reside.
strPath = Wscript.Path
Exemplo
strPath = Wscript.Path
Wscript.Echo strPath
ScriptFullName
Fornece o caminho completo para o script que est sendo
executado pelo WSH.
strScriptFullName = Wscript.ScriptFullName
Exemplo
strScriptFullName = Wscript.ScriptFullName
Wscript.Echo strScriptFullName
ScriptName
Fornece o nome do arquivo de script que est sendo
executado pelo WSH.
strScriptName = Wscript.ScriptName
Exemplo
Rem Exibe o nome do script:
strScriptName = Wscript.ScriptName
Wscript.Echo strScriptName
StdErr
Retorna um objeto TextStream, que permite escrever no
fluxo de erro padro. Pode ser utilizado apenas quando o
executvel do WSH o cscript.exe.
Set objStdErr = Wscript.StdErr
StdIn
Retorna um objeto TextStream, que permite ler texto a
partir do fluxo de entrada padro. Pode ser utilizado
apenas quando o executvel do WSH o cscript.exe.
Set objStdIn = Wscript.StdIn
Objetos do WSH
19
StdErr
Retorna um objeto TextStream, que permite escrever no
fluxo de sada padro. Pode ser utilizado apenas quando
o executvel do WSH o cscript.exe.
Set objStdOut = Wscript.StdOut
TimeOut
Especifica o tempo mximo (em segundos) que um script
ter para ser executado. Quando esse limite de tempo for
atingido, o script suspender automaticamente sua
execuo.
Wscript.TimeOut = lngSegundos
Version
Fornece uma string com a verso do Windows Script que

est sendo executado.
strVerso = Wscript.Version
Mtodos do objeto Wscript

ConnectObject
Relaciona um evento de um objeto a uma rotina dentro do
script que ser executada quando da ocorrncia desse
evento.
Wscript.ConnectObject obj [,prefixo])
Parmetro Descrio
obj Nome do objeto, definido previamente pela utilizao
do mtodo CreateObject().
prefixo Prefixo que, concatenado ao caractere _ e ao nome
do evento gerado pelo objeto, forma o nome de um
procedimento dentro do script que ser chamado
quando o evento ocorrer.
Exemplo
Rem Cria uma instncia do objeto MeuObjeto e relaciona o
evento OnBegin
rotina Evento_OnBegin:
Set obj = Wscript.CreateObject(MeuObjeto)
Wscript.ConnectObject obj, Evento
Sub Evento_OnBegin
Wscript.Echo Um objeto MeuObjeto foi inicializado!
End Sub
CreateObject
Define um objeto e estabelece uma conexo com ele.
Muitos objetos (como o WshShell, o WshNetwork, etc.)
dependem diretamente da sua utilizao para serem
instanciados. Substitui a tag <object> da XML.
Set obj = Wscript.CreateObject(progID [,prefixo])
Objetos do WSH
20
Parmetro Descrio
progID Tipo do objeto a ser definido.
prefixo Chama um procedimento dentro do script cujo nome

formado por prefixo mais o caractere _, mais o nome
de um evento gerado pelo objeto.
Exemplos
Rem Criando um objeto chamado WshShell:
Dim WshShell
Set WshShell = Wscript.CreateObject(Wscript.Shell)
DisconnectObject
Disconecta um objeto previamente conectado.
Wscript.DisconnectObject obj
Echo
Exibe uma caixa de mensagem informativa na tela.
Wscript.Echo msg
Exemplo
Rem Exibe uma caixa de mensagem com os dizeres WSH
quente!:
Wscript.Echo WSH quente!
GetObject
Retorna um objeto de automao de um arquivo. Pode ser
usado para ler, alterar ou inserir dados em arquivos que
aceitem a automao OLE, tais como documentos do
Word, planilhas do Excel ou bancos de dados do Access.
Nestes casos, o mtodo GetObject() primeiro chama o
aplicativo associado ao formato do arquivo.
Set obj = GetObject(arquivo, [, progID][, prefixo])
Parmetro Descrio
arquivo Arquivodeondeserretornadooobjetodeautomao.
progID String contendo o tipo do objeto a ser retornado.
prefix Semelhanteaoparmetrodemesmonomedomtodo
CreateObject().
Exemplo
Rem Abre um arquivo do Microsoft Excel chamado exemplo.xls:
dim obj
Set obj = GetObject(C:\exemplo.xls)
Quit
Encerra a execuo do script com o cdigo de erro

correspondente.
Wscript.Quit [intCodigoDeErro]
Parmetro Descrio
intCodigoDeErro Valor ser retornado no final da execuo do
processo. Caso omitido, Quit retornar 0.
Objetos do WSH
21
Sleep
Interrompe a execuo do script durante um determinado
perodo de tempo.
Wscript.Sleep perodo
Parmetro Descrio
perodo Perodo de tempo (em milissegundos) em que a
execuo do script estar suspensa.
Exemplo
Rem A execuo do script ser suspensa por dez segundos:
Wscript.Echo Script inicializado!
Wscript.Sleep 10000
Wscript.Echo Script finalizado!
Objeto WshArguments
O objeto WshArguments retorna uma coleo contendo
todos os argumentos passados para um script do WSH. No
explicitamenteacessado,sendoinstanciadoquandosefaz
uso da propriedade Arguments dos objetos Wscript ou
WshShortcut.
Palavra-Chave
ProgID N/A.
CLSID 60254CA4-953b-11CF-8C96-00AA00B8708C.
Propriedades
Item Matriz contendo os argumentos passados na linha
de comando para o script.
Count Nmero de argumentos da linha de comando.
lenght Nmero de argumentos da linha de comando
(JScript).
Propriedades do objeto WshArguments

Item
A propriedade Item a propriedade padro do objeto
WshArguments. uma matriz que contm os argumentos
passados na linha de comando para o script, indexados a
partir de 0 (ou seja, o primeiro item tem ndice 0, o
segundo tem ndice 1 e assim por diante).
strArgs = objArgs(ndice)
Exemplo
Rem Recupera o segundo argumento passado para o script na
linha de comando:
strArgs = objArgs(1)
Wscript.Echo strArgs
Objetos do WSH
22
Count
Retornaonmerodeargumentospassadosparaoscriptna
linha de comando.
intArgs = objArgs.Count
lenght
A propriedade lenght em tudo semelhante propriedade
Count. Usada para efeitos de compatibilidade com a
linguagem JScript.
Objeto WshShell
OobjetoWshShellpermitequeosscriptsdoWSHinterajam
diretamente com o sistema operacional.
Palavra-Chave
ProgID Wscript.Shell.
CLSID F935DC22-1CF0-11d0-ADB9-00C04FD58A0B.
Propriedades
Environment Retorna um objeto WshEnvironment.
SpecialFolders Fornece acesso s pastas especiais do
Windows.
Mtodos
AppActivate Ativa a janela de um aplicativo.
CreateShortcut Cria e retorna um objeto WshShortcut ou
WshURLShortcut.
ExpandEnvironmentStrings
Expande uma varivel de ambiente do tipo
PROCESS e retorna a string correspondente.
LogEvent Salva informaes no log do Windows NT ou no
arquivo WSH.log.
Popup Exibe uma caixa de mensagem.
RegDelete Exclui uma chave ou valor do registro do Windows.
RegRead L uma chave ou valor do registro do Windows.
RegWrite EscrevechavesouvaloresnoregistrodoWindows.
Run Cria um novo processo que executa um programa
do DOS ou do Windows.
SendKeys Envia uma tecla ou conjunto de teclas para o
sistema operacional.
Objetos do WSH
23
Propriedades do objeto WshShell

Environment
Retorna um objeto WshEnvironment. O tipo do objeto
retornado, no ambiente NT, pode ser SYSTEM, USER,
VOLATILE ou PROCESS. No ambiente Windows 9x,
apenas o tipo PROCESS suportado.
Set objEnvironment = WshShell.Environment([strTipo])
strVar = objEnvironment(strVariavelDoAmbiente)
Parmetro Descrio
strTipo Tipo do objeto retornado. Pode ser SYSTEM, USER,
VOLATILE ou PROCESS no Windows NT e apenas

PROCESS no Windows 9x. Retornar SYSTEM no
Windows NT e PROCESS no Windows 9x, caso no
tenha sido especificado.
As principais variveis de ambiente so:

Nome Significado
NUMBER_OF_PROCESSORS
Nmero de processadores.
PROCESSOR_ARCHITECTURE
Tipo do processador.
PROCESSOR_IDENTIFIER
ID do processador da mquina.
PROCESSOR_LEVEL
Nvel do processador da mquina.
PROCESSOR_REVISION
Verso do processador.
OS Sistema operacional.
COMSPEC Executvel para a linha de comando.
HOMEDRIVE Drive local primrio; na maioria das vezes C:\.
HOMEPATH Diretrio padro para os usurios.
PATH VarivelPATH(amesmaencontradanoarquivo
Autoexec.bat).
PATHEXT Extensesdearquivosexecutveis(.com,.exe,
.bat, etc.).
PROMPT Prompt da linha de comando.
SYSTEMDRIVE Drivelocalondeseencontraapastadosistema.
SYSTEMROOT Pasta do sistema.
WINDIR Semelhante a SYSTEMROOT.
TMP Pasta onde so armazenados os arquivos
temporrios.
TEMP Semelhante a TMP.
Exemplo
Rem Obtm o nome do Sistema Operacional:
Set objEnvironment = WshShell.Environment(SYSTEM)
strVar = objEnvironment(OS)
Wscript.Echo strVar
Objetos do WSH
24
SpecialFolders
Forneceumobjeto,oWshSpecialFolders,atravsdoqual
possvel obterse a localizao de pastas especiais do
Windows, como a pasta Desktop, por exemplo.
strVar = WshShell.SpecialFolders(strNomeDaPasta)
Parmetro Descrio
strNomeDaPasta Nome de uma das pastas especiais do
Windows.
Pastas Especiais do Windows:
AllUsersDesktop
AllUsersStartMenu
AllUsersPrograms
AllUsersStartup
Desktop
Favorites
Fonts
MyDocuments
NetHood
PrintHood
Programs
Recent
SentTo
StartMenu
Startup
Templates
Exemplo
Rem Retorna o caminho completo para a pasta Meus
Documentos do usurio atual:
strVar = WshShell.SpecialFolders(MyDocuments)
Wscript.Echo strVar
Mtodos do objeto WshShell

AppActivate
Ativa a janela de um aplicativo em execuo.
WshShell.AppActivate strTtulo
Parmetro Descrio
strTtulo Nome que aparece na barra de ttulo do aplicativo
sendo executado.
Exemplo
Rem Escreve Ol Mundo! no Notepad:
Set WshShell = CreateObject(WScript.Shell)
WshShell.Run notepad
WScript.Sleep 200
WshShell.AppActivate Notepad
WScript.Sleep 200
WshShell.SendKeys Ol Mundo!
WScript.Sleep 2000
Objetos do WSH
25
CreateShortcut
Retornadoistiposdeobjeto:umobjetoWshShortcutpara
um atalho comum ou um objeto WshURLShortcut para
um atalho que aponta para uma URL.
Set objShortcut =
WshShell.CreateShortcut(strNomeDoAtalho)
Parmetro Descrio
strNomeDoAtalho Nomedoatalhoasercriadonareadetrabalho
do usurio ou em outra localizao. Se a
extenso for .lnk, ser criado um objeto
WshShortcut. Se for .url, ser criado um objeto
WshURLShortcut.
ExpandEnvironmentStrings
Expande uma varivel de ambiente do tipo PROCESS.
strVar = WshShell.ExpandEnvironmentStrings(string)
Parmetro Descrio
string Uma string representando uma varivel de ambiente
contida entre dois caracteres de percentagem (%).
Exemplo
Rem Exibe o nome do sistema operacional:

strVar = WshShell.ExpandEnvironmentStrings(%OS%)
Wscript.Echo strVar
LogEvent
Salva informaes no log do Windows NT ou no arquivo
WSH.log(quandooscriptforexecutadonoWindows 9x).
WshShell.LogEvent intTipo, strMsg [,strAlvo]
Parmetro Descrio
intTipo Um inteiro representando o tipo (status) do evento
ocorrido.
0 SUCESS
1 ERROR
2 WARNING
4 INFORMATION
8 AUDIT_SUCESS
16 AUDIT_FAILURE
strMsg Uma mensagem descrevendo o evento ocorrido.
strAlvo Nomedosistemaondeoeventosersalvo.Senenhum
valor for especificado, o WSH assumir o sistema
local. Vlido apenas para o Windows NT.
Objetos do WSH
26
Popup
Mostra uma caixa de mensagem na tela do computador.
Bastante semelhante funo MsgBox do VBscript.
intBoto = WshShell.Popup(strMsg [,intSegundos]
[,strTtulo] [,intTipo] )
Parmetro Descrio
strMsg Mensagemaserapresentadanacaixademensagem.
intSegundos Tempo em que a caixa de mensagem ficar na tela
antes de ser automaticamente fechada.
strTtulo Texto da barra de ttulo da caixa de mensagem. Se
omitido, ser exibido Windows Script Host.

intTipo Valor obtido pela combinao (soma) dos valores de
constantes referentes aos tipos de botes e de cones
equedeterminamaaparnciadacaixademensagem.
Botes
0 Boto OK.
1 Botes OK e Cancelar.
2 Botes Abortar, Repetir e Ignorar.
3 Botes Sim, No e Cancelar.
4 Botes Sim e No.
5 Botes Repetir e Cancelar.
cones
16 Exibe um X dentro de um crculo vermelho. Significa
a ocorrncia de um erro.
32 Exibe um ponto de interrogao. Normalmente usado
para perguntas.
48 Exibe um ponto de exclamao. Normalmente usado
para advertncias.
64 Exibe a letra I. Usado quando a caixa de mensagem
traz informaes para o usurio.
O mtodo Popup sempre retorna um inteiro, representando

o boto que foi clicado. Abaixo, uma lista dos valores que
podem ser retornados pelo mtodo:
Valores Botes
1 OK.
2 Cancelar.
3 Abortar.
4 Repetir.
5 Ignorar.
6 Sim.
7 No.
Objetos do WSH
27
RegDelete
Exclui uma chave ou valor do registro do Windows.
WshShell.RegDelete strVar
Parmetro Descrio
strVar O valor ou chave do registro a ser excludo. O mtodo
RegDelete entende que se o parmetro passado
terminar com um caractere \, dever excluir uma
chave, caso contrrio excluir um valor.
Exemplo
Rem Exclui o valor Y da chave X e depois a prpria chave X de
HKEY_LOCAL_MACHINE\Software:
WshShell.RegDelete HKLM\Software\X\Y
WshShell.RegDelete HKLM\Software\X\
Abaixo,asdenominaesabreviadasecompletasdaschaves
raiz do registro do Windows:
Abreviao Chaves-Raiz
HKCU HKEY_CURRENT_USER.
HKLM HKEY_LOCAL_MACHINE.
HKCR HKEY_CLASSES_ROOT.
HKEY_USERS
HKEY_CURRENT_CONFIG
Esses valores das chavesraiz servem tambm para os

mtodos RegRead e RegWrite, que veremos logo a seguir.
RegRead
L dados de uma chave ou valor do registro do Windows.
Tem uma limitao: s capaz de ler dados dos tipos
REG_SZ, REG_EXPAND_SZ, REG_DWORD,
REG_BINARY e REG_MULTI_SZ. Se for outro o tipo
do dado a ser lido, RegRead retornar
DISP_E_TYPEMISMATCH.
WshShell.RegRead strVar
Parmetro Descrio
strVar O valor ou chave do registro a ser lido. O mtodo
RegReadentendequeseoparmetropassadoterminar
comumcaractere\,deverlerodadodeumachave,
caso contrrio ler um valor.
Exemplo
Rem L o valor Y da chave X e depois l a prpria chave X de

WshShell.RegRead HKLM\Software\X\Y
WshShell.RegRead HKLM\Software\X\
Objetos do WSH
28
RegWrite
ComomtodoRegWrite,possvelparaumscriptdoWSH
escrever dados em chaves ou valores do registro.
WshShell.RegWrite strVar, strDado [,strTipo]
Parmetro Descrio
strVar O valor ou chave do registro onde se vai escrever um
dado.OmtodoRegWrite,comoosanteriores,entende
queseoparmetropassadoterminarcomumcaractere
\, dever escrever em uma chave, caso contrrio ir
escrever um valor.
strDado Dado a ser escrito.
strTipo Tipo do dado a ser escrito. Pode ser REG_SZ,
REG_EXPAND_SZ, REG_DWORD e REG_BINARY.
Se tentar utilizar outro tipo, ser retornado
E_INVALIDARG.
Exemplo
Rem Escreve WSH no valor Y da chave X e depois na prpria
chave X de
WshShell.RegWrite HKLM\Software\X\Y, WSH
WshShell.RegWrite HKLM\Software\X\, WSH
Run
Criaumnovoprocessoqueexecutaumarquivoexecutvel
(.exe, .com, .bat, etc.).
WshShell.Run strComando [,intEstiloDeJanela]
[,strAguardaRetorno]
Parmetro Descrio
strComando Caminho para o executvel.
intEstiloDeJanela
Estilodajaneladoexecutveldurantesuaexecuo
pelo script.
0 Esconde a janela e ativa uma outra janela.
1 Ativaeexibeumajanela.Seajanelaforminimizada
ou maximizada, o sistema restaurar seu tamanho
e posio originais. Uma aplicao deve utilizar
essa opo quando estiver exibindo uma janela
pela primeira vez.
2 Exibe a janela minimizada.
3 Exibe a janela maximizada.
4 Exibe a janela em sua posio e tamanho mais
recentemente definidos.
5 Exibe a janela em sua posio e tamanho atuais.
6 Minimiza a janela especificada e ativa a prxima
janela.
Objetos do WSH
29
7 Exibeajanelaminimizada,mantendo-acomojanela
ativa.
8 Exibe a janela em seu estado atual, mantendo-a
como janela ativa.
9 Ativaeexibeumajanela.Seajanelaforminimizada
ou maximizada, o sistema restaurar seu tamanho
e posio originais. Uma aplicao deve utilizar
essaopoquandoestiverrestaurandoumajanela
minimizada.
10 Configura a exibio da janela de acordo com o
programa que iniciou a aplicao.
strAguardaRetorno Se no especificado ou False, retornar
imediatamente ao script com um cdigo de erro
zero. Caso True,retornarqualquercdigodeerro
da aplicao que estiver sendo executada.
Exemplo
Rem Inicia o Notepad:
Set WshShell = Wscript.CreateObject(WScript.Shell)
SendKeys
Enviaumcaractereouumaseqnciadecaracteres(string)
para o Windows, como se as teclas tivessem sido
pressionadas no teclado.
WshShell.SendKeys string
Parmetro Descrio
string Caractere ou seqncia de caracteres que devem ser
enviadosparaoWindows.Pararepetirumaseqncia
vrias vezes, utilize a forma {string nmero de
repeties}. Por exemplo, {R 10} enviaria o caractere
R dez vezes.
Alguns caracteres especiais, como a tecla de espao ou a

tecla Enter, por exemplo, que no so exibidos quando
suasteclascorrespondentessopressionadas,necessitam
de uma maneira especial para poderem ser utilizados pelo
mtodo SendKeys. Essa forma especial, na maioria dos
casos, consiste em colocar o cdigo delas entre chaves
({}).
Caracteres Especiais Cdigo
BACKSPACE {BACKSPACE}, {BS} ou {BKSP}
BREAK {BREAK}
CAPS LOCK {CAPSLOCK}
DELETE {DELETE} ou {DEL}
END {END}
ENTER {ENTER} ou ~
ESC {ESC}
HELP {HELP}
HOME {HOME}
Objetos do WSH
30
INSERT {INSERT} ou {INS}
NUM LOCK {NUMLOCK}
PAGE DOWN {PGDN}
PAGE UP {PGUP}
PRINT SCREEN {PRTSC}
SCROLL LOCK {SCROLLLOCK}
SETA P/ BAIXO {DOWN}
SETA P/ DIREITA {RIGHT}

SETA P/ ESQUERDA {LEFT}
SETA P/ CIMA {UP}
TAB {TAB}
F1 {F1}
F2 {F2}
F3 {F3}
F4 {F4}
F5 {F5}
F6 {F6}
F7 {F7}
F8 {F8}
F9 {F9}
F10 {F10}
F11 {F11}
F12 {F12}
SHIFT +
CTRL ^
ALT %
Os caracteres de soma (+), percentagem (%), acento

circunflexo (^), parnteses (( )) e til (~) tambm precisam
estarentrechavesparapoderemserutilizadospelomtodo
SendKeys.
Exemplo
Rem Escreve Ol Mundo! no Notepad:
Set WshShell = CreateObject(WScript.Shell)
WScript.Sleep 200
WshShell.AppActivate Notepad
WScript.Sleep 200
WshShell.SendKeys Ol Mundo!
WScript.Sleep 2000
Objetos do WSH
31
Objeto WshNetwork
OobjetoWshNetworkpermiteaosscriptsdoWSHacessarem
os recursos de rede do Windows.
Palavra-Chave
ProgID Wscript.Network.
Propriedades
ComputerName Uma string contendo o nome do computador.
UserDomain Uma string contendo o nome do domnio do
usurio.
UserName Uma string contendo o nome do usurio.
Mtodos
AddPrinterConnection Mapeiaumaimpressoraremotaparaum
nome de recurso local.
AddWindowsPrinterConnection
Adicionaumaconexodeimpressoraao
Windows.
EnumNetworkDrives Enumera os drives de rede atualmente
mapeados.
EnumPrinterConnections Enumera os mapeamentos de
impressoras de rede atuais.
MapNetworkDrive Mapeia um compartilhamento com um
recurso local.
RemoveNetworkDrive Remove um mapeamento de rede.
RemovePrinterConnectionRemove um mapeamento para uma
impressora.
SetDefaultPrinter Determina uma impressora como sendo
a impressora padro.
Propriedades do objeto WshNetwork

ComputerName
Forneceumastringcontendoonomedocomputadoronde
o script est sendo executado.
Set WshNetwork =
Wscript.CreateObject(Wscript.Network)
strNomeComputador = WshNetwork.ComputerName
Exemplo
Rem Obtm o nome do computador:
Set WshNetwork = Wscript.CreateObject(Wscript.Network)
strComputerName = WshNetwork.ComputerName
Wscript.Echo strComputerName
Objetos do WSH
32
UserDomain
Fornece uma string contendo o nome do domnio onde
est definida a conta do usurio atualmente conectado.
Set WshNetwork =
strUserDomain = WshNetwork.UserDomain
Exemplo
Rem Obtm o nome do domnio:
strUserDomain = WshNetwork.UserDomain
Wscript.Echo strUserDomain
UserName
Forneceumastringcontendoonomedousurioatualmente
conectado mquina.
Set WshNetwork =
strUserName = WshNetwork.UserName
Exemplo
Rem Obtm o nome do usurio atual:
strUserName = WshNetwork.UserName
Wscript.Echo strUserName
Mtodos do objeto WshNetwork

AddPrinterConnection
Mapeia uma impressora remota para um recurso local do
tipo LPT1:.
Set WshNetwork =
WshNetwork.AddPrinterConnection strRecursoLocal,
strImpressoraRemota
Parmetro Descrio
strRecursoLocal Nomedorecursolocalparaoqualsermapeada
a impressora. Exemplo: LPT1:.
strImpressoraRemotaCaminho para a impressora remota, do tipo

\\nomedoservidor\nomedaimpressoracompartilhada.
Exemplo
Rem Mapeia a impressora Y no servidor X para o recurso local
LPT3:
WshNetwork.AddPrinterConnection LPT3:, \\X\Y
Objetos do WSH
33
AddWindowsPrinterConnection
Adiciona uma conexo de impressora ao Windows.
Set WshNetwork =
WshNetwork.AddWindowsPrinterConnection
strImpressora, strDriver [,strPortaDeImpressora]
Parmetro Descrio
strImpressora Caminho para a impressora remota, do tipo
\\nomedoservidor\nomedaimpressoracompartilhada.
strDriver Driver utilizado pela impressora. S poder ser
usadoquandooscriptforexecutadonoWindows
9x. No Windows NT/2000 ser ignorado pelo
WSH.
strPortaDeImpressoraPorta a ser utilizada pela impressora. A
porta
padroaLPT1:.Tambmspodeserutilizado
no Windows 9x, sendo ignorado no Windows
NT/2000.
Exemplo
Rem Adiciona a impressora Y localizada no servidor X ao
Windows:
WshNetwork..AddWindowsPrinterConnection \\X\Y
EnumNetworkDrives
Enumera todos os mapeamentos de rede da mquina em
uma matriz, instanciando um objeto WshCollection.
Set WshNetwork =
Set objDrives = WshNetwork.EnumNetworkDrives
EnumPrinterConnections
Enumeraosmapeamentosdeimpressorasdamquinaem
uma matriz, instanciando um objeto WshCollection.
Set WshNetwork =
Set objImpressoras =
WshNetwork.EnumPrinterConnections
MapNetworkDrive
Mapeia um compartilhamento em um servidor remoto
para um recurso local, por exemplo, D:.
Set WshNetwork =
WshNetwork.MapNetworkDrive strRecursoLocal,
strCompartilhamento [,fAtualizaPerfil] [,strUsurio]
[,strSenha]
Objetos do WSH
34
Parmetro Descrio
strRecursoLocal Recurso local (unidade de disco de rede) para
o qual o compartilhamento ser mapeado.
strCompartilhamento Nome do compartilhamento, do tipo
\\nomedoservidor\pastacompartilhada, a ser
mapeado.
fAtualizaPerfil SeTrue, salva o mapeamento no perfil do usurio.
strUsurio Nome do usurio que se quer utilizar para fazer
o mapeamento (caso no seja o usurio
atualmente conectado).
strSenha Senhadousurioquesequerutilizarparafazer
o mapeamento (caso no seja o usurio
atualmente conectado).
Exemplo
Rem Faz o mapeamento do compartilhamento Y no servidor X
para a unidade de
disco de rede Z::

WshNetwork.MapNetworkDrive Z:, \\X\Y
RemoveNetworkDrive
Remove um mapeamento.
Set WshNetwork =
WshNetwork.RemoveNetworkDrive strUnidadeDeDisco
[,fForado]
Parmetro Descrio
strUnidadeDeDisco Unidade de disco de rede utilizada pelo
mapeamento que se pretende desfazer.
fForado SeTrue,desfazomapeamentoindependentemente
dele estar ou no sendo utilizado no momento.
Exemplo
Rem Desfaz o mapeamento de rede do exemplo anterior:
WshNetwork.RemoveNetworkDrive Z:
RemovePrinterConnection
Semelhante ao mtodo RemoveNetworkDrive, o mtodo
RemovePrinterConnectionremoveummapeamentofeito
para uma impressora remota.
Set WshNetwork =
WshNetwork.RemovePrinterConnection strImpressora
Parmetro Descrio
strImpressora Impressora cujo mapeamento se pretende
desfazer.
Exemplo
Rem Desfaz o mapeamento para a impressora em LPT1::
WshNetwork.RemovePrinterConnection LPT1:
Objetos do WSH
35
SetDefaultPrinter
Define uma impressora como sendo a impressora padro
do Windows.
Set WshNetwork =
WshNetwork.SetDefaultPrinter strImpressora
Parmetro Descrio
strImpressora Nome da impressora que se quer definir como a
impressora padro do Windows. Note que apenas
nomes de impressora, no nomes de recursos locais
tais como LPT1:, so aceitos como argumento.
Exemplo
Rem Define a impressora \\X\Y como a impressora padro do
Windows:
WshNetwork.SetDefaultPrinter \\X\Y
Objeto WshCollection
OobjetoWshCollection noacessadoexplicitamente.
instanciado quando da utilizao dos mtodos
EnumNetworkDrives e EnumPrinterConnections do
objeto WshNetwork.
Palavra-Chave
ProgID N/A.
Propriedades
Item Matriz contendo os elementos enumerados.
Count O nmero de elementos enumerados.
lenght O nmero de elementos enumerados (JScript).
Propriedades do objeto WshCollection

Item
a propriedade padro do objeto WshCollection. uma
matriz que contm os elementos enumerados, indexados
a partir de 0 (ou seja, o primeiro item tem ndice 0, o
segundo tem ndice 1 e assim por diante).
Set WshNetwork =
Set objEnum = WshNetwork.EnumNetworkDrives
ou
Set objEnum = WshNetwork.EnumPrinterConnections
strItem = objEnum (ndice)
Objetos do WSH
36
Count
Fornece o nmero de elementos enumerados.
Set WshNetwork =
Set objEnum = WshNetwork.EnumNetworkDrives
ou
Set objEnum = WshNetwork.EnumPrinterConnections
intItens = objEnum.Count
lenght
linguagem JScript.
Objeto WshEnvironment
OobjetoWshEnvironment,assimcomooWshCollection,
no explicitamente acessado. Para usar suas trs
propriedades e seu nico mtodo, em primeiro lugar
precisoinstanciloutilizandoapropriedadeEnvironment
do objeto WshShell.
Palavra-Chave Descrio
ProgID N/A.
CLSID N/A.
Propriedades
Item Atribuiouobtmovalordeumavariveldeambiente.
Mtodo
Remove Remove uma varivel de ambiente.
Propriedades do objeto WshEnvironment

Item
a propriedade padro do objeto WshEnvironment.
Atravs dela possvel atribuir ou obter o valor de uma
varivel de ambiente. O uso da palavra Item opcional.
strVar = objEnvironment.Item(strVariavelDoAmbiente)
Parmetro Descrio
strTipo Tipo do objeto retornado. Pode ser SYSTEM, USER,
VOLATILE ou PROCESS no Windows NT e apenas
PROCESS no Windows 9x. Retornar SYSTEM no
Windows NT e PROCESS no Windows 9x, caso no
seja especificado.
Objetos do WSH
37
As principais variveis de ambiente so:

Nome Significado
NUMBER_OF_PROCESSORS
Nmero de processadores.
PROCESSOR_ARCHITECTURE
Tipo do processador.
PROCESSOR_IDENTIFIER ID do processador da mquina.
PROCESSOR_LEVEL Nvel do processador da mquina.
PROCESSOR_REVISION Verso do processador.
OS Sistema operacional.
COMSPEC Executvel para a linha de comando.
HOMEDRIVE Drive local primrio; normalmente C:\.
HOMEPATH Diretrio padro para os usurios.
PATH Varivel PATH (a mesma encontrada no
arquivo Autoexec.bat).
PATHEXT Extenses de arquivos executveis
(.com, .exe, .bat, etc.).

PROMPT Prompt da linha de comando.
SYSTEMDRIVE Drive local onde encontra-se a pasta de
sistema.
SYSTEMROOT Pasta do sistema.
WINDIR Semelhante a SYSTEMROOT.
TMP Pastaondesoarmazenadososarquivos
temporrios.
TEMP Semelhante a TMP.
Exemplo
Rem Obtm o nome do Sistema Operacional:
Set objEnvironment = WshShell.Environment(SYSTEM)
strVar = objEnvironment.Item(OS)
Wscript.echo strVar
Count
intVar = objEnvironment.Count
lenght
Count.UsadaparacompatibilidadecomalinguagemJScript.
Mtodo do WshEnvironment
Remove
Exclui uma varivel de ambiente.
Set objEnvironment =
WshShell.Environment(VOLATILE)
objEnvironment.Remove strVarivelDeAmbiente
Objetos do WSH
38
Objeto WshShortcut
O objeto WshShortcut no explicitamente acessado. Para

poder trabalhar com ele, necessrio instancilo usando o
mtodo CreateShortcut() do objeto WshShell. O objeto
WshShortcut permite a criao e a manipulao de atalhos
na rea de trabalho do usurio.
Palavra-Chave
ProgID N/A.
Propriedades
Arguments Argumentos passados para o atalho.
Description Uma descrio do atalho.
FullName Uma string contendo o caminho completo para
o atalho.
HotKey Uma tecla ou combinao de teclas que aciona
o atalho.
IconLocation A localizao do cone de um atalho.
TargetPath O arquivo alvo do atalho.
WindowsStyle O estilo da janela do atalho.
WorkingDirectory O diretrio de trabalho de um atalho.
Mtodos
Save Salva um atalho.
Propriedades do objeto WshShortcut

Arguments
RetornaumobjetoWshArguments,contendoumacoleo
de argumentos passados para o atalho.
Set objShortcut =
Set objArgs = objShortcut.Arguments
Exemplo
Rem Exibe todos os argumentos passados para o atalho criado
para o Notepad:
Set objShortcut = WshShell.CreateShortcut(c::\notepad.lnk)
Set objArgs = objShortcut..Arguments
For I = 0 to objArgs.Count - 1
Wscript.Echo objArgs(I)
Next
Description
Fornece uma descrio do atalho.
Set objShortcut =
objShortcut.Description = string
Objetos do WSH
39
FullName
atalho.
Set objShortcut =
strFullName = objShortcut.FullName
HotKey
Associa uma tecla ou combinao de teclas para acionar
um atalho.
Set objShortcut =
objShortcut.HotKey = strHotKey
Exemplo
Rem Associa as teclas Ctrl, Alt e N ao atalho criado para o
Notepad:
objShortcut.Hotkey = ALT + CTRL + N
IconLocation
Fornece a localizao do cone de um atalho.
Set objShortcut =
objShortcut.IconLocation = strCaminhoDocone
TargetPath
Fornece o caminho para o arquivo alvo do atalho.
Set objShortcut =
objShortcut.TargetPath = strAlvo
Exemplo
Rem Define o caminho para o executvel do Notepad:
objShortcut.TargetPath = c:\winnt\notepad.exe
WindowStyle
Fornece o estilo de janela de um atalho.
Set objShortcut =
objShortcut.WindowStyle = intEstiloDaJanela
Objetos do WSH
40
Os valores possveis para intEstiloDaJanela so:

Estilos de Janela Descrio
1 Ativa e exibe a janela como do tipo Normal.
3 Ativa e exibe a janela maximizada.
1 Minimiza a janela e exibe a prxima janela.
Exemplo
Rem Determina que o Notepad seja iniciado com a janela
minimizada:
objShortcut.WindowStyle = 7
WorkingDirectory
Fornece a pasta de trabalho do atalho.

Set objShortcut =
objShortcut.WorkingDirectory = strPastaDeTrabalho
Mtodo do objeto WshShortcut

Save
Salva o atalho na localizao especificada no argumento
do mtodo CreateShortcut() do objeto WshShell.
Set objShortcut = WshShell.CreateShortcut(strNomeAtalho)
objShortcut.Save
Exemplo
Rem Salva um atalho para o Notepad na unidade C:
objShortcut.TargetPath = c:\winnt\notepad.exe
objShortcut.WindowStyle = 1
objShortcut.Description = Atalho para o Notepad!
objShortcut.WorkingDirectory = c:\winnt
objShortcut.Save
Objeto WshSpecialFolders
O objeto WshSpecialFolders permite obter o caminho para
as pastas especiais do Windows. instanciado quando da
utilizaodapropriedadeSpecialFoldersdoobjetoWshShell.
Palavra-Chave
ProgID N/A.
CLSID N/A.
Propriedades
Item Matrizdeelementoscontendoocaminhocompleto
para as pastas especiais do Windows.
Objetos do WSH
41
Propriedades do objeto
WshSpecialFolders
Item
A propriedade Item a propriedade padro do objeto
WshSpecialFolders.umamatrizdeelementosquecontm
o caminho completo para as pastas especiais do Windows.
Se a pasta no existir, NULL ser retornado. O uso da
palavra reservada Item opcional, o que significa dizer
desnecessrio.
strVar = WshShell.SpecialFolders.Item(strNomeDaPasta)
Parmetro Descrio
strNomeDaPasta Especifica o nome de uma das pastas
especiais do Windows.
Count
intVar = WshShell.SpecialFolders.Count
lenght
Apropriedadelenghtemtudosemelhantepropriedade
linguagem JScript.
Objeto WshURLShortcut
OobjetoWshURLShortcuttambminstanciadoapartirda
utilizaodomtodoCreateShortcut()doobjetoWshShell.
Permite criar e manipular atalhos para URLs.
Palavra-Chave Descrio
ProgID N/A.
CLSID N/A.
Propriedades
FullName Uma string contendo o caminho completo para o
atalho.
TargetPath A URL alvo do atalho.
Mtodos
Save Salva um atalho.
Objetos do WSH
42
Propriedades do objeto
WshURLShortcut
FullName
atalho.
Set objURLShortcut =
strFullName = objURLShortcut.FullName
TargetPath
Fornece o caminho para a URL alvo do atalho.
objURLShortcut.TargetPath = strAlvo
Mtodo do objeto WshURLShortcut

Save
Salva o atalho na localizao especificada no argumento
do mtodo CreateShortcut() do objeto WshShell.
objURLShortcut.Save
Objetos do WSH
43
Objeto Dictionary
O objeto Dictionary no um objeto intrnseco ao WSH,
mas pode ser bastante til em diversas situaes. O objeto
Dictionary permite armazenar pares nome/valor
(referenciados como chave e item, respectivamente) em
uma matriz. Cada item associado a uma nica chave.
Sintaxe para a instanciao do objeto:
Set obj = CreateObject(Scripting.Dictionary)
No exemplo abaixo criado um objeto Dictionary

chamado frutas, ao qual adicionase chaves e valores.
Ao final, o script exibir uma caixa de mensagem com o
item contido na chave d.
Exemplo
Dim frutas
Set frutas = CreateObject(Scripting.Dictionary)
frutas.Add a, Laranja
frutas.Add b, Ma
frutas.Add c, Morango
frutas.Add d, Pssego
Wscript.Echo A fruta contida na chave d :
frutas.item(d)
Propriedade
CompareMode Define ou retorna o modo utilizado na
comparao
de strings.
Count RetornaonmerodeitensemumobjetoDictionary.
Item Define ou retorna um item para uma chave
especificada.
Key Defineouretornaovalordeumachaveespecificada.
Mtodos
Add Adiciona um par chave/item ao objeto Dictionary.
Exists Booleano. Retornar True se a chave especificada
existir.
Items Retorna uma matriz contendo todos os itens de um
objeto Dictionary.
Keys Retorna uma matriz contendo todas as chaves de
um objeto Dictionary.
Remove Removeumparchave/itemdeumobjetoDictionary.
RemoveAll Remove todos os pares chave/item de um objeto
Dictionary.
Objetos do WSH
44
CompareMode
A propriedade CompareMode define ou retorna o modo
utilizado na comparao de strings em um objeto
Dictionary. Disponvel somente no VBScript.
obj.CompareMode [=compara]
Argumento Descrio
compara Mododecomparaousadoporfunes
como StrComp.
vbBinaryCompare=0 Comparao binria.
vbTextCompare=1 Comparao textual.
Count
A propriedade Count retorna o nmero de itens em um
objeto Dictionary.
obj.Count
Item
A propriedade Item define ou retorna um item para uma
chave especificada em um objeto Dictionary.
obj.Item(chave)[=novoitem]
Argumento Descrio
chave Chaveassociadaaoitemqueestiversendolidoouadicionado.
novoitem Novo valor associado chave. Usado somente com
objeto Dictionary.
Key
ApropriedadeKeydefineouretornaovalordeumachave
em um objeto Dictionary.
obj.Key (chave) = novachave
Argumento Descrio
chave Chave existente.
novachave Novo valor da chave.
Add
O mtodo Add adiciona um par chave/item a um objeto
Dictionary.
obj.Add chave, item
Argumento Descrio
chave Chaveassociadaaoitemqueestiversendoadicionado.
item Item a ser adicionado.
Objeto Dictionary
45
Exists
O mtodo Exists retornar True se a chave especificada
existir no objeto Dictionary; caso contrrio, retornar
False.
obj.Exists (chave)
Argumento Descrio
chave Chave a ser pesquisada no objeto Dictionary.
Items
O mtodo Items retorna uma matriz contendo todos os
itens de um objeto Dictionary.
obj.Items
Keys
O mtodo Keys retorna uma matriz contendo todas as

chaves de um objeto Dictionary.
obj.Keys
Remove
O mtodo Remove remove um par chave/item de um
objeto Dictionary.
obj.Remove (chave)
Argumento Descrio
chave Chave a ser removida do objeto Dictionary.
RemoveAll
O mtodo RemoveAll remove todos os pares chave/item
de um objeto Dictionary.
obj.RemoveAll
Objeto Dictionary
46
FileSystemObject
OFileSystemObject,ousimplesmenteFSO,estcontidona
biblioteca scrrun.dll. O FSO permite ao desenvolvedor
interagir com o sistema de arquivos do Windows, inclusive
fornecendooutrosobjetosecoleesparatarefasespecficas,
tais como listar os drives da mquina ou copiar o contedo
de uma pasta para outra localizao.
Objetos
FileSystemObject ObjetoprincipaldoFSO.Temdeserinstanciado
antes de qualquer outro.
Drive Fornece acesso s propriedades dos drives da
mquina.
File Fornece propriedades e mtodos para
manipulao de arquivos.
Folder Fornece propriedades e mtodos para
manipulao de pastas.
TextStream Permite acessar (criar, ler e escrever) arquivos
de texto.
Colees
Drives Uma lista de todos os drives da mquina.
Files Uma lista dos arquivos contidos em uma pasta.
Folders Umalistadaspastascontidasemoutrapastaou
na raiz de um disco.
Com o FSO voc poder:

desenvolver pginas ASP e
criar scripts do WSH.
Oprimeiropassoantesdeutilizaraspropriedades,mtodos,
objetosecoleesfornecidospeloFSOinstanciaroobjeto
principal, o FileSystemObject, da seguinte forma:
Set fso = CreateObject(Scripting.FileSystemObject)
Vamosverentooqueoobjetoprincipal,oFileSytemObject,
tem a nos oferecer.
Propriedade
Drives Retorna uma coleo Drives.
Mtodos
BuildPath Anexa um nome a um caminho existente.
CopyFile Copiaumarquivoparaumlocalespecificado.
CopyFolder Copiaumapastaparaumlocalespecificado.
CreateFolder Cria uma pasta.
CreateTextFile Cria um arquivo de texto.
DeleteFile Exclui um arquivo.
DeleteFolder Exclui uma pasta.
DriveExists RetornarTrueseodriveespecificadoexistir.
FileExists Retornar True se o arquivo especificado
existir.
FileSystemObject
47
FolderExists Retornar True se a pasta especificada
existir.
GetAbsolutePathName Retorna o caminho completo para a
pasta
atual.
GetBaseName Retorna o nome de um arquivo sem a
extenso.
GetDrive Retorna um objeto Drive.
GetDriveName Retorna o nome de um drive.
GetExtensionName Retorna a extenso de um arquivo.
GetFile Retorna um objeto File.
GetFileName Retorna o nome do arquivo em um caminho
especificado.
GetFolder Retorna um objeto Folder.
GetParentFolderName Retorna a pasta onde est contida a
ltima
pasta ou arquivo de um caminho.
GetSpecialFolder Retornaocaminhoparaumapastaespecial
do Windows.
GetTempName Retorna um nome de arquivo temporrio.
MoveFile Move um arquivo para outra localizao.
MoveFolder Move uma pasta e seu contedo para outra
localizao.
OpenTextFile Abre um arquivo de texto.
Drives
Retorna uma coleo Drives onde esto contidos todos os
drives da mquina.
Set fso =CreateObject(Scripting.FileSystemObject)
Set myDrives = fso.Drives
Exemplo
Rem Exibe todos os drives da mquina:
Set myDrives = fso.Drives
For Each drive in myDrives
S = S + drive + \ + chr(10)
Next
Wscript.Echo S
BuildPath
Anexa um nome a um caminho existente.
Set fso =CreateObject(Scripting.FileSystemObject)
novocaminho = fso.BuildPath(caminho, nome)
Parmetro Descrio
caminho Caminho ao final do qual se quer adicionar um nome.

nome Nome que se quer adicionar ao caminho existente.
Exemplo
Rem Adiciona o nome de arquivo x.txt ao caminho
c:\windows\:
novocaminho = fso.BuildPath(c:\windows, x.txt)
Wscript.Echo novocaminho
FileSystemObject
48
CopyFile
Copia um ou mais arquivos para um local especificado.
fso.CopyFile origem, destino [,fSubstituir]
Parmetro Descrio
origem Caminho completo para o(s) arquivo(s) a ser(em)
copiado(s). Caracteres curinga (*) podem ser usados
no lugar do nome dos arquivos.
destino Nova localizao do(s) arquivo(s).
fSubstituir Se True, substituir os arquivos existentes na nova
localizao que tenham o mesmo nome dos arquivos
que esto sendo copiados.
Exemplo
Rem Copia o arquivo c:\x.txt para a pasta c:\windows\:
fso.CopyFile c:\x.txt, c:\windows\
CopyFolder
Copia uma pasta para um local especificado.
fso.CopyFolder origem, destino [,fSubstituir]
Parmetro Descrio
origem Caminho completo para a pasta a ser copiada.
Caracteres curinga (*) podem ser usados no lugar do
nome da pasta.
destino Nova localizao da pasta.
fSubstituir Se True, substituir os arquivos homnimos caso haja

umapastananovalocalizaocomomesmonomeda
pasta a ser copiada.
Exemplo
Rem Copia a pasta c:\teste\ para a pasta c:\windows\:
fso.CopyFolder c:\teste, c:\windows\
CreateFolder
Cria uma pasta na localizao especificada, retornando
um objeto Folder.
Set f = fso.CreateFolder(strNovaPasta)
Parmetro Descrio
strNovaPasta Caminho completo para a nova pasta a ser criada.
Ser retornado um erro caso a pasta j exista.
Exemplo
Rem Cria a pasta novapasta em c:\:
Set f = fso.CreateFolder(c:\novapasta)
FileSystemObject
49
CreateTextFile
Criaumnovoarquivodetextonalocalizaoespecificada,
retornando um objeto TextStream.
Set f = fso.CreateTextFile(strArquivoTexto [,fSubstituir]
[,unicode])
Parmetro Descrio
strArquivoTexto Caminho completo para o arquivo de texto a ser
criado.
fSubstituir Se True, substituir um arquivo homnimo pelo
arquivo que estiver sendo criado. Se False, o
arquivo original ser mantido.
unicode SeTrue,umarquivoUnicode sercriado.Se False
ou omitido, ser criado um arquivo ASCII.
Exemplo
Rem Cria um arquivo chamado x.txt em c:\:
Set f = fso.CreateTextFile(c:\x.txt, true)
DeleteFile
Exclui um arquivo.
fso.DeleteFile strArquivo [,fForado]
Parmetro Descrio
strArquivo Caminho para o arquivo a ser excludo.
fForado Booleano. Esse parmetro ter de ser True se o
arquivo a ser excludo for somente de leitura.
Exemplo
Rem Exclui o arquivo x.txt criado anteriormente:
fso.DeleteFile c:\x.txt, true
DeleteFolder
Exclui uma pasta.
fso.DeleteFolder strPasta [,fForado]
Parmetro Descrio
strPasta Caminho para a pasta a ser excluda.
fForado Booleano. Esse parmetro ter de ser True se a pasta
a ser excluda for somente de leitura.
Exemplo
Rem Exclui a pasta novapasta criada anteriormente:
fso.DeleteFolder c:\novapasta
FileSystemObject
50
DriveExists
Retornar True se o drive especificado existir.
fRetorno = fso.DriveExists(strDrive)
Parmetro Descrio
strDrive Nome do drive.
Exemplo
Rem Verifica se o drive z:\ existe:
fRetorno = fso.DriveExists(z:)
if fRetorno = True then
Wscript.Echo O drive Z:\ existe!
else
Wscript.Echo O drive Z:\ no existe!
end if
FileExists
Similar ao mtodo DriveExists(), o mtodo FileExists()
tambm retornar True se o arquivo especificado existir.
fRetorno = fso.FileExists(strArquivo)
Parmetro Descrio
strArquivo Caminho completo para o arquivo cuja existncia se
pretende averiguar.
Exemplo
Rem Verifica se o arquivo x.txt existe:
fRetorno = fso.FileExists(c:\x.txt)
Wscript.Echo O arquivo existe!
else
Wscript.Echo O arquivo no existe!
end if
FolderExists
Retornar True se a pasta especificada existir.
fRetorno = fso.FileExists(strArquivo)
Parmetro Descrio
strArquivo Caminho completo para a pasta cuja existncia se
pretende averiguar.
FileSystemObject
51
Exemplo
Rem Verifica a pasta Windows existe:
fRetorno = fso.FolderExists(c:\windows)
Wscript.Echo A pasta Windows existe!
else
Wscript.Echo A pasta Windows no existe! Provavelmente voc
instalou o
sistema em outra mquina.
end if
GetAbsolutePathName
Retorna o caminho completo da pasta atual em relao a
outra pasta.
strCaminho =
fso.GetAbsolutePathName(strEspecificao)
Parmetro Descrio
strEspecificao Umpoucodifcildeexplicarcompalavras.Observe
o exemplo abaixo.
Exemplo
Rem Partindo do princpio que a pasta atual Meus
Documentos, observe o
comportamento do mtodo GetAbsolutePathName:
strCaminho = fso.GetAbsolutePathName(c:)
Rem Vai exibibir c:\meus documentos
Wscript.Echo strCaminho
strCaminho = fso.GetAbsolutePathName(roberto)
Rem Vai exibir c:\meus documentos\roberto
strCaminho = fso.GetAbsolutePathName(c:\\\)
Rem Vai exibir c:\
GetBaseName
Retorna o nome de um arquivo sem a extenso.
strNomeDoArquivo = fso.GetBaseName(strCaminho)
Parmetro Descrio
strCaminho Caminho completo para o arquivo.

Exemplo
Rem Retorna o nome do arquivo Notepad.exe:
strNomeDoArquivo =
fso.GetBaseName(c:\windows\notepad.exe)
Wscrtpt.Echo strNomeDoArquivo
FileSystemObject
52
GetDrive
Retorna um objeto Drive.
Set objDrive = fso.GetDrive(strDrive)
Parmetro Descrio
strDrive Uma denominao aceitvel para o drive. Pode ser
uma letra, uma letra seguida de dois pontos, uma letra
seguidadedoispontosedeumabarrainvertida,ouum
nome de compartilhamento.
GetDriveName
Retorna o nome do drive contido no caminho fornecido.
strDrive = fso.GetDriveName(strCaminho)
Parmetro Descrio
strCaminho Umcaminhonaformaunidadededisco\pasta\arquivo.
O mtodo retornar justamente a unidadededisco.
GetExtensionName
Similar ao mtodo GetBaseName(), s que ele retorna
justamente a extenso de um arquivo.
strExtDoArquivo = fso.GetExtensionName(strCaminho)
Exemplo
Rem Retorna a extenso do arquivo Notepad.exe:
strExtDoArquivo =
fso.GetExtensionName(c:\windows\notepad.exe)
Wscript.Echo strExtDoArquivo
GetFile
Retorna um objeto File para um arquivo existente.
Set objFile = fso.GetFile(strArquivo)
Parmetro Descrio
strArquivo Caminho completo para o arquivo a ser retornado.
GetFileName
Retorna o nome do arquivo em um dado caminho.
strNomeDoArquivo = fso.GetFileName(strCaminho)
Parmetro Descrio
strCaminho Caminho completo para o arquivo cujo nome se
pretende obter.
FileSystemObject
53
GetFolder
Retorna um objeto Folder para uma pasta existente.
Set f = fso.GetFolder(strPasta)
Parmetro Descrio
strPasta Caminho completo para a pasta a ser retornada.
GetParentFolderName
Retorna a pasta onde est contida a ltima pasta ou
arquivo de um caminho.
strParentFolder = fso.GetParentFolderName(strCaminho)
Parmetro Descrio
strCaminho Caminho completo para uma pasta ou arquivo.

Exemplo
Rem Retorna a pasta onde est contida a pasta System do
Windows:
strParentFolder =
fso.GetParentFolderName(c:\windows\system)
Wscript.Echo strParentFolder
GetSpecialFolder
Retorna o nome de uma pasta especial do Windows.
strSpecialFolder = fso.GetSpecialFolder(intTipo)
Parmetro Descrio
intTipo
0 Pasta onde esto instalados os arquivos do Windows
(normalmente, C:\Windows ou C:\Winnt).
1 Pasta onde esto os arquivos de sistema do Windows
(normalmente, C:\Windows\System ou
C:\Winnt\System).
2 Pastaondesoarmazenadososarquivostemporrios.
GetTempName
Gera um nome aleatrio de arquivo temporrio que pode
ser usado pelo mtodo CreateTextFile() em tarefas que
exijam a utilizao de arquivos temporrios.
ArquivoTemporrio = fso.GetTempName
Exemplo
Rem Gera um nome aleatrio de arquivo temporrio para ser
utilizado pelo
mtodo CreateTextFile():
ArquivoTemporrio = fso.GetTempName
Set objFile = fso.CreateTextFile(ArquivoTemporrio)
Wscript.Echo fso.GetFileName(ArquivoTemporrio)
FileSystemObject
54
MoveFile
Move um ou vrios arquivos para outra localizao.
Semelhante a CopyFile, no entanto o(s) arquivo(s)
deixa(m) de existir na origem. Os arquivos s sero
movidos de um volume para o outro se o sistema
operacional permitir.
fso.MoveFile origem, destino
Parmetro Descrio
origem Caminho completo para o(s) arquivo(s) a ser(em)
movidos(s). Caracteres curinga (*) podem ser usados
no lugar do nome dos arquivos.
destino Nova localizao do(s) arquivo(s).
Exemplo
Rem Move o arquivo c:\x.txt para a pasta c:\windows\:
fso.MoveFile c:\x.txt, c:\windows\
MoveFolder
Moveumapastaparaoutralocalizao.Similaraomtodo
CopyFolder,noentantoapastadeixadeexistirnaorigem.
fso.MoveFolder origem, destino
Parmetro Descrio
origem Caminho completo para a pasta a ser movida.
Caracteres curinga (*) podem ser usados no lugar do
nome da pasta.
Exemplo
Rem Move a pasta c:\teste\ para a pasta c:\windows\:
fso.MoveFolder c:\teste, c:\windows\
OpenTextFile
AbreumarquivodetextoeretornaumobjetoTextStream.
Const ForReading = 1, ForWriting = 2, ForAppending = 8
Set f = fso.OpenTextFile(strArquivo [,intModoDeAbertura]

[,fCriarNovo] [,intFormato])
Parmetro Descrio
strArquivo Caminhocompletoparaoarquivodetextoaser
aberto.
FileSystemObject
55
intModoDeAbertura Indica o que poder ser feito com o arquivo
depois de aberto.
ForReading Somente leitura.
ForWriting Escrita.
ForAppending Dados sero anexados ao fim do arquivo.
fCriarNovo Booleano. Indica se dever ser criado um novo
arquivo caso strArquivo no exista. O padro
False.
intFormato UmdostrsvaloresTriStateusadosparadefinir
o formato de abertura do arquivo.
-2 TriStateUseDefault. Usa o padro do sistema
para abrir o arquivo.
-1 TriStateTrue. Abre o arquivo como Unicode.
0 TriStateFalse. Abre o arquivo como ASCII.
Exemplo
Rem Abre o arquivo c:\x.txt para escrita:
Set f = fso.OpenTextFile(c:\x.txt, ForWriting, True)
Objeto Drive
O objeto Drive instanciado atravs da utilizao do
mtodo GetDrive() do objeto FileSystemObject.
Propriedades Descrio
AvailableSpace A quantidade de espao disponvel em um drive
para o usurio.
DriveLetter A letra que representa o drive.
DriveType O tipo do drive.
FileSystem O sistema de arquivos em uso.
FreeSpace A quantidade de espao livre no drive.
IsReady Retornar True se o drive estiver pronto para ser

usado.
Path Caminho para um drive.
RootFolder Pasta raiz do drive.
SerialNumber Nmero de identificao exclusiva do volume.
ShareName Retornaocompartilhamentoderedeparaumdrive
especificado.
TotalSize A quantidade de espao em um drive.
VolumeName Define ou retorna o nome do volume.
Propriedades do objeto Drive

AvailableSpace
Retorna a quantidade de espao disponvel para o usurio
no drive especificado. Normalmente esse valor ser igual
quele retornado pela propriedade FreeSpace.
intEspao = objDrive.AvailableSpace
FileSystemObject
56
DriveLetter
Retorna a letra que representa um drive.
strLetra = objDrive.DriveLetter
DriveType
Retorna um inteiro indicando o tipo do drive.
intTipoDoDrive = objDrive.DriveType
Tipo Descrio
0 Desconhecido.
1 Removvel (disquete).
2 Fixo.
3 Drive de Rede.
4 Drive de CD-ROM.
5 Disco de RAM.
FileSystem
Retorna o nome do sistema de arquivo em uso no volume.
Os valores de retorno podem ser, tipicamente, FAT,
NTFS e CDFS.
strSistemaDeArquivo = objDrive.FileSystem
FreeSpace
Retorna a quantidade de espao livre num drive.
intEspao = objDrive.FreeSpace
IsReady
RetornarTrueseodriveestiverprontoparaoperaesde
entrada/sada. Caso contrrio retornar False.
Especialmente til para trabalhar com disquetes e CD
ROM.
fPronto = objDrive.IsReady
FileSystemObject
57
Path
Retorna o caminho para um drive.
strCaminho = objDrive.Path
RootFolder
Especifica a pasta raiz de um drive.
strPastaRaiz = objDrive.RootFolder
SerialNumber
Retornaumidentificadordecimalexclusivoparaovolume.
intID = objDrive.SerialNumber
ShareName
Retorna o compartilhamento de rede para um drive.
strCompartilhamento = objDrive.ShareName
TotalSize
Retorna a quantidade total de espao em um drive, em
bytes.
intEspaoTotal = objDrive.TotalSize
VolumeName
Retorna ou atribui um nome a um volume.
strLetra = objDrive.VolumeName
ou
objDrive.VolumeName = strLetra
FileSystemObject
58
Objeto File
O objeto File instanciado atravs da utilizao do mtodo
GetFile() do objeto FileSystemObject.
Attributes Obtm ou define atributos de um arquivo.
DateCreated Data da criao de um arquivo.
DateLastAcessed Data em que um arquivo foi acessado pela
ltima vez.
DateLastModified Data em que um arquivo foi modificado pela
ltima vez.
Drive Retorna a letra do drive onde o arquivo reside.
Name Define ou retorna o nome do arquivo.
ParentFolder Pasta onde o arquivo reside.
Path Caminho completo para o arquivo.
ShortName Nome do arquivo usando a conveno de
nomenclatura do MS-DOS (8.3).
ShortPath Caminho completo para o arquivo usando a
conveno de nomenclatura do MS-DOS.
Size Tamanho do arquivo em bytes.
Type Retorna informaes sobre o tipo do arquivo.
Mtodos Descrio
Copy Copia um arquivo para outra localizao.
Delete Exclui um arquivo.
Move Move um arquivo para outra localizao.
OpenAsTextStream Abre um arquivo como sendo um fluxo de
texto.
Propriedades do objeto File

Attributes
Retorna ou define os atributos de um arquivo.
intAtributos = objFile.Attributes
ou
objFile.Attributes = intAtributos
Parmetro Descrio
0 Arquivo normal. Nenhum atributo definido.
1 Arquivo somente leitura.
2 Arquivo oculto.
4 Arquivo de sistema.
8 Drive de disco.
16 Pasta.
32 Arquivo foi alterado desde o ltimo backup.
64 Atalho.
128 Arquivo comprimido.
FileSystemObject
59
DateCreated
Retorna a data e a hora da criao de um arquivo.
strData = objFile.DateCreated
DateLastAcessed
Retorna a data e a hora em que um arquivo foi acessado
pela ltima vez.
strData = objFile.DateLastAcessed
DateLastModified
Retorna a data e a hora em que um arquivo foi modificado
pela ltima vez.
strData = objFile.DateLastModified
Drive
Retorna a letra do drive onde o arquivo reside.

strLetraDoDrive = objFile.Drive
Name
Define ou obtm o nome de um arquivo.
strNome = objFile.Name
objFile.Name = strNome
ParentFolder
Retorna a pasta onde o arquivo reside.
strPasta = objFile.ParentFolder
Path
Retorna o caminho completo para o arquivo.
strCaminho = objFile.Path
FileSystemObject
60
ShortName
Fornece o nome do arquivo usando a conveno de
nomenclatura do MSDOS (8.3).
strNomeCurto = objFile.ShortName
ShortPath
Fornece o caminho completo para o arquivo usando a
conveno de nomenclatura do MSDOS (8.3).

strNomeCurto = objFile.ShortPath
Size
Retorna o tamanho de um arquivo em bytes. Se quiser
converter para megabytes, basta dividir o valor retornado
por 1024.
intTamanhoDoArquivo = objFile.Size
Type
Retornainformaessobreotipodoarquivo.Porexemplo,
para um arquivo .txt, retornaria Text Document.
Acreditoqueapropriedadeobtenhaessasassociaesem
HKEY_CLASSES_ROOT.
strTipoDoArquivo = objFile.Type
Mtodos do objeto File

Copy
Copia um arquivo para outra localizao.
objFile.Copy destino [,fSubstituir]
Parmetro Descrio
destino Nova localizao do arquivo.
fSubstituir Se True, substituir um arquivo existente na nova
localizao que tenha o mesmo nome do arquivo que
estiver sendo copiado.
FileSystemObject
61
Exemplo
Rem Copia o arquivo c:\x.txt para a pasta c:\windows\:
Set objFile = fso.GetFile(c:\x.txt)
objFile.Copy c:\windows\
Delete
Exclui um arquivo.
objFile.Delete [fForado]
Parmetro Descrio
fForado Booleano. Dever ser True caso o arquivo a ser
excludo seja somente leitura.
Exemplo
Rem Exclui o arquivo c:\x.txt:
objFile.Delete
Move
Move um arquivo para outra localizao.
objFile.Move destino
Parmetro Descrio
destino Nova localizao do arquivo.
Exemplo
Rem Move o arquivo c:\x.txt para a pasta c:\windows\:
objFile.Move c:\windows\
OpenAsTextStream
AbreumarquivodetextoeretornaumobjetoTextStream.

Set FluxoDetexto =
objFile.OpenAsTextStream([intModoDeAbertura]
[,intFormato])
FileSystemObject
62
Parmetro Descrio
intModoDeAbertura Indica o que poder ser feito com o arquivo
depois de aberto.
ForReading Somente leitura.
ForWriting Escrita.
ForAppending Dados sero anexados no fim do arquivo.
intFormato UmdostrsvaloresTriStateusadosparadefinir
o formato de abertura do arquivo.
-2 TriStateUseDefault. Usa o padro do sistema
para abrir o arquivo.
-1 TriStateTrue. Abre o arquivo como Unicode.
0 TriStateFalse. Abre o arquivo como ASCII.
Exemplo
Rem Abre o arquivo c:\x.txt para escrita:
Set FluxoDeTexto = objFile.OpenAsTextStream(ForWriting)
Objeto Folder
O objeto Folder instanciado quando so utilizados os
mtodos CreateFolder() ou GetFolder() do objeto
FileSystemObject.
Attributes Obtm ou define atributos de uma pasta.
DateCreated Data da criao de uma pasta.
DateLastAcessed Data em que a pasta foi acessada pela ltima
vez.
DateLastModified Data em que a pasta foi modificada pela
ltima
vez.
Drive Retorna a letra do drive onde a pasta reside.
Files Retorna uma coleo de objetos File.
IsRootFolder Booleano. Determina se a pasta a pasta raiz
do volume.
Name Define ou retorna o nome da pasta.
ParentFolder Pasta dentro da qual a pasta atual reside.
Path Caminho completo para a pasta.
ShortName Nome da pasta usando a conveno de
nomenclatura do MS-DOS (8.3).
ShortPath Caminho completo para a pasta usando a
conveno de nomenclatura do MS-DOS.
Size Tamanho do conjunto de todos os arquivos e
subpastas contidos dentro da pasta, em bytes.
SubFolders RetornaumacoleodeobjetosFoldercontidos
na pasta.
Type Retorna informaes sobre o tipo da pasta.
Mtodos Descrio
Copy Copia uma pasta para outra localizao.
Delete Exclui uma pasta.
Move Move uma pasta para outra localizao.
CreateTextFile Cria um arquivo de texto e retorna um objeto
TextStream.
FileSystemObject
63
Propriedades do objeto Folder

Attributes
Define ou retorna os atributos de uma pasta. Semelhante
propriedade de mesmo nome do objeto File. Alis, os
objetos File e Folder compartilham muitas propriedades
e mtodos.
ou
intAtributos = f.Attributes
ou
f.Attributes = intAtributos
Parmetro Descrio
0 Arquivo normal. Nenhum atributo definido.
1 Arquivo somente leitura.
2 Arquivo oculto.
4 Arquivo de sistema.
8 Drive de disco.
16 Pasta.
32 Arquivo foi alterado desde o ltimo backup.
64 Atalho.
128 Arquivo comprimido.
DateCreated
Retorna a data e a hora da criao de uma pasta.
ou
strData = f.DateCreated
DateLastAcessed
Retornaadataeahoraemqueumapastafoiacessadapela
ltima vez.
ou
strData = f.DateLastAcessed
FileSystemObject
64
DateLastModified
Retorna a data e a hora em que uma pasta foi modificada
pela ltima vez.

ou
strData = f.DateLastModified
Drive
Retorna a letra do drive onde a pasta reside.
ou
strLetraDoDrive = f.Drive
Files
Retorna a coleo dos objetos File contidos na pasta.
ou
Set myFiles = f.Files
IsRootFolder
RetornarTrueseapastaemquestoforapastaraizdeum
volume; caso contrrio, retornar False.
ou
fRetorno = f.IsRootFolder
Name
Define ou obtm o nome de uma pasta.
ou
strNome = f.Name
ou
f.Name = strNome
FileSystemObject
65
ParentFolder
Retorna a pasta dentro da qual a pasta atual reside.
ou
strPasta = f.ParentFolder
Path
Retorna o caminho completo para a pasta.
ou
strCaminho = f.Path
ShortName
Fornece o nome da pasta usando a conveno de
nomenclatura do MSDOS (8.3).
ou
strNomeCurto = f.ShortName
ShortPath
Fornece o caminho completo para a pasta usando a
conveno de nomenclatura do MSDOS (8.3).
ou
strNomeCurto = f.ShortPath
Size
Retornaotamanhototal,embytes,doconjuntodearquivos
esubpastascontidosnapasta.Comonocasodapropriedade
de mesmo nome do objeto File, se quiser converter para
megabytes, basta dividir o valor retornado por 1024.
intTamanhoDaPasta = f.Size
FileSystemObject
66
SubFolders
RetornaacoleoFolderscomtodasassubpastascontidas
na pasta.
ou
Set mySubFolders = f.SubFolders
Type
Retorna informaes sobre o tipo da pasta.
ou
strTipoDaPasta = f.Type
Mtodos do objeto Folder

Copy
Copia uma pasta para outra localizao.
ou
f.Copy destino [,fSubstituir]
Parmetro Descrio
fSubstituir Se True, substituir todos os arquivos homnimos
numa pasta na nova localizao que tenha o mesmo
nome da pasta que estiver sendo copiada.
Delete
Exclui uma pasta.
ou
f.Delete [fForado]
Parmetro Descrio
fForado Booleano.DeverserTruecasoapastaaserexcluda
seja somente leitura.
FileSystemObject
67
Move
Move uma pasta para outra localizao.

ou
f.Move destino
Parmetro Descrio
CreateTextFile
O mtodo CreateTextFile() semelhante ao mtodo de
mesmo nome do objeto FileSytemObject.
ou
Set ArquivoDeTexto = f.CreateTextFile(strArquivoTexto
[,fSubstituir] [,unicode])
Parmetro Descrio
strArquivoTexto Nome do arquivo de texto.
fSubstituir Se True, substituir um arquivo homnimo pelo
arquivo que estiver sendo criado. Se False, o
arquivo original ser mantido.
unicode SeTrue,umarquivoUnicode sercriado.Se False
ou omitido, ser criado um arquivo ASCII.
FileSystemObject
68
Objeto TextStream
O objeto TextStream instanciado quando da utilizao de
mtodos dos objetos FileSystemObject, File ou Folder que
criam ou abrem arquivos de texto. Na descrio da sintaxe
e nos exemplos dos mtodos e propriedades do objeto
TextStream, utilizarei o mtodo OpenTextFile() do objeto
FileSystemObject.
Propriedades
AtEndOfLine Booleano. Determina se o final de uma linha foi

atingido.
AtEndOfStream Booleano. Determina se o final de um arquivo
de
texto foi atingido.
Column Ponteiro para a coluna atual em um arquivo de
texto.
Line Ponteiro para a linha atual em um arquivo de texto.
Mtodos
Close Fecha um arquivo de texto.
Read L um nmero especfico de caracteres em um
arquivo de texto.
ReadAll L todo o arquivo de texto.
ReadLine L uma linha de um arquivo de texto.
Skip Ignora um determinado nmero de caracteres
quando lendo um arquivo de texto.
SkipLine Ignoratodaumalinhaquandolendoumarquivodetexto.
Write Escreve uma string num arquivo de texto.
WriteLine Escreve uma string e uma quebra de linha.
WriteBlankLines Escreve linhas em branco num arquivo de
texto.
Propriedades do objeto TextStream

AtEndOfLine
Retornar True se o final de uma linha num arquivo de
texto que esteja sendo lido for atingido.
fRetorno = f.AtEndOfLine
AtEndOfStream
RetornarTrueseofinaldeumarquivodetextoqueesteja
sendo lido for atingido.

fRetorno = f.AtEndOfStream
FileSystemObject
69
Column
Retornaumponteiroparaacolunaatualemumarquivode
texto que esteja sendo lido.
intColuna = f.Column
Line
Retornaumponteiroparaalinhaatualemumarquivodetexto.
intLinha = f.Line
Mtodos do objeto TextStream

Close
Fecha um arquivo de texto.
f.Close
Read
L um nmero especfico de caracteres em um arquivo de
texto, retornando a string correspondente.

Set f = fso.OpenTextFile(strArquivo, ForReading
strRetorno = f.Read(intNmeroDeCaracteres)
Parmetro Descrio
intNmeroDeCaracteres Nmero de caracteres a serem lidos do
arquivo, a partir da posio atual.
Exemplo
Rem L dez caracteres do arquivo c:\x.txt:
Set f = fso.OpenTextFile(c:\x.txt, ForReading)
strRetorno = f.Read(10)
f.Close
Wscript.Echo strRetorno
FileSystemObject
70
ReadAll
L todo o arquivo de texto, retornando a string
correspondente.
strRetorno = f.ReadAll
Exemplo
Rem L todo o arquivo c:\x.txt:
strRetorno = f.ReadAll
f.Close
ReadLine
L uma linha num arquivo de texto, a partir da linha atual,
retornando a string correspondente e movendo o ponteiro

para a prxima linha.
strRetorno = f.ReadLine
Exemplo
Rem L as quatro primeiras linhas do arquivo c:\x.txt:
Dim i
i=1
Do While f.AtEndOfStream <> True And i <= 4
strRetorno = strRetorno + f.ReadLine
i = i+1
Loop
f.close
Skip
Ignora um determinado nmero de caracteres quando
lendo um arquivo de texto.
f.Skip(intNmeroDeCaracteres)
FileSystemObject
71
Parmetro Descrio
intNmeroDeCaracteres Nmerodecaracteresaseremignorados,
a partir da posio atual.
Exemplo
Rem L cinco caracteres do arquivo c:\x.txt a partir do quarto
caractere:

f.Skip(3)
strRetorno = f.Read(5)
f.Close
SkipLine
Ignora toda uma linha quando lendo um arquivo de texto.
f.SkipLine
Exemplo
Rem L as trs primeiras linhas do arquivo c:\x.txt, a partir da
segunda:
Dim i
i=1
f.SkipLine
Do While f.AtEndOfStream <> True And i <= 3
strRetorno = strRetorno + f.ReadLine
i = i+1
Loop
f.close
Write
Escreve uma string num arquivo de texto.
Set f = fso.OpenTextFile(strArquivo,
ForWriting|ForAppending [,fCriarNovo]
[,intFormato])
f.Write string
Exemplo
Rem Escreve Ol mundo! no arquivo c:\x.txt:
Set f = fso.OpenTextFile(c:\x.txt, ForWriting)
f.Write Ol mundo!
f.Close
FileSystemObject
72
WriteLine
Escreve uma string e uma quebra de linha num arquivo de
texto.
[,intFormato])
f.WriteLine string
Parmetro Descrio
string String a ser escrita no arquivo de texto.
Exemplo
Rem Escreve Ol mundo! no arquivo c:\x.txt:
Set f = fso.OpenTextFile(c:\x.txt, ForWriting)
f.WriteLine Ol mundo!
f.Close
WriteBlankLines
Escreve linhas em branco num arquivo de texto.
[,intFormato])
f.WriteBlankLines intNmeroDeLinhas
Parmetro Descrio
intNmeroDeLinhas Nmero de linhas em branco a serem
escritas
no arquivo de texto.
Exemplo
Rem Escreve trs linhas em branco no final do arquivo

c:\x.txt:
Set f = fso.OpenTextFile(c:\x.txt, ForAppending)
f.WriteBlankLines 3
f.Close
FileSystemObject
73
Recursos Avanados
Teoricamente, no h limites para aquilo que os scripts do
WSH podem fazer dentro do ambiente Windows de 32 bits.
Quaisquerrecursosdosistemaoperacional,inclusiveaqueles
relacionados ao hardware, podem ser manipulados por um
script do WSH, desde que voc saiba como acesslos.
Nesta seo, farei uma breve explanao sobre as classes
WIN32 e sobre a ADSI.
Classes WIN32
As classes WIN32 expandem enormemente as
funcionalidade de scripts do WSH e de aplicaes que
necessitam de acesso a recursos avanados do sistema
operacional. A maneira mais simples de instanciar um
objeto a partir de uma classe WIN32 :
Set objWIN32 =
GetObject(WinMgmts::Win32_Classe[=ItemRef])
Exemplo
Rem Instancia um objeto da classe Win32_Service fazendo
referncia ao servio
NetLogon:
dim obj
Set obj = GetObject(WinMgmts::Win32_Service=NetLogon)
Select Case obj.State
Case Stopped
obj.StartService
msgbox O servio NetLogon foi ativado!
Case Running
msgbox O servio NetLogon j est ativo!
Case Else msgbox O status atual do servio obj.State
End Select
As classes WIN32 dividemse em quatro categorias, que

por sua vez se compemse de dezenas de classes com
centenas de propriedades e mtodos a elas associados.

Categorias Descrio
Computer System Hardware Classes que representam objetos
relacionados ao hardware.
Operating System Classes que representam objetos
relacionadosaosistemaoperacional.
Installed Applications Classes que representam objetos
relacionados ao software instalado.
WMI Service Management Classesutilizadasnogerenciamento
do WMI (Windows Management
Instrumentation).
Informaes completas sobre as classes WIN32, incluindo

uma lista das classes disponveis com uma descrio
detalhadadesuaspropriedadesemtodos,bemcomosobre
a tecnologia WMI, podem ser obtidas no site http://
msdn.microsoft.com/library/toc.asp?PP=/library/toc/psdk/
psdk6.xmltocPath=psdk6.
Recursos Avanados
74
ADSI
Com o lanamento do Windows 2000, a Microsoft
apresentou ao mundo sua nova implementao de servios
de diretrio: o Active Directory. Servios de diretrio so
servios que o sistema operacional de rede oferece para
permitir a criao, excluso e alterao organizada e
centralizada de objetos da rede, tais como usurios, grupos,
computadores, etc. O Active Directory baseado nas
especificaes da verso 3.0 do protocolo LDAP
(Lightweight Directory Access Protocol). Os
desenvolvedores de scripts podero manipular os objetos
armazenados no diretrio atravs das Active Directory
Service Interfaces (ADSI).
Embora a ADSI tenha sido desenvolvida tendo o Active
Directory em mente (o que compreensvel), tambm
trabalha com outros provedores, a saber:
Windows NT SAM,
NDS e
Netware 3.x.
Exemplo
Rem Retornando os usurios contidos no grupo global Domain

Admins de um
domno do Windows NT:
Dim Grupo, Membro
Set Grupo = GetObject(WinNT://Dominio/Domain Admins)
For Each Membro in Grupo.Members
Wscript.echo Membro.Name
Next
Rem Criando um usurio chamado joo em um diretrio do
Active Directory e
definindo a data de expirao da conta para o dia 1 de
Rem janeiro de 2001:
Dim ou, usuario
Set ou = GetObject(LDAP://OU=X,DC=Microsoft,DC=COM)
Set usuario = ou.Create(user, cn=Joao)
usuario.Put samAccountName, joao
usuario.AccountExpirationDate = 01/01/2001
usuario.SetInfo
No site http://www.microsoft.com/adsi voc poder obter

maiores informaes sobre a ADSI, bem como baixar a
verso do produto para o Windows NT. Poder obter
tambmadocumentaodaADSIemformatoHTMLHelp.
Recursos Avanados
75
Scripts de Logon
A utilizao mais evidente e comum para scripts do WSH,
sem sombra de dvidas, em scripts de logon. Scripts de
logon so arquivos executveis (.exe, .com, .bat, etc.) que
so executados assim que um usurio validado por um
domnio do Windows NT ou do Windows 2000.
Normalmente, os scripts de logon so armazenados no
compartilhamento NETLOGON de um controlador de
domnio.
Existem, no entanto, alguns problemas relacionados
utilizaodoWSHparaessafinalidade.Emprimeirolugar,
apenas as verses de 32 bits do Windows podem executar
scripts do WSH. Isso exclui clientes de rede utilizando o
MSDOSouoWindows3.11.Emsegundo,oWindowsNT
e o Windows 95 no vm com o WSH instalado por padro.
Por fim, s o Windows 2000 reconhece os arquivos do
WSH (.vbs, .js, .wsf, etc.) como arquivos executveis.
Assim, a menos que voc esteja numa rede onde todos os
servidoreseclientesutilizemoWindows2000,dificilmente
conseguir implantar scripts de logon integralmente
desenvolvidos no WSH. Algumas sadas que poder adotar
so as seguintes:
Se sua rede tiver clientes MSDOS e Windows 3.11,
crieumarquivo.batqueexecuteumscriptdelogonem
separado para esses ambientes e o script WSH para os
demais.
Caso tenha mquinas utilizando o Windows 95 ou o
WindowsNT,verifique,utilizandoocdigoapropriado
dentro de um script .bat, se os arquivos Wscript.exe e
Cscript.exeexistem.Casonoexistam,utilizeomesmo
script .bat para iniciar o programa de instalao do
WSH, convenientemente localizado num
compartilhamento da rede.
Uma vez que somente os sistemas operacionais da
famlia Windows 2000 vem os arquivos do WSH
comoautnticosexecutveis,paraosoutrosambientes
(exceto o MSDOS e o Windows 3.11, claro) voc
dever usar algo como cscript caminhodoscript
quando estiver configurando scripts de logon para
uma conta de usurio num controlador de domnio
Windows NT ou Windows 2000.
Recursos Avanados
76
Windows Script Components

Os componentes de script do Windows Script Components
(WSC)soamaneiramaisfcildecriarcomponentesCOM
para serem utilizados por pginas do Active Server Pages
ou por scripts do WSH.
UmarquivodoWSCnadamaisqueumarquivotextocom
extenso .wsc que utiliza a XML juntamente com uma
linguagem de script compatvel com a tecnologia ActiveX
(comooVBScripteoJScript)paracriarumcomponentede
script reutilizvel. Para desenvolver um componente de
script,bastaumeditordetextosimplescomooNotepad.No
entanto, no site http://msdn.microsoft.com/scripting
possvel obter gratuitamente um wizard que auxilia no
desenvolvimento de componentes de script do WSC.
Paraserutilizado,umcomponentedescriptWSCnecessita:
do arquivo scrobj.dll (runtime do WSC) instalado;
de quaisquer arquivos (executveis, bibliotecas, etc.)

requeridos por objetos utilizados no desenvolvimento
do componente; e
que o arquivo .wsc seja registrado (para registrlo,
clique com o boto direito do mouse sobre o arquivo
.wsc e escolha, no menu suspenso, a opo Register).
Para instanciar um objeto a partir de um componente de
script, utilize a seguinte sintaxe:
Set obj = CreateObject(progID)
OprogIDdefinidopelaatribuiodeumastringvarivel
progID entre as tags <registation></registration>.
Abaixo, o esqueleto tpico de um arquivo .wsc onde um
componente de script est sendo difinido:
<?XML version=1.0"?>
<component>
<registration>
description=DescrioDoComponente
progid=progID
version=VersoDoComponente
classid=clsid
</registration>
<public>
<property name=NomeDeUmaPropriedade/>
<method name=NomeDeUmMtodo/>
</public>
<![CDATA[
Function|Sub NomeDeUmMtodo([Parmetro1][,Parmetro2]...
[,ParmetroN])
Cdigo do mtodo NomeDeUmMtodo
End Function|End Sub
]]>
</script>
</component>
Recursos Avanados
77
Informaes mais completas sobre o WSC podem ser

obtidas no site http://msdn.microsoft.com/scripting. Desse
site tambm poder ser baixada a documentao completa
do WSC, em um arquivo no formato HTMLHelp.
Criptografando Scripts do WSH

Voc sabe o que isso a embaixo?
#@~^DwEAAA==]:~A/1D+7+,ODkPsk
tCd,+:,8DmxmK~UW,0bxCV~[KPCD$;k7W~E1)-a D6OJ=@#@?
nDP6/
W,,/
DlO+}4%n1YrjmMkwDrUocsbVn?zdD+hr(%
+1YEb@#@ZGUkY~sK.+C9k
oP{P8SPwW.MkOr oP{~ BPsK.)wa+
NrxL~{P0@#@j+DPW~{P0dGcr2+
P6Owk^+rm=w6cYaYr~~oKDba2+ Nk
Lb@#@0c.kOn~VCx0Jk+d~2@#@W ;VG/
@#@eFUAAA==^#~@
Tratase do exemplo de utilizao do mtodo

WriteBlankLines do objeto TextStream criptografado. No
sitehttp://msdn.microsoft.com/scriptingvocpoderobter,
gratuitamente, o ScriptEncoder.
O ScriptEncoder uma ferramenta simples de linha de
comandoquevocpodeutilizarparacriptografarscriptsdo
WSH e arquivos ASP e HTML. A sintaxe para utilizar o
ScriptEncoder a seguinte:
SCRENC [/s] [/f] [/xl] [/l strLinguagem ] [/e strExtenso]
strArquivoOriginal strNovoArquivo
Opes Descrio
/s Esta chave determina que o ScriptEncoder no
deve fornecer nenhuma sada na tela.
/f Esta chave determina que strArquivoOriginal
deve ser sobrescrito por strNovoArquivo.
/xl Estachaveespecificaqueadiretiva@language
do ASP no est no topo do arquivo.
/l strLinguagem Determina qual a linguagem de script padro.
NoprecisaserutilizadacomarquivosdoWSH,
pois a extenso do arquivo (.vbs ou .js) j
determina por si s qual a linguagem de script
padro.
/e strExtenso AssociaaextensodoarquivostrArquivoOriginal
com um tipo definido de arquivo.
strArquivoOriginal Arquivo a ser criptografado.
strNovoArquivo Arquivo critpografado resultante. Salve seus
arquivos.vbscomaextenso.vbeeosarquivos
.js com a extenso .jse, para que o WSH saiba
que so arquivos criptogrados.
Recursos Avanados
78
VBScript
Introduo
O Visual Basic Scripting Edition (VBScript) uma
linguagem de programao em grande parte compatvel
com o Visual Basic que foi desenvolvida pela Microsoft
visando sua utilizao, inicialmente, na Internet. No se
trata de uma linguagem compilada, ou seja, no possvel
gerar executveis a partir do VBScript. Com o VBScript
voc pode:
Desenvolver pginas do Active Server Pages;
Embutir rotinas de programao em pginas HTML; e
Criar scripts do WSH (que o que nos interessa).
Conforme j foi citado anteriormente, os scripts do WSH
escritos em VBScript devem ser salvos com a extenso de
arquivo .vbs. Isso instrui o WSH a chamar o mecanismo de
scripting do VBScript para executar o script. De forma
anloga, quem tem mais intimidade com o JScript deve
salvar os scripts com a extenso de arquivo .js.
No pretendo que este guia seja uma fonte de referncia
completa sobre o VBScript, at porque essa no sua
finalidade. Portanto, abordarei apenas o essencial para que
oleitorsejacapazdeimplementarscriptsdoWSHrealmente
funcionais fazendo uso do VBScript como linguagem de
programao.
Instrues condicionais
Como a quase totalidade das linguagens de programao, o
VBScript faz uso intensivo de instrues condicionais.
Instruescondicionaissoaquelasemqueumdeterminado
fragmento de cdigo s ser executado caso uma expresso
seja avaliada como sendo verdadeira.
Para o leitor que j tiver alguma familiaridade com o Visual
Basic, as instrues condicionais do VBScript so
implementadas da mesma forma.
VBScript
79
If
A instruo If na sua forma mais simples tem a seguinte

sintaxe:
If expresso then declarao
Quando mais de uma declarao for executada caso a

expresso seja avaliada como verdadeira, usase:
If expresso then
Declarao1
Declarao2
...
DeclaraoN
End If
InstruescondicionaisIfpodemseraninhadasumasdentro
das outras em vrios nveis. Quando aninhar instrues If,
cuidado com as instrues de fechamento End If, que so
uma causa comum de erros de tempo de execuo.
Else
A instruo Else permite que uma ou mais declaraes
sejam executadas caso a expresso avaliada por If seja
falsa.
If expresso then
Declarao1
Declarao2
...
DeclaraoN
Else
DeclaraoElse
End If
Uma variao da construo condicional If... Then... Else

If... Then... ElseIf... Then... Else. No muito usual nem
elegante a sua utilizao.
If expresso1 then
Declarao1
Declarao2
...
DeclaraoN
ElseIf expresso2 then

DeclaraoElseIf
Else
DeclaraoElse
End If
VBScript
80
Podem ser usados tantos ElseIf quantos o programador

julgar necessrios.
Exemplos
Um exemplo de utilizao da construo condicional If... Then...
Else:
Dim X, Y
X = InputBox(Entre um nmero:)
If X<10 Then
Y = O nmero que voc forneceu menor que 10!
Else
Y = O nmero que voc forneceu maior ou igual a 10!
End If
Wscript.Echo Y
Um exemplo de utilizao de Ifs aninhados:
Dim X, Y
X = InputBox(Entre um nmero:)
If X Mod 2=0 then
If X<10 then
Y=O nmero que voc forneceu par e menor que 10!
Else
Y=O nmero que voc forneceu par e maior ou igual a 10!
End If
Else
If X<10 then
Y=O nmero que voc forneceu mpar e menor que 10!
Else
Y=O nmero que voc forneceu mpar e maior que 10!
End If
End If
Wscript.Echo Y
Select Case
Uma alternativa ao uso do ElseIf, que bem mais legvel e
elegante, a instruo Select Case.
A sintaxe para a instruo Select Case a seguinte:
Select Case varivel

Case Valor1
Declarao 1
Case Valor2
Declarao2
Case Valor3
Declarao3
Case ValorN
DeclaraoN
Case Else
DeclaraoElse
End Select
VBScript
81
Exemplo
Um exemplo de utilizao da instruo Select Case:
Dim strEstado, strMsg
strEstado=InputBox(Entre o nome do Estado em que voc
nasceu:)
Select Case strEstado
Case Minas Gerais
strMsg=Mineiros so sempre bem-vindos!
Case So Paulo
strMsg=Paulistas so sempre bem-vindos!
Case Rio de Janeiro
strMsg=Cariocas so sempre bem-vindos!
Case Bahia
strMsg=Baianos so sempre bem-vindos!
Case Rio Grande do Sul
strMsg=Gachos so sempre bem-vindos!
Case Else
strMsg=No importa de onde voc venha, ser sempre
bem-vindo!
End Select
Wscript.Echo strMsg
Loops
Outro tipo de instruo bastante popular em praticamente
todasaslinguagensdeprogramao(eoVBScriptnofoge
regra) so os Loops. As instrues de Loop repetem a
execuo de uma ou mais declaraes um determinado

nmero de vezes.
For
A instruo For a instruo de loop mais usada.
For Varivel=ValorInicial To ValorFinal [Step step]
Declaraes
Next
A instruo opcional Step determina de quanto a varivel

ser incrementada cada vez que o lao for executado.
Exemplos
Contando de 1 at 10 usando um lao For:
Dim X, Y(9), strMsg
For X=1 To 10
Y(X-1)=X
strMsg = strMsg chr(10) Y(X-1)
Next
Wscript.Echo strMsg
Contando os nmeros mpares de 1 at 25:
Dim X, Y(25), strMsg
For X=1 To 25 Step 2
Y(X-1)=X
strMsg = strMsg chr(10) Y(X-1)
Next
Wscript.Echo strMsg
VBScript
82
While... Wend
A construo While... Wend utilizada quando no se tem
certeza do nmero de vezes que o loop ser executado.
While Expresso
Declaraes
Wend
Comoaexpressoavaliadaantesqueoloopsejaexecutado
pela primeira vez, caso ela seja falsa, as declaraes no
corpo do loop While... Wend podemnuncaserexecutadas.
Do... Loop
A construo Do... Loop pode ser implementada de vrias

formas, como demonstrado a seguir:
Do While Expresso
Declaraes
Loop
Esta primeira forma ser executada enquanto a expresso

avaliada for verdadeira.
Do
Declaraes
Loop While Expresso
Esta segunda forma em quase tudo semelhante anterior,

squeexecutarpelomenosumavez,mesmoqueaexpresso
avaliada seja falsa logo na primeira iterao do lao.
Do Until Expresso
Declaraes
Loop
Funciona de maneira anloga construo Do While...

Loop, s que as declaraes s sero executadas enquanto
a expresso for falsa.
Do
Declaraes
Loop Until Expresso
semelhante construo Do... Loop While, s que as

declaraes,apsseremexecutadaspelomenosumavez,s
continuaro a ser executadas caso a expresso avaliada seja
falsa.
VBScript
83
Exit
A instruo Exit, atravs das suas variaes (Exit Do, Exit
For), fora a sada prematura de um loop.
Exemplos
Um exemplo de Do While... Loop com Exit Do:
Dim X, strMsg
Do While X < 10
X = X+1
if X=7 then
Exit Do
Else
strMsg = strMsg chr(10) Ol, mundo!
End If
Loop
Wscript.Echo strMsg
For Each
Um tipo de instruo de loop especial do VBScript a For
Each.Permiteenumerartodososelementosdeumacoleo.
For Each Elemento In Coleo
Declaraes
Next
Dentro do WSH, como j tivemos a oportunidade de ver,

existemmuitascoleeseoForEachpodeserbastantetil.
Sub-Rotinas e Funes
Assim como no seu irmo mais velho, o Visual Basic, a
principal tarefa de programao no mbito do VBScript o
desenvolvimento de subrotinas e funes.
Sub-Rotinas
Subrotinassoblocosdecdigocontidosentreasinstrues
Sub... End Sub. Podem ou no receber parmetros e no
retornam valores. A sintaxe de uma subrotina :
Sub NomeDaSubRotina([Parmetro1], [Parmetro2],...
[ParmetroN])
Declaraes
End Sub
Uma nota importante que os procedimentos Sub devem

serchamadosdentrodocdigoVBScriptsemosparnteses.
Exemplo
Sub Mensagem(strMensagem)
Wscript.Echo strMensagem
End Sub
Dim strMsg
strMsg=InputBox(Entre uma mensagem:)
Mensagem strMsg.
VBScript
84
Funes
Funessoblocosdecdigocontidosdentrodasinstrues
Function...EndFunction.Comoassubrotinas,asfunes
podem ou no ter parmetros. A principal diferena entre
elasqueasfunesretornamvaloresedevemserchamadas
no cdigo VBScript com os parnteses. A sintaxe para
definio de uma funo :
Function NomeDaFuno([Parmetro1], [Parmetro2],...
[ParmetroN])
Declaraes
End Function
Exemplo
Function Mensagem()
Mensagem=InputBox(Entre uma mensagem:)
End Function
Wscript.Echo Mensagem()
Operadores
Uma das principais funcionalidades de uma linguagem de
programao a disponibilizao de operadores, visto que
so eles que permitem a construo de expresses.
Os operadores fornecidos pelo VBScript so:
Operadores Significado
+ Adio de duas ou mais expresses numricas ou
concatenao de strings.
- Subtrao de uma expresso numrica de outra.
* Multiplicao de duas ou mais expresses numricas.
/ Diviso de uma expresso numrica pela outra.
^ Exponenciao.
= Igualdade.
\ Diviso de inteiros sem parte fracionria.
Mod Retornaorestodadivisoentredoisnmerosinteiros.
And Retornar verdadeiro se ambos os valores utilizados
forem verdadeiros.
Or Retornar verdadeiro se pelo menos um dos valores
utilizados for verdadeiro.
Xor Retornar verdadeiro se apenas um dos valores
utilizados for verdadeiro.

Imp Implicao.
Eqv Equivalncia.
<> Diferente de.
> Maior que.
< Menor que.
>= Maior ou igual a.
<= Menor ou igual a.
Concatenao de strings.
VBScript
85
Tipos de Dados
O VBScript, ao contrrio do Visual Basic, no permite a
definioexplcitadotipodedadoqueumavarivelpoder
conter quando da sua declarao, ou seja, todas as variveis
so declaradas obrigatoriamente como do tipo Variant.
Entretanto,oVBScriptsuportagrandevariedadedesubtipos
de dados e qual subtipo de dado ser atribudo a uma
varivel algo que ser definido no contexto em que essa
varivel estiver sendo utilizada ou pelo uso de funes de
converso,taiscomoCInt(),CStr()ouCDate(),porexemplo.
Subtipo Prefixo Usual Descrio
Boolean f, b ou boo Valorlgico,quepodeserTrueouFalse.
Byte Inteiro sem sinal entre 0 e 255.
Integer int Inteirocomsinalentre32.768e32.767.
Long lng Inteiro com sinal entre 2.147.483.648 e
2.147.483.647.
Single Nmero fracionrio de ponto flutuante
entre 3,402823E38 e 1,401298E-45
para valores negativos e entre
1,401298E-45 e 3,402823E38 para
valores positivos.
Double dbl Nmero fracionrio de ponto flutuante
entre 4,94065645841247E-324 e
1,79769313486232E308 para valores
negativos e entre
1,79769313486232E308 e
4,94065645841247E-324 para valores
positivos.
Currency cur Valores monetrios.
Date d Valores de datas.
Object obj Objeto.
String str String (texto) de at aproximadamente
dois bilhes de caracteres.
Outras instrues do VBScript

Existem ainda algumas instrues que no mencionei e que
so muito importantes:
Instrues Significado
Dim Declara uma varivel. Utilize-a sempre, para no
se perder em seu prprio cdigo.
Option Explicit Faz com que todas as variveis sejam
declaradas.
Erase Apaga o contedo de uma matriz.
Preserve Copia o contedo de uma matriz dinmica para outra
matriz dinmica que tenha sido redimensionada.
Redim Redimensiona uma matriz dinmica.
Set Atribui um objeto a uma varivel.
On Error Usada em conjunto com Resume Next para o
tratamento de erros.
Call Chama um procedimento.
Rem Insere uma linha de comentrio.
VBScript
86
Funes, constantes e objetos do

VBScript
OVBScriptforneceinmerasfuneseconstantesealguns
objetos, tantos que seria necessrio um outro guia
exclusivamente para enumerlos e descrevlos. Abaixo,
os mais utilizados:
Funes
Asc Retorna o cdigo ASCII de um caractere. Sintaxe:
Asc(string).
CBool Converte seu parmetro para o subtipo Boolean.
Sintaxe: CBool(expresso).
CByte Converte seu parmetro para o subtipo Byte. Sintaxe:
CByte(expresso).
CDate Converte seu parmetro para o subtipo Date. Sintaxe:
CDatel(expresso).
CInt ConverteseuparmetroparaosubtipoInteger.Sintaxe:
CInt(expresso).
CStr ConverteseuparmetroparaosubtipoString.Sintaxe:
CStr(expresso).
Chr Retornaocaracterecorrespondenteaumdeterminado
cdigo ASCII. Sintaxe: Chr(nmero).
Date Retorna a data atual do sistema. Sintaxe: Date().
InputBox Exibe uma caixa de dilogo solicitando ao usurio a
entrada de dados. Sintaxe: InputBox(Mensagem
[,ttulo][,valor][,x][,y]).
Left Retorna os caracteres x mais esquerda. Sintaxe:
Left(string, x).
Len Retornaotamanhodeumastring.Sintaxe:Len(string).
MsgBox Apresenta uma caixa de dilogo com informaes.
Sintaxe: MsgBox(Mensagem[,definio][,ttulo]).
Now Retorna a data e a hora atuais do sistema. Sintaxe:
Now().
Right Retorna os caracteres x mais direita. Sintaxe:
Right(string, x).
Time Retorna a hora atual do sistema. Sintaxe: Time().
Trim Eliminatodososespaosembrancoantesedepoisda
string. Sintaxe: Trim(string).
Constantes/Literais
Empty Declara um valor para uma varivel que ainda no foi
inicializada.
Nothing Elimina a atribuio de um objeto a uma varivel.
Null Usada na atribuio de valores nulos a variveis.
True/False Usadas em expresses booleanas.
Objetos
Err Objeto utilizado no tratamento de erros.
RegExp Objeto que permite executar uma expresso regular.
VBScript
87
Objeto Err
OobjetoErrcontminformaessobreerrosdetempode
execuo (runtime). Aceita os mtodos Raise e Clear
para criar e desativar erros runtime. No necessrio
criar uma instncia para objeto Err.
No exemplo abaixo verificado o valor da propriedade
Number e, se ela contiver um valor diferente de zero,
exibir os detalhes numa caixa de mensagem.
Dim intNumeroDoErro, strDescDoErro
On Error Resume Next
Err.Raise 6
intNumeroDoErro = Err.number
strDescDoErro = Err.description
If intNumeroDoErro <> 0 Then
Wscript.Echo Ocorreu um erro! Erro nmero
intNumeroDoErro do tipo
strDescDoErro .
End If
Mtodos do objeto Err

Clear
Define todas as propriedades de um objeto Err para os
valores padro, por exemplo, definindo a propriedade
Number como 0 (zero).
Err.Clear
Raise
Permite simular um erro de runtime.
Err.Raise (nmero [,fonte] [,descrio]
[,arqhelp][,contexto])
Argumento Descrio
nmero Natureza do erro.
fonte Objeto ou aplicao que originalmente gerou o erro.
descrio Descrio do erro.
arqhelp LocalizaodoarquivoHelpnoqualaajudaparaesse
erro pode ser encontrada.
contexto Identifica o tpico dentro do arquivo Help que fornece
ajuda para o erro.
Propriedades do objeto Err
Description
Define ou retorna uma string que descreve o erro.
Err.Description [ = string]
Number
Defineouretornaumvalornumricoqueidentificaoerro.
Err.Number [ = nmerro]
VBScript
88
Source
Retorna ou define o nome do objeto ou da aplicao que
originalmente gerou o erro.
Err.Source [=nomeaplic]
Argumento Descrio
nomeaplic Nome da aplicao.
HelpContext
Defineouretornaonmerodecontextoparaumtpicono
arquivo Help.
Err.HelpContext [=contextoID ]
Argumento Descrio
contextoID Identificador de um tpico de ajuda no arquivo Help.
HelpFile
Define ou retorna o path para um arquivo Help, que
acionadoquandoousurioclicanobotoHelpoupressiona
a tecla F1 na caixa de dilogo de uma mensagem de erro.
Err.HelpFile [=strCaminho]
Argumento Descrio
strCaminho Localizao do arquivo Help.
Objeto RegExp
O objeto RegExp usado para criar e executar uma
expressoregular,aqualpermitepesquisarumaseqncia
de caracteres em uma string.
Um objeto Match criado cada vez que o objeto RegExp
encontra uma correspondncia (match). Zero ou mais
correspondncias (matches) podero ocorrer e o objeto
RegExp retornar uma coleo Matches de objetos
Match.
Exemplo
strAlvo = O rato roeu a roupa do rei de Roma
Set objRegExp = New RegExp
objRegExp.Pattern = r
objRegExp.IgnoreCase = False
objRegExp.Global = True
Set colMatches = objRegExp.Execute(strAlvo)
For Each Match In colMatches
Wscript.Echo Correspondncia encontrada em
Match.FirstIndex .
Wscript.Echo Valor encontrado Match.Value . chr(10)
Next
VBScript
89
Mtodos do objeto RegExp

Execute
Executa a busca de uma expresso regular em uma string,
retornando uma coleo Matches contendo um objeto
Match para cada correspondncia (match) encontrada. A
propriedade Pattern deve ter sido especificada
previamente com a expresso regular. Sintaxe:
objRegExp.Execute(string)
Replace
Executa a busca de uma expresso regular em uma string
original(str1),substituindocadacorrespondncia(match)
encontrada por uma outro string (str2). Se nenhuma
correspondnciaforencontrada,retornarastringoriginal.
objRegExp.Replace (str1, str2)
Test
Executa a busca de uma expresso regular em uma string

e retorna um valor Booleano True ou False, indicando se
a expresso regular foi encontrada.
objRegExp.Test(string)
Propriedades do objeto RegExp

Global
Retorna ou define um valor boleano, que indica se devem
ser procuradas todas as ocorrncias (True) da expresso
regular ou somente a primeira ocorrncia (False) em uma
string.
objRegExp.Global = True | False
IgnoreCase
Define ou retorna um valor boleano que determina se a
expresso regular distingue (False) ou no (True)
minsculas de maisculas.
objRegExp.IgnoreCase = True | False
VBScript
90
Pattern
Defineouretornaumastringcontendoaexpressoregular.
DeveserespecificadaantesdoobjetoRegExpserutilizado.
Mais informaes podem ser obtidas em http://
msdn.microsoft.com/workshop/languages/clinic/
scripting051099.asp ou em http://www.oreilly/catalog/
regexp/.
objRegExp.Pattern [=expr_regular]
Coleo Matches
uma coleo criada pelo mtodo Execute do objeto
RegExp, contendo objetos Match que so criados para

cada correspondncia (match) encontrada da expresso
regular em uma string.
Objeto Match
O objeto Match criado toda vez que o mtodo Execute
doobjetoRegExpencontraumacorrespondncia(match)
da expresso regular em uma string. Armazena em suas
propriedadesosdetalhesdecadacorrespondncia(match)
encontrada na pesquisa.
Propriedades do objeto Match

FirstIndex
Retorna a posio (a partir de 0) dentro da string onde
ocorreu a correspondncia (match) com a expresso
regular.
objMatch.FirstIndex
Length
Retorna o tamanho do texto encontrado na pesquisa da
expresso regular.
objMatch.Length
Value
Retorna o valor ou o texto encontrado na pesquisa da
expresso regular.
objMatch.Value
VBScript
91
Smbolos usados em Expresses

Smbolo Funo
^ Somente localiza (match) no incio de uma string.
Por exemplo: ^P localiza o primeiro P em Pedro
pegou o pato.
$ Somente localiza (match) no final de uma string.
Por exemplo: a expresso o$ localiza o ltimo o em
Pedro pegou o pato.

\b Localiza qualquer final de palavra.
Por exemplo: mente\b localiza em possivelmente
amanh.
\B Localiza qualquer coisa que no seja final de palavra.
literal Localiza o literal especificado.
\n Localiza o caractere new line
\f Localiza o caractere form feed
\r Localiza o caractere carriage return
\t Localiza o caractere tab horizontal
\v Localiza o caractere tab vertical
\? Localiza o caractere ?
\* Localiza o caractere *
\+ Localiza o caractere +
\. Localiza o caractere .
\| Localiza o caractere |
\{ Localiza o caractere {
\} Localiza o caractere }
\\ Localiza o caractere \
\[ Localiza o caractere [
\] Localiza o caractere ]
$ Localiza o caractere (
$ Localiza o caractere )
\xxx LocalizaocaractereASCIIexpressopelonmerooctal
xxx.
Por exemplo: \50" localiza ( ou chr (40).
\xdd Localiza o caractere ASCII expresso pelo nmero
hexa dd.
Por exemplo: \x28" localiza ( ou chr (40).
\uxxxx Localiza o caractere ASCII expresso pelo cdigo
Unicode xxxx.
Por exemplo: \u00A3" localiza .
[a-z] Localiza qualquer caractere no intervalo especificado.
Porexemplo:aexpresso[a-c]localizaa,bouc.
[xyz] Localiza qualquer caractere especificado em [ ].
Por exemplo: col[iu]na localiza colina e coluna.
[^xyz] Localiza qualquer caractere que no esteja em [ ].
Porexemplo:dr[^o]galocalizaqualquercombinao,
exceto droga.
. Localiza qualquer caractere exceto \n.
Por exemplo: a expresso a.b localiza aab e a3b,
mas no ab.
\w Localiza letras e dgitos. Equivale a [a-zA-Z_0-9].

\W Localiza qualquer caractere que no seja letra ou
dgito. Equivale a [^a-zA-Z_0-9].
VBScript
92
\d Localiza qualquer dgito. Equivale a [0-9].
\D Localiza qualquer no-dgito. Equivale a [^0-9].
\s Localiza qualquer caractere espao. Equivale a
[ \t\r\n\v\f].
\S Localiza qualquer caractere diferente de espao.
Equivale a [^\t\r\n\v\f].
{x} Localiza exatamente x ocorrncias de uma expresso
regular.
Por exemplo: a{3} equivale a aaa.
(x,} Localiza x ou mais ocorrncias de uma expresso
regular. Por exemplo: \s{2,} localiza pelo menos 2
caracteres espao.
{x,y} Localiza entre x e y ocorrncias de uma expresso
regular.
Por exemplo: \d{2,3} localiza pelo menos 2, mas no
mais que 3 dgitos.
? Localiza zero ou uma ocorrncia do caractere
precedente. Equivale a {0,1}.
Por exemplo: a expresso casas? localiza ambos
casa e casas.
* Localiza zero ou mais ocorrncias do caractere
precedente. Equivale a {0,}.
Por exemplo: a expresso fo* localiza ambos f e
foo.
+ Localiza uma ou mais ocorrncias do caractere
precedente. Equivale a {1,}.
Por exemplo: a expresso fo+ localiza foo mas no
f.
() Agrupa uma clusula para criar uma nova clusula.
Pode ser aninhada.
Por exemplo: (ab)?(c) localiza abc or c.
| Localiza qualquer uma das clusulas individuais.
Por exemplo: a expresso a|b localiza a ou b:.
VBScript
93
Informaes Adicionais
Sobre o Autor
RobertoGomesdeAguiarVeiganaturaldeBeloHorizonte,
Minas Gerais, cidade onde reside. Trabalha como Tcnico
de Informtica no Servio Federal de Processamento de
Dados (Serpro), empresa pblica da rea de informtica
vinculadaaoMinistriodaFazenda.Estlotadoatualmente
no Centro de Especializao BackOffice da
Superintendncia de Atendimento a Clientes do Serpro.
Dentre suas qualificaes, as mais importantes so a de
MicrosoftCertifiedSystemsEngineer(MCSE)eMicrosoft
Certified Professional + Internet (MCP + Internet).
O autor pode ser contatado atravs do email
raveiga@yahoo.com.
Sobre Este Guia

Esteguiabuscaserumaobraderefernciasucintasobreum
assuntosobreoqualnohttulosdisponveisnaslivrarias.
incrvel como o mercado editorial brasileiro, na rea de
informtica, restringese a alguns poucos assuntos. Eu
conheo pelo menos uma centena de livros sobre Windows
e Visual Basic e dzias de livros sobre Linux e Delphi, mas
no conheo nenhum outro, em lngua portuguesa, sobre o
WSH que no este modesto guia.
Quando decidiu adquirir este guia, provavelmente o que o
motivou foi o fato de que, assim como eu, voc tambm
acredita no grande potencial do WSH dentro das redes
empresariais baseadas na plataforma Windows. Acredito
que o WSH v se tornar to importante para o Windows
quanto o ASP importante para o Internet Information
Server, por isso me dediquei tanto ao seu aprendizado.
Acho que o leitor tambm far o mesmo e que este guia lhe
ser bastante til!
94
Palavra Final do Autor

Para os profissionais que decidiram dedicar suas vidas
informtica, o que vou dizer agora pode at parecer lugar
comum: manterse atualizado em novas tecnologias uma
questo de continuar ou no valioso para o mercado de
trabalho e de continuar empregado tambm! Portanto,
espero que o leitor, como profissional de informtica que ,
novejaesteguiacomoalgodefinitivosobreWSH.Consulte
principalmente os sites que indiquei ao longo deste guia em
buscadenovidades.Eulhesasseguro,elasexistirosempre.
Crticas e sugestes sero bemvindas (todo mundo sempre
dizisso!)epodemserenviadasaoemailinformadoabaixo.
Por fim, espero sinceramente que este guia auxilie voc,
meu caro leitor, nas suas tarefas cotidianas. Acredite em
mim, foi isso que me motivou a escrevlo.
Um grande abrao,
O Autor.
Notao utilizada neste Guia

Notao Significado
opo1 | opo2 ... Barras verticais separam itens alternativos
em uma lista.
[ ] Identifica valores opcionais que podem ou
no ser fornecidos pelo usurio. Digite
somente a informao dentro dos parnteses;
no digite os parnteses.
itlico Identifica um valor que deve ser fornecido
pelo usurio.
negrito Identifica palavras reservadas.
Comentrios e Sugestes
Comentrios e sugestes sobre este guia sero bastante
apreciados. Podem ser enviados para o email:
leitor@novateceditora.com.br
Conhea o site da Novatec Editora em:
www.novateceditora.com.br
95
ndice
Smbolos
.WSF 10
.WSH 9
<![CDATA[...]]> 11, 15
<?job ?> 11
<?XML ?> 11
<job> 11, 12
<object> 11, 12
<package> 11, 13
<reference> 11, 13
<resource> 11, 14
<script> 11, 14
A
Add 43, 44
AddPrinterConnection 31, 32
AddWindowsPrinterConnection 31, 33
ADSI 74
AppActivate 22, 24
Application 16, 17
Arguments 16, 17, 38
Arquivos .WSF 10
Arquivos .WSH 9
Asc 86
ASP 5
AtEndOfLine 68
AtEndOfStream 68
Attributes 58, 62, 63
AvailableSpace 55
B
BuildPath 46, 47
BuildVersion 16, 17
C
Call 85
CBool 86
CByte 86
CDate 86
Chr 86
CInt 86
Clear 87
Close 68, 69
Column 68, 69
CompareMode 43, 44
ComputerName 31
COMSPEC 23, 37
ConnectObject 19
Copy 58, 60, 62, 66
CopyFile 46, 48
CopyFolder 46, 48
Count 21, 22, 35, 36, 37, 40, 41, 43, 44
CreateFolder 46, 48
CreateObject 16, 19
CreateShortcut 22, 25
CreateTextFile 46, 49, 62, 67
Criptografando Scripts 16
CScript 8
CScript.exe 8
CStr 86
D
Date 86
DateCreated 58, 59, 62, 63
DateLastAcessed 58, 59, 62, 63
DateLastModified 58, 59, 62, 64
Delete 58, 61, 62, 66
DeleteFile 46, 49
DeleteFolder 46, 49
Description 38, 87
Dictionary 43
Dim 85
DisconnectObject 16, 20
Do... Loop 82
Drive 46, 55, 58, 59, 62, 64
DriveExists 46, 50
DriveLetter 55, 56
Drives 46, 47
DriveType 55, 56
E
Echo 16, 20
Elementos XML 10
Else 79
Empty 86
EnumNetworkDrives 31, 33
EnumPrinterConnections 31, 33
Environment 22, 23
Erase 85
Err 86, 87
Execute 89
Exists 43, 45
Exit 83
ExpandEnvironmentStrings 22, 25
F
False 86
File 46, 58
FileExists 46, 50
Files 46, 62, 64
FileSystem 55, 56
FileSystemObject 46
FirstIndex 90
Folder 46, 62
FolderExists 47, 50
Folders 46
For 81
For Each 83
FreeSpace 55, 56
FullName 16, 17, 38, 39, 42
Funes 84
G
GetAbsolutePathName 47, 51
GetBaseName 47, 51
GetDrive 47, 52
GetDriveName 47, 52
GetExtensionName 47, 52
GetFile 47, 52
GetFileName 47, 52
GetFolder 47, 53
GetObject 16, 20
GetParentFolderName 47, 53
GetSpecialFolder 47, 53
GetTempName 47, 53
Global 89
H
HelpContext 88
HelpFile 88
HOMEDRIVE 23, 37
HOMEPATH 23, 37
HotKey 38, 39
I
IconLocation 38, 39
If 79
IgnoreCase 89
InputBox 86
Interactive 16, 17
IsReady 55, 56
IsRootFolder 62, 64
Item 21, 35, 36, 40, 41, 43, 44
Items 43, 45
K
Key 43, 44
Keys 43, 45
96
ndice
L
Left 86
Len 86
lenght 21, 22, 35, 36, 37, 40, 41
Length 90
Line 68, 69
LogEvent 22, 25
Loops 81
M
MapNetworkDrive 31, 33
Match 90
Matches 90
Move 58, 61, 62, 67

MoveFile 47, 54
MoveFolder 47, 54
MsgBox 86
N
Name 16, 18, 58, 59, 62, 64
Nothing 86
Now 86
Null 86
Number 87
NUMBER_OF_PROCESSORS 23, 37
O
Objeto Wscript 16
Objetos do WSH 16
On Error 85
OpenAsTextStream 58, 61
OpenTextFile 47, 54
Operadores 84
Option Explicit 85
OS 23, 37
P
ParentFolder 58, 59, 62, 65
PATH 23, 37
Path 16, 18, 55, 57, 58, 59, 62, 65
PATHEXT 23, 37
Pattern 90
Popup 22, 26
Preserve 85
PROCESSOR_ARCHITECTURE 23, 37
PROCESSOR_IDENTIFIER 23, 37
PROCESSOR_LEVEL 23, 37
PROCESSOR_REVISION 23, 37
PROMPT 23, 37
Q
Quit 16, 20
R
Raise 87
Read 68, 69
ReadAll 68, 70
ReadLine 68, 70
Redim 85
RegDelete 22, 27
RegExp 86, 88
RegRead 22, 27
RegWrite 22, 28
Rem 85
Remove 36, 37, 43, 45
RemoveAll 43, 45
RemoveNetworkDrive 31, 34
RemovePrinterConnection 31, 34
Replace 89
Right 86
RootFolder 55, 57
Run 22, 28
S
Save 38, 40, 42
ScriptEncoder 77
ScriptFullName 16, 18
ScriptName 16, 18
Scripts de Logon 75
Select Case 80
SendKeys 22, 29
SerialNumber 55, 57
Set 85
SetDefaultPrinter 31, 35
ShareName 55, 57
ShortName 58, 60, 62, 65
ShortPath 58, 60, 62, 65
Size 58, 60, 62, 65
Skip 68, 70
SkipLine 68, 71
Sleep 16, 21
Source 88
SpecialFolders 22, 24
StdErr 16, 18, 19
StdIn 16, 18
StdOut 16
Sub-Rotinas 83
SubFolders 62, 66
SYSTEMDRIVE 23, 37
SYSTEMROOT 23, 37
T
TargetPath 38, 39, 42
TEMP 23, 37
Test 89
TextStream 46, 68
Time 86
TimeOut 16, 19
TMP 23, 37
TotalSize 55, 57
Trim 86
Type 58, 60, 66
U
UserDomain 31, 32
UserName 31, 32
V
Value 90
VBScript 78
Version 16, 19
VolumeName 55, 57
W
While... Wend 82
WIN32 73
WINDIR 23, 37
Windows Script Components 76
WindowsStyle 38
WindowStyle 39
WorkingDirectory 38, 40
Write 68, 71
WriteBlankLines 68, 72
WriteLine 68, 72
WScript 8
WScript.exe 8
WshArguments 21
WshCollection 35
WshEnvironment 36
WshNetwork 31
WshShell 22
WshShortcut 38
WshSpecialFolders 40
WshURLShortcut 41
X
XML 10

Windows Script Host

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Windows Script Host

Enviado por

Direitos autorais:

Formatos disponíveis

Novatec Editora

Guia de Consulta Rpida Windows Script Host de

Todos os direitos reservados. proibida a reproduo

desta obra, mesmo parcial, por qualquer processo, sem

Rua Cons. Moreira de Barros 1084 Conj. 01

Microsoft, Windows, Windows NT, Active Directory,

Por que usar o WSH?................................................... 6

Classes WIN32 .......................................................... 73

Ao executar o arquivo .vbs, ser exibida a seguinte caixa de

Por que usar o WSH?

a tecnologia ActiveX da Microsoft.

Executando um script WSH

Executando um script WSH

Quando for executar o arquivo .wsh atravs da linha de

comando, ou da caixa de dilogo Executar, d duplo clique

Utilizao de Elementos XML

Propriedades do objeto Wscript

Especifica se o script ser executado em modo interativo

Fornece uma string com a verso do Windows Script que

Mtodos do objeto Wscript

prefixo Chama um procedimento dentro do script cujo nome

Encerra a execuo do script com o cdigo de erro

Propriedades do objeto WshArguments

Propriedades do objeto WshShell

VOLATILE ou PROCESS no Windows NT e apenas

As principais variveis de ambiente so:

Mtodos do objeto WshShell

Rem Exibe o nome do sistema operacional:

omitido, ser exibido Windows Script Host.

O mtodo Popup sempre retorna um inteiro, representando

Esses valores das chavesraiz servem tambm para os

Set WshShell = Wscript.CreateObject(Wscript.Shell)

Alguns caracteres especiais, como a tecla de espao ou a

SETA P/ DIREITA {RIGHT}

Os caracteres de soma (+), percentagem (%), acento

Propriedades do objeto WshNetwork

Mtodos do objeto WshNetwork

strImpressoraRemotaCaminho para a impressora remota, do tipo

disco de rede Z::

Propriedades do objeto WshCollection

Propriedades do objeto WshEnvironment

As principais variveis de ambiente so:

(.com, .exe, .bat, etc.).

O objeto WshShortcut no explicitamente acessado. Para

Propriedades do objeto WshShortcut

Os valores possveis para intEstiloDaJanela so:

Fornece a pasta de trabalho do atalho.

Mtodo do objeto WshShortcut

Mtodo do objeto WshURLShortcut

No exemplo abaixo criado um objeto Dictionary

O mtodo Keys retorna uma matriz contendo todas as

Com o FSO voc poder:

caminho Caminho ao final do qual se quer adicionar um nome.

fSubstituir Se True, substituir os arquivos homnimos caso haja

strCaminho Caminho completo para o arquivo.

strCaminho Caminho completo para uma pasta ou arquivo.

Set f = fso.OpenTextFile(strArquivo [,intModoDeAbertura]

IsReady Retornar True se o drive estiver pronto para ser

Propriedades do objeto Drive

Propriedades do objeto File

Set fso = CreateObject(Scripting.FileSystemObject)

conveno de nomenclatura do MSDOS (8.3).

Mtodos do objeto File

Set objFile = fso.GetFile(strArquivo)