Tarefas do WMI: arquivos e pastas

  • Artigo

As tarefas do WMI para arquivos e pastas alteram as propriedades de arquivo ou pasta por meio da WMI, incluindo a criação de um compartilhamento ou a renomeação de um arquivo. Se você quiser copiar um arquivo ou ler e gravar um arquivo, a maneira mais fácil é usar o Arquivo de Host de Script do WindowsSystemObject, em vez do WMI. Para obter outros exemplos, confira a seção Arquivos e Pastas do TechNet ScriptCenter.

CIM_DataFile é uma das poucas classes CIM no WMI que são implementadas. Evite enumerar ou consultar todas as instâncias de CIM_DataFile em um computador, pois o volume de dados provavelmente afetará o desempenho ou fará com que o computador pare de responder.

Os exemplos de script mostrados neste tópico obtêm dados somente do computador local. Para obter mais informações sobre como usar o script para obter dados de computadores remotos, confira Como conectar-se ao WMI em um computador remoto.

O procedimento a seguir descreve como executar um script.

Para executar um script

  1. Copie o código e salve-o em um arquivo com a extensão .vbs, por exemplo, nomedoarquivo.vbs. Verifique se o editor de texto não adicionou a extensão .txt ao arquivo.
  2. Abra uma janela do prompt de comando e navegue até o diretório no qual deseja salvar o arquivo.
  3. Digite cscript nomedoarquivo.vbs no prompt de comando.
  4. Se você não conseguir acessar um log de eventos, verifique se está executando a partir de um prompt de comandos com privilégios elevados. Alguns logs de eventos, como o Log de Eventos de Segurança, podem ser protegidos por UAC (Controles de Conta de Usuário).

Observação

Por padrão, o cscript exibe a saída de um script na janela do prompt de comando. Como os scripts do WMI podem gerar uma grande quantidade de saída, pode ser interessante redirecionar essa saída para um arquivo. Digite cscript nomedoarquivo.vbs > arquivodesaida.txt no prompt de comando para redirecionar a saída do script nomedoarquivo.vbs para arquivodesaida.txt.

A tabela a seguir lista exemplos de script que podem ser usados para obter diversos tipos de dados do computador local.

Como fazer... Classes ou métodos do WMI
... renomear um arquivo sem receber uma mensagem de erro? Use a classe CIM_DataFile. Verifique se você passa o nome do caminho inteiro ao chamar o método Rename, por exemplo, "C:\Scripts\Test.txt", em vez de "Text.txt". No PowerShell, usar o CIM_DataFile pode ser ineficiente. Dessa forma, você pode simplesmente usar o cmdlet Rename-Item.
VB 
strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery ("Select * from CIM_DataFile where Name = " & "'c:\\scripts\\toggle_service.vbs'")
For Each objFile in colFiles
    errResult = objFile.Rename("c:\scripts\toggle_service.old")
Next
PowerShell 
rename-item c:\scripts\toggle_service.vbs toggle_service.old
... determinar se os usuários têm arquivos .MP3 armazenados no computador?

Use a classe CIM_DataFile e selecione arquivos usando a seguinte cláusula WHERE do WQL: Where Extension = "MP3".

VB 
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Extension = 'mp3'")
For Each objFile in colFiles
    Wscript.Echo "File Name: " & objFile.Name & "." & objFile.Extension
    Wscript.Echo "Path: " & objFile.Path
Next
PowerShell 
Get-WmiObject -Class CIM_DataFile -namespace "root\cimv2" -Filter "Extension = 'mp3'" | `
   format-list Name, Extension, Path
... criar pastas compartilhadas em um computador?

Use a classe Win32_Share e o método Create.

VB 
Const FILE_SHARE = 0
Const MAXIMUM_CONNECTIONS = 25
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNewShare = objWMIService.Get("Win32_Share")
errReturn = objNewShare.Create("C:\Finance", "FinanceShare", FILE_SHARE, MAXIMUM_CONNECTIONS, "Public share for the Finance group.")

PowerShell 
$FILE_SHARE = 0 $MAXIMUM_CONNECTIONS = 25 
$NewDir = new-item C:\Finance -type directory
$Shares= [WMICLASS]"Win32_Share"
[void]$Shares.Create("C:\Finance","FinanceShare", $FILE_SHARE, $MAXIMUM_CONNECTIONS, "Public share for the Finance group.")
... copiar uma pasta?

Use a classe Win32_Directory e o método Copy. No PowerShell, você pode simplesmente usar o cmdlet Copy-Item.

VB 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colFolders = objWMIService.ExecQuery("Select * from Win32_Directory where Name = 'c:\\Scripts'") 
 
For Each objFolder in colFolders 
    errResults  = objFolder.Copy("D:\Archive") 
Next
PowerShell 
Copy-Item C:\Scripts -Destination D:\Archive -Recurse
... mover uma pasta?

Use a classe Win32_Directory e o método Rename. No PowerShell, você pode simplesmente usar o cmdlet Move-Item.

VB 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colFolders = objWMIService.ExecQuery _ 
    ("Select * from Win32_Directory where name = 'c:\\Scripts'") 
 
For Each objFolder in colFolders 
    errResults = objFolder.Rename("C:\Admins\Documents\Archive\VBScript") 
Next
PowerShell 
move-item -path C:\Scripts -destination C:\Admins\Documents\Archive\PowerShell

Tarefas do WMI para scripts e aplicativos

Exemplos de aplicativo C++ do WMI

TechNet ScriptCenter

`