New-WSManSessionOption
Создает хэш-таблицу параметра сеанса для использования в качестве входных параметров для командлетов WS-Management.
Синтаксис
Default (по умолчанию)
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет New-WSManSessionOption создает хэш-таблицу параметра сеанса WSMan, которую можно передать в командлеты WSMan:
Get-WSManInstanceSet-WSManInstanceInvoke-WSManActionConnect-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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OperationTimeout
Указывает время ожидания (в миллисекундах) для операции WS-Management.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | OperationTimeoutMSec |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ProxyAccessType
Указывает механизм, по которому расположен прокси-сервер. Допустимые значения для этого параметра:
-
ProxyIEConfig. Используйте конфигурацию прокси-сервера Internet Explorer для текущего пользователя. -
ProxyWinHttpConfig. Клиент WSMan использует параметры прокси-сервера, настроенные для WinHTTP, с помощью программы ProxyCfg.exe. -
ProxyAutoDetect— принудительное автоматическое обнаружение прокси-сервера. -
ProxyNoProxyServer. Не используйте прокси-сервер. Устраните все имена узлов локально.
Значением по умолчанию является ProxyIEConfig.
Свойства параметра
| Тип: | ProxyAccessType |
| Default value: | None |
| Допустимые значения: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ProxyAuthentication
Указывает метод проверки подлинности, используемый на прокси-сервере. Допустимые значения для этого параметра:
-
Basic— базовая схема, в которой имя пользователя и пароль отправляются в открытом виде на сервер или прокси-сервер. -
Digest. Дайджест — это схема ответа на вызов, которая использует строку данных, указанную сервером для задачи. -
Negotiate. Согласование — это схема ответа на вызовы, которая согласовывается с сервером или прокси-сервером, чтобы определить, какая схема используется для проверки подлинности. Примерами являются протокол Kerberos и NTLM.
Значение по умолчанию — "Согласование".
Свойства параметра
| Тип: | ProxyAuthentication |
| Default value: | None |
| Допустимые значения: | Negotiate, Basic, Digest |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ProxyCredential
Указывает учетную запись пользователя, которая имеет разрешение на получение доступа через промежуточный веб-прокси.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipCACheck
Указывает, что при подключении по протоколу HTTPS клиент не проверяет, подписан ли сертификат сервера доверенным центром сертификации (ЦС). Используйте этот параметр, только если удаленный компьютер является доверенным другим методом, например, если удаленный компьютер является частью сети, которая физически безопасна и изолирована, или удаленный компьютер указан в качестве доверенного узла в конфигурации WS-Management.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipCNCheck
Указывает, что общее имя сертификата (CN) сервера не обязательно совпадает с именем узла сервера. Это используется только в удаленных операциях с помощью ПРОТОКОЛА HTTPS. Этот параметр следует использовать только для доверенных компьютеров.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipRevocationCheck
Указывает, что подключение не проверяет статус аннулирования на серверном сертификате.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SPNPort
Указывает номер порта, добавляемый к имени субъекта-службы подключения (SPN) удаленного сервера. SPN используется, когда механизм аутентификации — Kerberos или Negotiate.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseUTF16
Указывает, что соединение кодирует запрос в формате UTF16 вместо формата UTF8. По умолчанию используется кодировка UTF8.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
SessionOption
Этот командлет возвращает созданный параметр сеанса WSMan в качестве объекта SessionOption.
