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
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 |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|