Sitzungsobjekt (WSManDisp.h)

Artikel
06/13/2023

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
Eigenschaften

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	WSManDisp.h
IDL	WSManDisp.idl
Bibliothek	WSManDisp.tlb
DLL	WSMAuto.dll

Siehe auch

WinRM-Skript-API
Informationen zur Windows-Remoteverwaltung
Verwenden der Windows-Remoteverwaltung
Skripterstellung in der Windows-Remoteverwaltung
Abrufen von Daten vom lokalen Computer
Abrufen von Daten von einem Remotecomputer

Share via