Поделиться через

New-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 для подключения к удаленному компьютеру, в данном случае — на сервере01. Однако командлет можно использовать для установления подключений к удаленным компьютерам перед переходом на поставщик WSMan. Эти подключения отображаются в списке ComputerName.

Параметры

-NoEncryption

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

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OperationTimeout

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

Тип:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProxyAccessType

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

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

Значением по умолчанию является ProxyIEConfig.

Тип:ProxyAccessType
Допустимые значения:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProxyAuthentication

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

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

Значение по умолчанию — "Согласование".

Тип:ProxyAuthentication
Допустимые значения:Negotiate, Basic, Digest
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProxyCredential

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

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipCACheck

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipCNCheck

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipRevocationCheck

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SPNPort

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UseUTF16

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Выходные данные

SessionOption