Objet session (WSManDisp.h)

Définit les opérations et les paramètres de session. Toutes les opérations de gestion à distance Windows nécessitent la création d’une session qui se connecte à un ordinateur distant, à un contrôleur de gestion de base (BMC) ou à l’ordinateur local. Les opérations réseau WinRM incluent l’obtention, l’écriture ou l’énumération de données ou l’appel de méthodes. Les méthodes de l’objet Session miroir les opérations de base définies dans le protocole WS-Management.

Membres

L’objet Session a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

L’objet Session possède ces méthodes.

Méthode	Description
Créer	Crée une instance d’une ressource et retourne l’URI du nouvel objet.
Supprimer	Supprime la ressource spécifiée dans l’URI de ressource.
Énumérer	Énumère une collection, une table ou une ressource de journal des messages.
Avoir	Récupère une ressource à partir du service et retourne une représentation XML de la instance actuelle de la ressource.
Identifier	Interroge un ordinateur distant pour déterminer s’il prend en charge le protocole WS-Management
Appeler	Appelle une méthode qui retourne les résultats de l’appel de méthode.
Put	Met à jour une ressource.

Propriétés

L’objet Session possède ces propriétés.

Propriété	Type d’accès	Description
BatchItems	Lecture/écriture	Définit et obtient le nombre d’éléments dans chaque lot d’énumération. Cette valeur ne peut pas être modifiée pendant une énumération. Par défaut, la valeur par défaut est un nombre illimité d’éléments. Le fournisseur de ressources peut définir une limite.
Error	Lecture seule	Obtient des informations d’erreur supplémentaires dans un flux XML.
Délai d'expiration	Lecture/écriture	Définit et obtient la durée maximale (en millisecondes) d’attente de l’application cliente.

Notes

L’objet Session correspond à l’interface IWSManSession.

Exemples

L’exemple de code VBScript suivant montre comment créer un objet Session .

' Create a WSMan object.
Dim objWsman 
Set objWsman = CreateObject( "WSMAN.Automation" )

' Create Session object.
Dim objSession
Set objSession = objWsman.CreateSession

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

WinRM Scripting API

À propos de la gestion à distance Windows

Utilisation de la gestion à distance Windows

Création de scripts dans La gestion à distance Windows

Obtention de données à partir de l’ordinateur local

Obtention de données à partir d’un ordinateur distant