Enumerator (oggetto)

Articolo
06/12/2023

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
Proprietà

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

Condividi tramite