IWSMan：：CreateSession 方法 (wsmandisp.h)

建立 Session 物件，然後可用於後續的網路作業。

語法

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

[in] connection

要連線的通訊協定和服務，包括 IPv4 或 IPv6。連線資訊的格式如下所示： <傳輸><位址><尾碼> 。如需範例，請參閱。如果未提供連線資訊，則會使用本機電腦。

[in] flags

指定驗證方法的會話旗標，例如交涉驗證或摘要式驗證，以連線到遠端電腦。這些旗標也會指定其他會話連線資訊，例如編碼或加密。此參數必須包含遠端 連線__WSManSessionFlags 中的一或多個旗標。如需詳細資訊，請參閱會話常數。本機電腦上的 WinRM 服務連線不需要旗標設定。

如果未指定任何驗證旗標，除非下列其中一個條件成立，否則會使用 Kerberos，在此情況下會使用 Negotiate：

如需詳細資訊，請參閱遠端連線的驗證和 connectionOptions 參數。

[in] connectionOptions

IWSManConnectionOptions物件的指標，其中包含使用者名稱和密碼。預設值是 NULL。

[out] session

新 IWSManSession 物件的指標。

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

下列清單包含用來在建立 HTTPS 會話時指定連接參數 (連線資訊的格式範例，位址> 欄位必須符合伺服器電腦證書名稱， < 否則會發生失敗) ：

"https://service"
使用 HTTPS 連線到預設 Web 服務位置。
"https://service.corp.com/websvcs/wsman"
使用 HTTPS 連線到特定的 Web 服務位置。
「HTTPs://[E3D7：0000：0000：0000：51F4：9BC8：C0A8：6420]」
使用 HTTPS 和 IPv6 搭配預設埠。
「HTTPs://[E3D7：0000：0000：0000：51F4：9BC8：C0A8：6420]：9999/wsman」
使用 HTTPS 和 IPv6 搭配指定的埠。