共用方式為


WSMan.CreateSession 方法

建立可供後續網路作業使用的 Session 物件。

語法

WSMan.CreateSession( _
  [ ByVal connection ], _
  [ ByVal flags ], _
  [ ByVal connectionOptions ] _
)

參數

連線 [in, 選擇性]

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

旗標 [in, 選擇性]

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

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

connectionOptions [in, optional]

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

傳回值

接著可用來執行本機或遠端 WinRM 作業的 Session 物件。

備註

CreateSession方法會藉由收集參數來初始化Session物件,例如旗標、認證,以及連接參數的連接字串。 CreateSession 實際上不會連線到本機或遠端電腦。 如果無法建立連線,在呼叫CreateSession之後,第一個會話作業就會發生失敗,例如GetEnumerate。 此行為與遠端電腦上的命名空間WMI連線不同。 如需詳細資訊,請參閱 Windows 遠端系統管理和 WMI

下列 VBScript 程式碼範例是用來呼叫這個方法。

Set session = _
    wsman.CreateSession("<Transport><Address><Suffix>")

下列範例顯示建立 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 搭配指定的埠。

範例

下列 VBScript 程式碼範例會在本機電腦上建立會話。

 Set NewSession = Wsman.CreateSession   
   

下列 VBScript 程式碼範例會在 IP 位址所識別的遠端電腦上建立會話。 腳本會提供帳戶的使用者名稱和密碼。 旗標 WSManFlagCredUserNamePasswordWSManFlagUseBasic 會合並,以指出該帳戶是遠端電腦上的本機帳戶。 如果建立會話失敗,腳本就會終止。 腳本會使用傳回常數的方法,例如 WSMan.SessionFlagUseBasic

若要執行此腳本,請注意,您必須設定用戶端和伺服器的預設組態設定,以允許未加密的流量和基本驗證, (AllowUnencrypted 設定為 True ,並將 [基本] 設定為 True) 。 如需詳細資訊,請參閱 Windows 遠端系統管理的安裝和設定。

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

在下列 VBScript 程式碼範例中,帳戶是網域帳戶,並使用交涉驗證。 使用交涉驗證時,您必須將使用者名稱指定為 computername\usernameipaddress\username

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
標頭
WSManDisp.h
Idl
WSManDisp.idl
程式庫
WSManDisp.tlb
DLL
WSMAuto.dll

另請參閱

WSMan

ConnectionOptions

工作階段

遠端連線的驗證

Windows 遠端系統管理的安裝和設定