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 |
|
IDL |
|
Libreria |
|
DLL |
|