WSMan.CreateSession-Methode

Erstellt ein Session-Objekt , das dann für nachfolgende Netzwerkvorgänge verwendet werden kann.

Syntax

WSMan.CreateSession( _
  [ ByVal connection ], _
  [ ByVal flags ], _
  [ ByVal connectionOptions ] _
)

Parameter

Verbindung [in, optional]

Das Protokoll und der Dienst, mit dem eine Verbindung hergestellt werden soll, einschließlich IPv4 oder IPv6. Das Format der Verbindungsinformationen lautet wie folgt: <TransportAddressSuffix><><>. Beispiele finden Sie unter "Hinweise". Wenn keine Verbindungsinformationen bereitgestellt werden, wird der lokale Computer verwendet.

Flags [in, optional]

Die Sitzungsflaggen, die die Authentifizierungsmethode angeben, z. B. die Authentifizierung oder Die Digestauthentifizierung zum Herstellen einer Verbindung mit einem Remotecomputer. Diese Flags geben auch andere Sitzungsverbindungsinformationen an, z. B. Codierung oder Verschlüsselung. Dieser Parameter muss mindestens eine der Flags in __WSManSessionFlags für eine Remoteverbindung enthalten. Weitere Informationen finden Sie unter Sitzungskonstanten. Es sind keine Flageinstellungen für eine Verbindung mit WinRM auf dem lokalen Computer erforderlich. Der Standardwert ist WSManFlagUseNegotiate.

Weitere Informationen finden Sie unter Authentifizierung für Remoteverbindungen und den Parameter "connectionOptions ".

connectionOptions [in, optional]

Ein Zeiger auf ein ConnectionOptions-Objekt , das einen Benutzernamen und ein Kennwort enthält. Der Standardwert ist NULL.

Rückgabewert

Ein Session-Objekt , das dann verwendet werden kann, um lokale oder Remote-WinRM-Vorgänge auszuführen.

Bemerkungen

Die CreateSession-Methode initialisiert das Session-Objekt , indem Parameter wie Flags, Anmeldeinformationen und eine Verbindungszeichenfolge für den Verbindungsparameter gesammelt werden. CreateSession stellt keine Verbindung mit dem lokalen oder Remotecomputer her. Wenn die Verbindung nicht eingerichtet werden kann, tritt ein Fehler auf dem ersten Sitzungsvorgang auf, z. B. ein Get - oder Enumerate, nach dem Aufruf von CreateSession. Dieses Verhalten unterscheidet sich von einer WMI-Verbindung zu einem Namespace auf einem Remotecomputer. Weitere Informationen finden Sie unter Windows Remoteverwaltung und WMI.

Das folgende VBScript-Codebeispiel wird verwendet, um diese Methode aufzurufen.

Set session = _
    wsman.CreateSession("<Transport><Address><Suffix>")

Die folgenden Beispiele zeigen die verschiedenen Formate an, die zum Angeben von Verbindungsinformationen im Verbindungsparameter verwendet werden (beim Erstellen einer HTTPS-Sitzung muss das>< Adressfeld dem Namen des Servercomputerzertifikats entsprechen, andernfalls tritt ein Fehler auf):

  • "https://service"

    Verwendet HTTPS, um eine Verbindung mit dem Standardwebdienstspeicherort herzustellen.

  • "https://service.corp.com/websvcs/wsman"

    Verwendet HTTPS, um eine Verbindung mit dem bestimmten Webdienstspeicherort herzustellen.

  • "https://[E3D7:0000:0000:000:000:51F4:9BC8:C0A8:6420]"

    Verwendet HTTPS und IPv6 mit dem Standardport.

  • "https://[E3D7:0000:0000:000:51F4:9BC8:C0A8:6420]:9999/wsman"

    Verwendet HTTPS und IPv6 mit dem angegebenen Port.

Beispiele

Im folgenden VBScript-Codebeispiel wird eine Sitzung auf dem lokalen Computer erstellt.

 Set NewSession = Wsman.CreateSession   
   

Im folgenden VBScript-Codebeispiel wird eine Sitzung auf einem Remotecomputer erstellt, der von einer IP-Adresse identifiziert wird. Das Skript stellt einen Benutzernamen und ein Kennwort für ein Konto bereit. Die Flags WSManFlagCredUserNamePassword und WSManFlagUseBasic werden kombiniert, um anzugeben, dass das Konto ein lokales Konto auf dem Remotecomputer ist. Wenn die Erstellung der Sitzung fehlschlägt, wird das Skript beendet. Das Skript verwendet die Methoden, die die Konstante zurückgeben, z. B. WSMan.SessionFlagUseBasic.

Um dieses Skript auszuführen, müssen Sie die Standardkonfigurationseinstellungen für Client und Server konfigurieren, um nicht verschlüsselten Datenverkehr und die Standardauthentifizierung zuzulassen (AllowUnencrypted set to True und Basic set to True). Weitere Informationen finden Sie unter Installation und Konfiguration für Windows Remoteverwaltung.

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Im folgenden VBScript-Codebeispiel ist das Konto ein Domänenkonto und die Verhandlungsauthentifizierung wird verwendet. Mit der Verhandlungsauthentifizierung müssen Sie den Benutzernamen als computername\username oder ipaddress\username.

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Requirements (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

Weitere Informationen

WSMan

Connectionoptions

Sitzung

Authentifizierung für Remoteverbindungen

Installation und Konfiguration für Windows Remoteverwaltung