共用方式為


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:

  • 會提供明確的認證,且目的地主機受信任
  • 目的地主機為 「localhost」、「127.0.0.1」 或 「[::1]」
  • 用戶端電腦位於工作組中,且目的地主機受信任
如需詳細資訊,請參閱 遠端連線的驗證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 搭配指定的埠。

規格需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wsmandisp.h
程式庫 WSManDisp.tlb
Dll WSMAuto.dll

另請參閱

IWSMan

WSMan.CreateSession