Partilhar via


Objeto SWbemObject

Você pode usar os métodos e as propriedades do objeto SWbemObject para representar uma instância de objeto ou de definição de classe WMI (Instrumentação de Gerenciamento do Windows). Esse objeto não pode ser criado pela chamada CreateObject do VBScript.

Esse objeto dá suporte a dois tipos de propriedades e métodos. Os definidos nesta seção são propriedades e métodos genéricos que se aplicam a todos os objetos WMI. Além disso, esse objeto expõe as propriedades e os métodos do objeto subjacente como propriedades de automação dinâmica e métodos do SWbemObject. Os nomes e tipos dessas propriedades e métodos dependem do objeto WMI subjacente. Para obter mais informações sobre como essas propriedades e métodos dinâmicos são expostos, consulte Manipular informações de classe e de instância.

Da perspectiva do cliente WMI, esse objeto está sempre em processo. As operações de gravação afetam apenas a cópia local do objeto e as operações de leitura sempre recuperam valores da cópia local. As atualizações no WMI são realizadas apenas quando objetos inteiros são gravados usando uma chamada para o método SWbemObject.Put_. Se você modificar as propriedades ou os métodos em um objeto SWbemObject, suas alterações não serão gravadas no WMI até que você chame o SWbemObject.Put_.

O método genérico e os nomes de propriedade definidos nesta seção sempre terminam com um sublinhado à direita ("_") para diferenciá-los dos métodos e propriedades WMI dinâmicos do objeto subjacente.

Observe que o SWbemObject não pode ser criado usando o método GetObject.do do VBScript. Se você quiser criar uma nova classe vazia, use SWbemServices.Get com um parâmetro de caminho vazio. Essa chamada retorna um objeto SWbemObject vazio que pode se tornar uma classe. Em seguida, você pode fornecer um nome de classe para a propriedade Class do objeto SWbemObjectPath retornado pela chamada Path_. Adicione propriedades à nova classe pelo método Properties_. Para criar uma instância, chame GetObject na nova classe.

O exemplo de código a seguir mostra como obter uma nova classe e adicionar uma propriedade a ela. O objeto SWbemObject que representa a classe deve ser gravado novamente no repositório WMI por meio de uma chamada para Put_.

wbemCimtypeString = 8
Set objSWbemService = GetObject("Winmgmts:root\default")
Set objClass = objSWbemService.Get()
objClass.Path_.Class = "NewClass"

' Add a property
' String property
objClass.Properties_.add "PropertyName", wbemCimtypeString  
' Make the property a key property 
objClass.Properties_("PropertyName").Qualifiers_.add "key", true

' Write the new class to the root\default namespace in the repository
Set objClassPath = objClass.Put_
WScript.Echo objClassPath.Path

'Create an instance of the new class using SWbemObject.SpawnInstance
Set objNewInst = GetObject( _
    "Winmgmts:root\default:NewClass").Spawninstance_

objNewInst.PropertyName = "My Instance"

' Write the instance into the repository
Set objInstancePath = objNewInst.Put_
WScript.Echo objInstancePath.Path

Você pode examinar o repositório com uma ferramenta de exibição, como o CIM Studio, para verificar se as novas classe e instância aparecem. Para obter um exemplo de como remover uma classe e uma instância do repositório, consulte SWbemServices.Delete ou SWbemObject.Delete_.

Membros

O objeto SWbemObject tem estes tipos de membros:

Métodos

O objeto SWbemObject tem esses métodos.

Método Descrição
Associators_ Recupera os associadores do objeto.
AssociatorsAsync_ Recupera de forma assíncrona os associadores do objeto.
Clone_ Cria uma nova cópia do objeto atual.
CompareTo_ Testa dois objetos quanto à igualdade.
Delete_ Exclui o objeto do WMI.
DeleteAsync_ Exclui de forma assíncrona o objeto do WMI.
ExecMethod_ Executa um método exportado por um provedor de método.
ExecMethodAsync_ Executa de forma assíncrona um método exportado por um provedor de métodos.
GetObjectText_ Recupera a representação textual do objeto (sintaxe MOF).
Instances_ Retorna uma coleção de instâncias do objeto (que deve ser uma classe WMI).
InstancesAsync_ Retorna de forma assíncrona uma coleção de instâncias do objeto (que deve ser uma classe WMI).
Put_ Cria ou atualiza o objeto no WMI.
PutAsync_ Cria ou atualiza de forma assíncrona o objeto no WMI.
References_ Retorna referências ao objeto.
ReferencesAsync_ Retorna de forma assíncrona referências ao objeto.
SpawnDerivedClass_ Cria uma nova classe derivada do objeto atual (que deve ser uma classe WMI).
SpawnInstance_ Cria uma nova instância a partir do objeto atual.
Subclasses_ Retorna uma coleção de subclasses do objeto (que deve ser uma classe WMI).
SubclassesAsync_ Retorna de forma assíncrona uma coleção de subclasses do objeto (que deve ser uma classe WMI).

Propriedades

O objeto SWbemObject tem essas propriedades.

Propriedade Tipo de acesso Descrição
Derivation_
Somente leitura
Contém uma matriz de cadeias de caracteres que descreve a hierarquia de derivação da classe.
Methods_
Somente leitura
Um objeto SWbemMethodSet que é a coleção de métodos para esse objeto.
Path_
Somente leitura
Contém um objeto SWbemObjectPath que representa o caminho do objeto da classe ou da instância atual.
Properties_
Somente leitura
Um objeto SWbemPropertySet que é a coleção de propriedades desse objeto.
Qualifiers_
Somente leitura
Um objeto SWbemQualifierSet que é a coleção de qualificadores desse objeto.
Security_
Somente leitura
Contém um objeto SWbemSecurity usado para ler ou alterar as configurações de segurança.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObject
IID
IID_ISWbemObject

Confira também

SWbemObjectEx

Objetos da API de Script