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. 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: | Negotiate |
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