WSMan.CreateSession 方法

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

語法

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

參數

connection [in， optional]

要連線的通訊協議和服務，包括 IPv4 或 IPv6。 線上資訊的格式如下： <傳輸><地址><後綴>。 如需範例，請參閱。 如果未提供連線資訊，則會使用本機計算機。

旗標 [in， 選擇性]

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

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

connectionOptions [in， optional]

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

返回值

會話物件，可用來執行本機或遠端 WinRM 作業。

備註

CreateSession 方法會藉由收集連接參數的參數，例如旗標、認證和連接字串，初始化 Session 物件。 CreateSession 實際上不會連線到本機或遠端電腦。 如果無法建立連線，第一個 會話 作業就會發生失敗，例如 Get 或 Enumerate，在呼叫 CreateSession 之後。 此行為與遠端電腦上的命名空間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 = "<username>"
Options.Password = "<password>"
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\<username>"
Options.Password = "<password>"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

需求

另請參閱

WSMan

ConnectionOptions

工作階段

遠端連線的驗證

Windows 遠端管理的安裝和設定