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

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>]

Описание

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

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

Примеры

Пример 1. Create подключения, использующего параметры подключения

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS 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.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

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

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

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

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

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

Type:ProxyAccessType
Accepted values:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

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

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

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

Type:ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SPNPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

SessionOption