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之後，第一個會話作業就會發生失敗，例如Get或Enumerate。 此行為與遠端電腦上的命名空間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 位址所識別的遠端電腦上建立會話。 腳本會提供帳戶的使用者名稱和密碼。 旗標 WSManFlagCredUserNamePassword 和 WSManFlagUseBasic 會合並，以指出該帳戶是遠端電腦上的本機帳戶。 如果建立會話失敗，腳本就會終止。 腳本會使用傳回常數的方法，例如 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\username 或 ipaddress\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 遠端系統管理的安裝和設定