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


New-WSManSessionOption

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

Синтаксис

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

Описание

Командлет 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 для передачи учетных данных, хранящихся в переменнойConnect-WSMan$a. Connect-WSMan Затем подключитесь к удаленному компьютеру server01 с помощью указанных параметров сеанса.

Connect-WSMan обычно используется в контексте поставщика WSMan для подключения к удаленному компьютеру в данном случае на компьютере server01. Однако этот командлет можно использовать для установки соединения с удаленными компьютерами перед изменением поставщика 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

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