Méthode Session.Enumerate

Énumère une table, une collection de données ou une ressource de journal. Pour créer une requête, incluez un paramètre de filtre et un paramètre dialecte dans une énumération. Vous pouvez également utiliser un objet ResourceLocator pour créer des requêtes. Pour plus d’informations, consultez Énumération ou lister toutes les instances d’une ressource.

Syntaxe

Session.Enumerate( _
  ByVal resourceUri, _
  [ ByVal filter ], _
  [ ByVal dialect ], _
  [ ByVal flags ] _
)

Paramètres

resourceUri [in]

Identificateur de la ressource à récupérer.

Ce paramètre peut contenir l’une des options suivantes :

filter [in, facultatif]

Filtre qui définit les éléments de la ressource retournés par l’énumération. Lorsque la ressource est énumérée, seuls les éléments qui correspondent aux critères de filtre sont retournés. L’inclusion d’un paramètre de filtre et d’un paramètre dialecte dans une énumération convertit l’énumération en requête. Pour obtenir un exemple, consultez Interroger des instances spécifiques d’une ressource.

Si vous avez un objet ResourceLocator pour le paramètre resourceURI , ce paramètre ne doit pas être utilisé.

dialecte [in, facultatif]

Langue utilisée par le filtre. WQL, un sous-ensemble de SQL utilisé par WMI, est le seul langage pris en charge.

Si vous avez un objet ResourceLocator pour le paramètre resourceURI , ce paramètre ne doit pas être utilisé.

indicateurs [in, facultatif]

Paramètre qui doit contenir un indicateur dans l’énumération __WSManEnumFlags . Pour plus d’informations, consultez Constantes d’énumération.

Valeur retournée

Objet Énumérateur qui contient les résultats de l’énumération.

Notes

Pour plus d’informations sur la limitation des appels réseau pendant une énumération, consultez la propriété BatchItems .

N’oubliez pas que si les indicateurs incluent les constantes d’énumérationWSManFlagHierarchyDeepBasePropsOnly ou WSManFlagHierarchyShallow, Windows service de gestion à distance retourne le code d’erreur ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Si un filtre est spécifié, il doit s’agir d’un document valide par rapport au schéma de la ressource. Le paramètre dialecte est facultatif. Toutefois, si la chaîne de filtre commence par <, mais n’est pas un fragment XML, incluez le paramètre dialecte ou définissez l’indicateur WSManFlagNonXmlText dans le paramètre indicateurs . Pour plus d’informations, consultez Constantes d’énumération.

La méthode C++ correspondante est IWSManSession::Enumerate.

Exemples

L’exemple de code VBScript suivant énumère les instances Win32_LogicalDisk sur un ordinateur distant spécifié par le nom de domaine complet (servername.domain.com). N’oubliez pas que la libération de l’objet d’énumération efface les demandes d’énumération en attente. La sous-routine DisplayOutput utilise le fichier de transformation XML de l’outil en ligne de commande Winrm (WsmTxt.xsl) pour générer les données dans un formulaire tabulaire.

Const RemoteComputer = "servername.domain.com"
Set objWsman = CreateObject( "WSMan.Automation" )

Set objSession = objWsman.CreateSession( "https://" & REMOTECOMPUTER )

strResource = "http://schemas.microsoft.com/wbem/wsman/1/" &_
              "wmi/root/cimv2/Win32_LogicalDisk"

Set objResultSet = objSession.Enumerate( strResource )

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

session

Interrogation d’instances spécifiques d’une ressource

BatchItems

ResourceLocator