Метод WSMan.CreateSession

Создает объект сеанса , который затем можно использовать для последующих сетевых операций.

Синтаксис

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

Параметры

connection [in, необязательный]

Протокол и служба для подключения, включая IPv4 или IPv6. Формат сведений о подключении выглядит следующим образом: <Суффикс>транспортного><адреса><. Примеры см. в разделе "Примечания". Если сведения о подключении отсутствуют, используется локальный компьютер.

флаги [in, необязательный]

Флаги сеанса, указывающие метод проверки подлинности, например проверка подлинности "Согласование" или "Дайджест-проверка подлинности", для подключения к удаленному компьютеру. Эти флаги также указывают другие сведения о подключении сеанса, такие как кодировка или шифрование. Этот параметр должен содержать один или несколько флагов в __WSManSessionFlags для удаленного подключения. Дополнительные сведения см. в разделе Константы сеансов. Параметры флага не требуются для подключения к WinRM на локальном компьютере. По умолчанию используется WSManFlagUseNegotiate.

Дополнительные сведения см. в разделе "Проверка подлинности для удаленных подключений " и параметра connectionOptions .

connectionOptions [in, необязательный]

Указатель на объект ConnectionOptions , содержащий имя пользователя и пароль. Значение по умолчанию — NULL.

Возвращаемое значение

Затем объект сеанса , который можно использовать для выполнения локальных или удаленных операций WinRM.

Замечания

Метод CreateSession инициализирует объект Session путем сбора параметров, таких как флаги, учетные данные и строка подключения для параметра подключения . CreateSession фактически не подключается к локальному или удаленному компьютеру. Если подключение не удается установить, при первой операции сеанса возникает сбой, например Get или Enumerate, после вызова CreateSession. Это поведение отличается от подключения WMI к пространству имен на удаленном компьютере. Дополнительные сведения см. в разделе Удалённое управление Windows и WMI.

Следующий пример кода VBScript используется для вызова этого метода.

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

В следующих примерах показаны различные форматы, используемые для указания сведений о подключении в параметре подключения (при создании сеанса < HTTPS поле "Адрес"> должно совпадать с именем сертификата компьютера сервера, в противном случае возникает сбой):

• "https://service"

  Использует ПРОТОКОЛ HTTPS для подключения к расположению веб-службы по умолчанию.

• "https://service.corp.com/websvcs/wsman"

  Использует ПРОТОКОЛ HTTPS для подключения к определенному расположению веб-службы.

• "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 и Basic с значением 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