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 |
| 標頭 |
|
| Idl |
|
| 程式庫 |
|
| DLL |
|