Поиск по сайту:

New-WSManSessionOption (Microsoft.WSMan.Management)

Нью-WSManSessionOption

Модуль:
Microsoft.WSMan.Management

Создает хеш-таблицу параметров сеанса для использования в качестве входных параметров для командлетов WS-Management.

Синтаксис

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Описание

Этот командлет доступен только на платформе Windows.

Командлет New-WSManSessionOption создает хеш-таблицу параметров сеанса WSMan, которую можно передать командлетам WSMan:

    Get-WSManInstance
    Set-WSManInstance
    Invoke-WSManAction
    Connect-WSMan

Примеры

Пример 1. Создайте соединение, использующее параметры соединения.

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

В этом примере создается подключение к удаленному компьютеру server01 с использованием параметров подключения, определенных New-WSManSessionOption.

Первая команда использует New-WSManSessionOption для хранения набора параметров настройки соединения в переменной $a. В этом случае в параметрах сеанса установлено время соединения 30 секунд (30 000 миллисекунд).

Вторая команда использует параметр SessionOption для передачи учетных данных, хранящихся в переменной $a, в Connect-WSMan. Затем Connect-WSMan подключается к удаленному компьютеру server01, используя указанные параметры сеанса.

Connect-WSMan обычно используется в контексте поставщика WSMan для подключения к удаленному компьютеру, в данном случае к компьютеру server01. Однако вы можете использовать этот командлет для установки подключений к удаленным компьютерам до перехода на поставщика WSMan. Эти подключения появятся в списке ComputerName.

Параметры

-NoEncryption

Указывает, что соединение не использует шифрование для удаленных операций через HTTP.

По умолчанию незашифрованный трафик не включен. Его необходимо включить в локальной конфигурации.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-OperationTimeout

Указывает время ожидания в миллисекундах для операции WS-Management.

Тип :

Int32

Псевдонимы:

OperationTimeoutMSec

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ProxyAccessType

Указывает механизм обнаружения прокси-сервера. Допустимые значения этого параметра:

  • ProxyIEConfig — использовать конфигурацию прокси-сервера Internet Explorer для текущего пользователя.
  • ProxyWinHttpConfig — клиент WSMan использует настройки прокси-сервера, настроенные для WinHTTP, с помощью служебной программы ProxyCfg.exe.
  • ProxyAutoDetect — принудительное автоматическое обнаружение прокси-сервера.
  • ProxyNoProxyServer — не использовать прокси-сервер. Разрешите все имена хостов локально.

Значение по умолчанию — ProxyIEConfig.

Тип :

Проксиаксесстипе

Принятые значения:

ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ProxyAuthentication

Указывает метод аутентификации, который будет использоваться на прокси-сервере. Допустимые значения этого параметра:

  • Basic — Basic — это схема, в которой имя пользователя и пароль отправляются на сервер или прокси в виде открытого текста.
  • Дайджест. Дайджест — это схема запроса-ответа, в которой для запроса используется строка данных, указанная сервером.
  • Negotiate — Negotiate — это схема запроса-ответа, которая согласовывает с сервером или прокси-сервером, чтобы определить, какую схему использовать для аутентификации. Примерами являются протокол Kerberos и NTLM.

Значение по умолчанию — «Переговоры».

Тип :

ProxyAuthentication

Принятые значения:

Переговоры, Базовый, Дайджест

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ProxyCredential

Указывает учетную запись пользователя, имеющую разрешение на доступ через промежуточный веб-прокси.

Тип :

PSCredential

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SkipCACheck

Указывает, что при подключении через HTTPS клиент не проверяет, подписан ли сертификат сервера доверенным центром сертификации (CA). Используйте этот параметр только в том случае, если удаленному компьютеру доверяют другим методом, например, если удаленный компьютер является частью физически безопасной и изолированной сети или если удаленный компьютер указан как доверенный хост в конфигурации WS-Management.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SkipCNCheck

Указывает, что общее имя сертификата (CN) сервера не обязательно должно совпадать с именем узла сервера. Это используется только в удаленных операциях с использованием HTTPS. Эту опцию следует использовать только для доверенных компьютеров.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SkipRevocationCheck

Указывает, что соединение не проверяет статус отзыва сертификата сервера.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SPNPort

Указывает номер порта, который будет добавлен к имени участника-службы подключения (SPN) удаленного сервера. Имя участника-службы используется, когда механизмом аутентификации является Kerberos или Negotiate.

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ИспользоватьUTF16

Указывает, что соединение кодирует запрос в формате UTF16 вместо формата UTF8. По умолчанию используется кодировка UTF8.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Выходы

Опция сеанса

Этот командлет возвращает созданный параметр сеанса WSMan в виде объекта SessionOption.