Sitzungsobjekt (WSManDisp.h)
Definiert Vorgänge und Sitzungseinstellungen. Alle Windows Remoteverwaltungsvorgänge erfordern die Erstellung einer Sitzung, die eine Verbindung mit einem Remotecomputer, einem Basisverwaltungscontroller (Base Management Controller, BMC) oder dem lokalen Computer herstellt. WinRM-Netzwerkvorgänge umfassen das Abrufen, Schreiben oder Aufzählen von Daten oder das Aufrufen von Methoden. Die Methoden des Session-Objekts spiegeln die grundlegenden Vorgänge wider, die im WS-Management definiert sind.
Member
Das Session-Objekt verfügt über die folgenden Membertypen:
Methoden
Das Session-Objekt verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Erstellen | Erstellt eine neue Instanz einer Ressource und gibt den URI des neuen -Objekts zurück. |
| Löschen | Löscht die im Ressourcen-URI angegebene Ressource. |
| Aufzählen | Enumeriert eine Sammlung, Tabelle oder Nachrichtenprotokollressource. |
| Erhalten | Ruft eine Ressource aus dem Dienst ab und gibt eine XML-Darstellung der aktuellen Instanz der Ressource zurück. |
| Identifizieren | Fragt einen Remotecomputer ab, um zu ermitteln, ob er das WS-Management unterstützt. |
| Invoke | Ruft eine Methode auf, die die Ergebnisse des Methodenaufrufs zurückgibt. |
| Put | Aktualisieren Sie eine Ressource. |
Eigenschaften
Das Session-Objekt verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | Beschreibung |
|---|---|---|
| BatchItems |
Lesen/Schreiben |
Legt die Anzahl der Elemente in jedem Enumerationsbatch fest und ruft sie ab. Dieser Wert kann während einer Enumeration nicht geändert werden. Standardmäßig ist der Standardwert eine unbegrenzte Anzahl von Elementen. Der Ressourcenanbieter kann einen Grenzwert festlegen. |
| Fehler |
Schreibgeschützt |
Ruft zusätzliche Fehlerinformationen in einem XML-Stream ab. |
| Timeout |
Lesen/Schreiben |
Legt die maximale Wartezeit (in Millisekunden) für die Clientanwendung fest und ruft sie ab. |
Hinweise
Das Session-Objekt entspricht der IWSManSession-Schnittstelle.
Beispiele
Das folgende VBScript-Codebeispiel zeigt, wie ein Session-Objekt erstellt wird.
' Create a WSMan object.
Dim objWsman
Set objWsman = CreateObject( "WSMAN.Automation" )
' Create Session object.
Dim objSession
Set objSession = objWsman.CreateSession
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Idl |
|
| Bibliothek |
|
| DLL |
|