IWSMan::CreateSession-Methode (wsmandisp.h)

  • Artikel

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

Syntax

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Parameter

[in] connection

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 unter Hinweise. Wenn keine Verbindungsinformationen angegeben werden, wird der lokale Computer verwendet.

[in] flags

Die Sitzungsflags, die die Authentifizierungsmethode angeben, z. B . Die Aushandlungsauthentifizierung oder die Digestauthentifizierung, um eine Verbindung mit einem Remotecomputer herzustellen. Diese Flags geben auch andere Sitzungsverbindungsinformationen an, z. B. Codierung oder Verschlüsselung. Dieser Parameter muss mindestens ein Flag in __WSManSessionFlags für eine Remoteverbindung enthalten. Weitere Informationen finden Sie unter Sitzungskonstanten. Für eine Verbindung mit dem WinRM-Dienst auf dem lokalen Computer sind keine Flageinstellungen erforderlich.

Wenn keine Authentifizierungsflags angegeben werden, wird Kerberos verwendet, es sei denn, eine der folgenden Bedingungen ist zutrifft. In diesem Fall wird Negotiate verwendet:

  • Explizite Anmeldeinformationen werden angegeben, und der Zielhost ist vertrauenswürdig.
  • der Zielhost ist "localhost", "127.0.0.1" oder "[::1]"
  • Der Clientcomputer befindet sich in einer Arbeitsgruppe, und der Zielhost ist vertrauenswürdig.
Weitere Informationen finden Sie unter Authentifizierung für Remoteverbindungen und unter connectionOptions-Parameter .

[in] connectionOptions

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

[out] session

Ein Zeiger auf ein neues IWSManSession-Objekt .

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die folgende Liste enthält Beispiele für Formate, die zum Angeben von Verbindungsinformationen im Verbindungsparameter verwendet werden (beim Erstellen einer HTTPS-Sitzung muss das < Feld Adresse> mit dem Namen des Servercomputerzertifikats übereinstimmen, andernfalls tritt ein Fehler auf):

  • "https://service"

    Verwendet HTTPS, um eine Verbindung mit dem Standardspeicherort des Webdiensts herzustellen.

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

    Verwendet HTTPS, um eine Verbindung mit dem jeweiligen Webdienststandort 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.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wsmandisp.h
Bibliothek WSManDisp.tlb
DLL WSMAuto.dll

Weitere Informationen

IWSMan

WSMan.CreateSession