Enumerator (oggetto)

Rappresenta un flusso di risultati restituiti dalle operazioni, ad esempio un'operazione Pull. Ad esempio, il metodo Session.Enumerate restituisce più risultati.

Membri

L'oggetto Enumeratore ha questi tipi di membri:

Metodi

L'oggetto Enumeratore dispone di questi metodi.

Metodo Descrizione
ReadItem Recupera un elemento dalla risorsa e restituisce una rappresentazione XML dell'elemento.

Proprietà

L'oggetto Enumeratore ha queste proprietà.

Proprietà Descrizione
AtEndOfStream
Ottiene un valore booleano che indica se sono presenti più elementi nella raccolta.
Errore
Ottiene una rappresentazione XML di informazioni aggiuntive sull'errore.

Commenti

Per avviare un'enumerazione, usare Session.Enumerate. Per eseguire un'operazione WS-Enumeration:Pull che continua a leggere gli elementi nell'enumerazione, usare Enumerator.ReadItem.

L'oggetto Enumeratore corrisponde all'interfaccia IWSManEnumerator .

Esempio

Nell'esempio di codice VBScript seguente vengono enumerati tutti i dischi in un computer remoto specificato dal nome di dominio completo (servername.domain.com). La subroutine DisplayOutput formatta l'output dei dati nello stesso modo dello strumento WinRM.cmd.

Option Explicit

Const RemoteComputer = "MIG50-64D.mig.net"

Dim objWsman, objSession, strResource
Dim objResultSet

Set objWsman = CreateObject( "WSMan.Automation" )
Set objSession = objWsman.CreateSession( "https://" _
    & RemoteComputer )
strResource = "http://schemas.microsoft.com/wbem/wsman/1/" _
     & "wmi/root/cimv2/Win32_OperatingSystem"
Dim iFlag
iFlag = objWsman.EnumerationFlagReturnObjectAndEPR or _
    objWsman.EnumerationFlagHierarchyDeep
Set objResultSet = _
    objSession.Enumerate( strResource, "", "",  iFlag)
While Not objResultSet.AtEndOfStream
    DisplayOutput( objResultSet.ReadItem ) 
Wend


'****************************************************
' Displays WinRM XML message using built-in XSL
'****************************************************
Sub DisplayOutput( strWinRMXml )
    Dim xmlFile, xslFile
    Set xmlFile = CreateObject( "MSXml2.DOMDocument.3.0" ) 
    Set xslFile = CreateObject( "MSXml2.DOMDocument.3.0" )
    xmlFile.LoadXml( strWinRMXml )
    xslFile.Load( "WsmTxt.xsl" )
    Wscript.Echo xmlFile.TransformNode( xslFile ) 
End Sub

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Intestazione
WSManDisp.h
IDL
WSManDisp.idl
Libreria
WSManDisp.tlb
DLL
WSMAuto.dll

Vedi anche

WinRM Scripting API

Enumerazione o elenco di tutte le istanze di una risorsa

Scripting in Gestione remota Windows