Session.Enumerate, méthode

Article
06/12/2023

É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 liste de 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’un des éléments suivants :

URI de la ressource.

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

Objet ResourceLocator .
Une référence de point de terminaison WS-Addressing comme décrit dans la norme de protocole WS-Management. Pour plus d’informations sur la spécification publique du protocole de gestion WS, consultez Page d’index des spécifications de gestion.

filter [in, facultatif]

Filtre qui définit les éléments de la ressource qui sont 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 Interrogation d’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 , le service Gestion à distance Windows retourne le code d’erreur ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Si un filtre est spécifié, il doit s’agir d’un document valide en ce qui concerne le 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 flags . 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 énumération efface les demandes d’énumération en attente. La sous-routine DisplayOutput utilise le fichier de transformation XML de l’outil de commande Winrm (WsmTxt.xsl) pour générer les données sous forme 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