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 ] _
)

Die 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: <Transportadresssuffix><><>. Beispiele finden Sie in den Hinweisen. Wenn keine Verbindungsinformationen angegeben werden, wird der lokale Computer verwendet.

Flags [in, optional]

Die Sitzungskennzeichnungen, die die Authentifizierungsmethode angeben, z. B. Aushandlung der Authentifizierung oder 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 ein Kennzeichen in __WSManSessionFlags für eine Remoteverbindung enthalten. Weitere Informationen finden Sie unter Sitzungskonstanten. Für eine Verbindung mit WinRM auf dem lokalen Computer sind keine Kennzeichnungseinstellungen 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 zum Ausführen lokaler oder Remote-WinRM-Vorgänge verwendet werden kann.

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 hergestellt werden kann, tritt nach dem Aufruf von CreateSession ein Fehler auf, z. B. bei einem Get- oder Enumerate-Vorgang.If the connection cannot be established, a failure occurs on the first Session operation, such as a Get or Enumerate, after the call to CreateSession. Dieses Verhalten unterscheidet sich von einer WMI-Verbindung mit 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, die zum Angeben von Verbindungsinformationen im Verbindungsparameter verwendet werden (beim Erstellen einer HTTPS-Sitzung muss das <Adressfeld> mit dem Namen des Servercomputerzertifikats übereinstimmen, 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 jeweiligen Webdienstspeicherort herzustellen.

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

  Verwendet HTTPS und IPv6 mit dem Standardport.

• "https://[E3D7:0000:0000:0000: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 durch eine 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 es sich bei dem Konto um ein lokales Konto auf dem Remotecomputer handelt. 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, beachten Sie, dass Sie die Standardkonfigurationseinstellungen für Client und Server konfigurieren müssen, um unverschlü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 = "<username>"
Options.Password = "<password>"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

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

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\<username>"
Options.Password = "<password>"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Anforderungen

Siehe auch

WSMan

ConnectionOptions

Sitzung

Authentifizierung für Remoteverbindungen

Installation und Konfiguration für die Windows-Remoteverwaltung