Метод WSMan. CreateSession

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

Синтаксис

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

Параметры

Подключение к [ в необязательное]

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

Флаги [ в необязательное]

Флаги сеанса, указывающие метод проверки подлинности, например Negotiate или дайджест-аутентификация, для подключения к удаленному компьютеру. Эти флаги также указывают другие сведения о подключении сеанса, такие как кодирование или шифрование. Этот параметр должен содержать один или несколько флагов в _ _ всмансессионфлагс для удаленного подключения. Дополнительные сведения см. в разделе константы сеанса. Для подключения к WinRM на локальном компьютере параметры флага не требуются. Значение по умолчанию — всманфлагусенеготиате.

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

connectionOptions [ в необязательное]

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

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

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

Remarks

Метод CreateSession Инициализирует объект Session , собирая параметры, такие как флаги, учетные данные и строку подключения для параметра соединения . CreateSession на самом деле не подключается к локальному или удаленному компьютеру. Если соединение не может быть установлено, происходит сбой при выполнении первой операции сеанса , такой как Get или reenumerate, после вызова 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-адресу. Сценарий предоставляет имя пользователя и пароль для учетной записи. Флаги всманфлагкредусернамепассворд и всманфлагусебасик объединяются, чтобы указать, что учетная запись является локальной учетной записью на удаленном компьютере. В случае сбоя создания сеанса сценарий завершается. Скрипт использует методы, возвращающие константу, например WSMan. сессионфлагусебасик.

Чтобы выполнить этот сценарий, необходимо настроить параметры конфигурации по умолчанию как для клиента, так и для сервера, чтобы разрешить незашифрованный трафик и обычную проверку подлинности (для алловуненкриптед задано значение true , а для параметра Basic — значение 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 учетная запись является учетной записью домена и используется проверка подлинности Negotiate. При использовании проверки подлинности Negotiate необходимо указать имя пользователя как 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
Заголовок
Всмандисп. h
IDL
Всмандисп. idl
Библиотека
Всмандисп. tlb
DLL
WSMAuto.dll

См. также раздел

Ведущий

ConnectionOptions

Сеанс

Проверка подлинности для удаленных подключений

установка и настройка для служба удаленного управления Windows