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

Siehe auch

WinRM-Skripterstellungs-API

Informationen Windows Remoteverwaltung

Verwenden Windows Remoteverwaltung

Skripterstellung in Windows Remoteverwaltung

Abrufen von Daten vom lokalen Computer

Abrufen von Daten von einem Remotecomputer