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

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

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

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

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

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