Metodo Session.Enumerate

Articolo
06/12/2023

Enumera una tabella, una raccolta di dati o una risorsa di log. Per creare una query, includere un parametro di filtro e un parametro di dialetto in un'enumerazione. È anche possibile usare un oggetto ResourceLocator per creare query. Per altre informazioni, vedere Enumerazione o elenco di tutte le istanze di una risorsa.

Sintassi

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

Parametri

resourceUri [in]

Identificatore della risorsa da recuperare.

Questo parametro può contenere uno dei seguenti elementi:

URI della risorsa.

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

Oggetto ResourceLocator .
Riferimento all'endpoint WS-Addressing come descritto nello standard del protocollo WS-Management. Per altre informazioni sulla specifica pubblica per WS-Management Protocol, vedere Pagina relativa all'indice delle specifiche di gestione.

filtro [in, facoltativo]

Filtro che definisce gli elementi nella risorsa restituiti dall'enumerazione . Quando la risorsa viene enumerata, vengono restituiti solo gli elementi che corrispondono ai criteri di filtro. L'inclusione di un parametro di filtro e di un parametro di dialetto in un'enumerazione converte l'enumerazione in una query. Per un esempio, vedere Esecuzione di query per istanze specifiche di una risorsa.

Se si dispone di un oggetto ResourceLocator per il parametro resourceURI , questo parametro non deve essere usato.

dialetto [in, facoltativo]

Lingua utilizzata dal filtro. WQL, un subset di SQL usato da WMI, è l'unico linguaggio supportato.

Se si dispone di un oggetto ResourceLocator per il parametro resourceURI , questo parametro non deve essere usato.

flag [in, facoltativo]

Parametro che deve contenere un flag nell'enumerazione __WSManEnumFlags . Per altre informazioni, vedere Costanti di enumerazione.

Valore restituito

Oggetto Enumeratore che contiene i risultati dell'enumerazione.

Commenti

Per altre informazioni sulla limitazione delle chiamate di rete durante un'enumerazione, vedere la proprietà BatchItems .

Tenere presente che se i flag includono le costanti di enumerazioneWSManFlagHierarchyDeepBasePropsOnly o WSManFlagHierarchyShallow , il servizio Gestione remota Windows restituisce il codice di errore ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Se viene specificato un filtro, deve essere un documento valido rispetto allo schema della risorsa. Il parametro di dialetto è facoltativo. Tuttavia, se la stringa di filtro inizia con <, ma non è un frammento XML, includere il parametro di dialetto o impostare il flag WSManFlagNonXmlText nel parametro flags . Per altre informazioni, vedere Costanti di enumerazione.

Il metodo C++ corrispondente è IWSManSession::Enumerate.

Esempio

Nell'esempio di codice VBScript seguente vengono enumerate le istanze di Win32_LogicalDisk in un computer remoto specificato dal nome di dominio completo (servername.domain.com). Tenere presente che liberando l'oggetto di enumerazione vengono cancellate le richieste di enumerazione in sospeso. La subroutine DisplayOutput usa il file di trasformazione XML dello strumento da riga di comando Winrm (WsmTxt.xsl) per restituire i dati in un formato tabulare.

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

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

sessione
Esecuzione di query per istanze specifiche di una risorsa
BatchItems
ResourceLocator