Compartilhar via


Objeto SWbemPropertySet

Um objeto SWbemPropertySet é uma coleção de objetos SWbemProperty. Você pode adicionar itens à coleção usando o método Add, recuperar itens da coleção usando o método Item e remover itens da coleção usando o método Remove. Para obter mais informações, consulte Acessar uma coleção. Esse objeto não pode ser criado pela chamada CreateObject do VBScript.

Os objetos SWbemProperty que compõem uma coleção SWbemPropertySet são usados para descrever as propriedades de uma só classe ou instância do WMI.

Membros

O objeto SWbemPropertySet tem estes tipos de membros:

Métodos

O objeto SWbemPropertySet tem esses métodos.

Método Descrição
Adicionar Adiciona um objeto SWbemProperty à coleção SWbemPropertySet.
Item Obtém uma SWbemProperty nomeada da coleção. Esse é o método padrão para esse objeto.
Remover Exclui um objeto SWbemProperty da coleção .

Propriedades

O objeto SWbemPropertySet tem essas propriedades.

Propriedade Tipo de acesso Descrição
Contagem
Somente leitura
O número de itens na coleção SWbemPropertySet.

Exemplos

O exemplo de VBScript a seguir demonstra como SWbemPropertySet.Remove poderá retornar wbemErrResetToDefault se a propriedade for substituída.

on error resume next 

'Create a keyed class with a defaulted property
set service = GetObject("Winmgmts:")
set emptyclass = service.Get
emptyclass.path_.class = "REMOVETEST00"
set prop = emptyclass.properties_.add ("p", 19)

prop.qualifiers_.add "key", true
emptyclass.properties_.add ("q", 19).Value = 12

emptyclass.put_

'create an instance and override the property
set instance = service.get ("RemoveTest00").spawninstance_

instance.properties_("q").Value = 24
instance.properties_("p").Value = 1
instance.put_

'retrieve the instance and remove the property
set instance = service.get ("removetest00=1")
set property = instance.properties_ ("q")

WScript.echo "Overridden value of property is [24]:", property.value
WScript.echo ""

instance.properties_.remove "q"
set property = instance.properties_ ("q")
WScript.echo "Value of property after removal is [12]:", property.value
WScript.echo ""

if err <> 0 then
 WScript.Echo "0x" & Hex(Err.Number), Err.Description, Err.Source
end if

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_SWbemPropertySet
IID
IID_ISWbemPropertySet

Confira também

Criar script de objetos de API