IWSMan::CreateSession-Methode (wsmandisp.h)
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.
[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 |