Lire en anglais

Partager via


Enumerator (objet)

Représente un flux de résultats retournés par des opérations, telles qu’une opération Pull. Par exemple, la méthode Session.Enumerate retourne plusieurs résultats.

Membres

L’objet Enumerator a les types de membres suivants :

Méthodes

L’objet Enumerator a ces méthodes.

Méthode Description
ReadItem Récupère un élément de la ressource et retourne une représentation XML de l’élément.

Propriétés

L’objet Enumerator a ces propriétés.

Propriété Description
AtEndOfStream
Obtient une valeur booléenne qui indique s’il y a plus d’éléments dans la collection.
Error
Obtient une représentation XML d’informations d’erreur supplémentaires.

Notes

Pour démarrer une énumération, utilisez Session.Enumerate. Pour effectuer une opération WS-Enumeration:Pull qui poursuit la lecture des éléments de l’énumération, utilisez Enumerator.ReadItem.

L’objet Enumerator correspond à l’interface IWSManEnumerator.

Exemples

L’exemple de code VBScript suivant énumère tous les disques d’un ordinateur distant spécifiés par le nom de domaine complet (servername.domain.com). La sous-routine DisplayOutput met en forme la sortie des données de la même façon que l’outil 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

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
WSManDisp.h
IDL
WSManDisp.idl
Bibliothèque
WSManDisp.tlb
DLL
WSMAuto.dll

Voir aussi

API de script WinRM

Énumération ou liste de toutes les instances d’une ressource

Création de scripts dans la gestion à distance windows