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 (BMC ) oder einem 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 Spiegel die grundlegenden Vorgänge, die im WS-Management-Protokoll definiert sind.
Member
Das Session-Objekt weist auch die folgenden Arten von Membern auf:
Methoden
Das Session-Objekt verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Erstellen | Erstellt einen neuen instance einer Ressource und gibt den URI des neuen Objekts zurück. |
| Löschen | Löscht die im Ressourcen-URI angegebene Ressource. |
| Aufzählen | Listet eine Sammlungs-, Tabellen- oder Nachrichtenprotokollressource auf. |
| Get | Ruft eine Ressource aus dem Dienst ab und gibt eine XML-Darstellung der aktuellen instance der Ressource zurück. |
| Identify | Fragt einen Remotecomputer ab, um festzustellen, ob er das WS-Management-Protokoll 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 die Standardeinstellung 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 fest und ruft die maximale Zeit (in Millisekunden) ab, die die Clientanwendung warten soll. |
Bemerkungen
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) |
WindowsServer 2008 |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|