WSMan-Objekt

Artikel
06/13/2023

Stellt Methoden und Eigenschaften bereit, die zum Erstellen einer Sitzung verwendet werden, die durch ein Session-Objekt dargestellt werden. 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. Vorgänge umfassen das Abrufen, Schreiben, Aufzählen von Daten oder Aufrufen von Methoden.

Member

Das WSMan-Objekt verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Das WSMan-Objekt verfügt über diese Methoden.

Methode	BESCHREIBUNG
CreateConnectionOptions	Erstellt ein ConnectionOptions-Objekt , das den Benutzernamen und das Kennwort angibt, die beim Erstellen einer Remotesitzung verwendet werden.
CreateResourceLocator	Erstellt ein ResourceLocator-Objekt , das Folgendes angeben kann: Der vollständige Pfad zu einer Ressource oder einem einzelnen Datenstück. Ein Selektor für eine bestimmte instance einer Ressource. Eine Option , die zusätzliche Daten für den Ressourcenanbieter bereitstellt.
CreateSession	Erstellt ein Session-Objekt , das dann für nachfolgende Netzwerkvorgänge verwendet werden kann.
WSMan.EnumerationFlagHierarchyDeep	Gibt den Wert des EnumerationsflagflagHierarchyDeep zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.EnumerationFlagHierarchyDeepBasePropsOnly	Gibt den Wert des EnumerationsflagflagHierarchyDeepBasePropsOnly zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.EnumerationFlagHierarchyShallow	Gibt den Wert des EnumerationsflagflagHierarchyShallow zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.EnumerationFlagNonXmlText	Gibt den Wert der Enumerationskonstante WSManFlagNonXmlText zur Verwendung im flags-Parameter der Session.Enumerate-Methode zurück .
WSMan.EnumerationFlagReturnEPR	Gibt den Wert des EnumerationsflagflagReturnEPR zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.EnumerationFlagReturnObject	Gibt den Wert des EnumerationsflagReturnObject zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.EnumerationFlagReturnObjectAndEPR	Gibt den Wert des EnumerationsflagFlagReturnObjectAndEPR zur Verwendung im flags-Parameter von Session.Enumerate zurück.
WSMan.GetErrorMessage	Gibt eine formatierte Zeichenfolge zurück, die den Text einer Fehlernummer enthält.
WSMan.SessionFlagCredUsernamePassword	Gibt den Wert des Authentifizierungsflags WSManFlagCredUsernamePassword zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagEnableSPNServerPort	Gibt den Wert des Authentifizierungsflags WSManFlagEnableSPNServerPort zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagNoEncryption	Gibt den Wert des Authentifizierungsflags WSManFlagNoEncryption zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagSkipCACheck	Gibt den Wert des WSManFlagSkipCACheck-Authentifizierungsflags zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagSkipCNCheck	Gibt den Wert des Authentifizierungsflags WSManFlagSkipCNCheck zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUseBasic	Gibt den Wert des Authentifizierungsflags WSManFlagUseBasic zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUseDigest	Gibt den Wert des Authentifizierungsflags WSManFlagUseDigest zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUseKerberos	Gibt den Wert des Authentifizierungsflags WSManFlagUseKerberos zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUseNegotiate	Gibt den Wert des Authentifizierungsflags WSManFlagUseNegotiate zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUseNoAuthentication	Gibt den Wert des Authentifizierungsflags WSManFlagUseNoAuthentication zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.
WSMan.SessionFlagUTF8	Gibt den Wert des Authentifizierungsflags WSManFlagUTF8 zur Verwendung im flags-Parameter von WSMan.CreateSession zurück.

Eigenschaften

Das WSMan-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
CommandLine	Schreibgeschützt	Ruft die nicht verarbeitete Befehlszeile für den aktuellen Hostingprozess ab.
Fehler	Schreibgeschützt	Ruft Fehlerinformationen ab.

Bemerkungen

Das WSMan-Objekt entspricht den IWSMan - und IWSManEx-Schnittstellen . WSMan ist das einzige Objekt, das direkt mit CreateObject erstellt werden kann.

Beispiele

Das folgende Codebeispiel zeigt, wie ein WSMan-Objekt instanziiert wird.

Dim objWsman
Dim Session, Resource 
Set objWsman = CreateObject( "WSMAN.Automation" )
Set Session = objWsman.CreateSession
strResource = "http://schemas.microsoft.com/wbem/wsman/1/wmi/Root/CIMv2/Win32_OperatingSystem"

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