New-PSSessionOption

New-PSSessionOption [-ApplicationArguments <PSPrimitiveDictionary>] [-CancelTimeOut <int>] [-Culture <CultureInfo>] [-IdleTimeOut <int>] [-MaximumReceivedDataSizePerCommand <int>] [-MaximumReceivedObjectSize <int>] [-MaximumRedirection <int>] [-NoCompression] [-NoEncryption] [-NoMachineProfile] [-OpenTimeOut <int>] [-OperationTimeOut <int>] [-ProxyAccessType {<None> | <IEConfig> | <WinHttpConfig> | <AutoDetect> | <NoProxyServer>}] [-ProxyAuthentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ProxyCredential <PSCredential>] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-UICulture <CultureInfo>] [-UseUTF16] [<CommonParameters>]

C:\PS>New-PSSessionOption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Описание
-----------
Эта команда создает объект параметров сеанса со значениями по умолчанию для всех параметров.

C:\PS>$pso = new-pssessionoption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB

C:\PS> new-pssession -computerName Server01 -SessionOption $pso

Описание
-----------
В этом примере демонстрируется использование объекта параметров сеанса для настройки сеанса.

Первая команда создает новый объект параметров сеанса и сохраняет его значение в переменной $pso.

Вторая команда использует командлет New-PSSession для создания сеанса PSSession на удаленном компьютере Server01. Эта команда использует объект параметров сеанса в значении переменной $pso в качестве значения параметра SessionOption команды.

C:\PS>enter-pssession -computername Server01 -sessionOption (new-pssessionoption -noEncryption -noCompression)

Описание
-----------
Эта команда создает интерактивный сеанс с компьютером Server01 с использованием командлета Enter-PSSession. Значение параметра SessionOption — это команда New-PSSessionOption с параметрами-переключателями NoEncryption и NoCompression.

Команда New-PSSessionOption заключена в круглые скобки, чтобы обеспечить ее выполнение до команды Enter-PSSession.

C:\PS>$a = new-pssessionoption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

C:\PS> $a.UICulture = (get-UICulture)
C:\PS> $a.OpenTimeout = (new-timespan -minutes 4)
C:\PS> $a.MaximumConnectionRedirectionCount = 1

C:\PS> $a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Описание
-----------
В этом примере показано, что объект параметров сеанса можно редактировать. Все свойства доступны для чтения и записи.

Используйте этот метод для создания стандартного объекта сеанса для предприятия, затем создайте его специализированные варианты для определенных целей.

C:\PS>$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Описание
-----------
Эта команда создает привилегированную переменную $PSSessionOption. 

Если в сеансе существует привилегированная переменная $PSSessionOption, она определяет значения по умолчанию для параметров сеансов PSSession, созданных с помощью командлетов New-PSSession, Enter-PSSession и Invoke-Command.

Чтобы переменная $PSSessionOption была доступна для всех сеансов, добавьте ее в свой сеанс Windows PowerShell и в свой профиль Windows PowerShell.

Сведения о переменной $PSSessionOption см. в разделе about_Preference_Variables. Дополнительные сведения о профилях см. в разделе about_Profiles.

C:\PS>$skipCN = new-pssessionoption -SkipCNCheck

C:\PS> new-pssession -computername 171.09.21.207 -UseSSL -credential domain01\user01 -sessionOption $skipCN

Описание
-----------
Этот пример показывает, как использовать объект SessionOption для выполнения всех требований к конфигурации удаленного сеанса.

Первая команда с помощью командлета New-PSSessionOption создает объект параметров сеанса со свойством SkipCNCheck. Команда сохраняет полученный объект сеанса в переменной $skipCN.

Вторая команда использует командлет New-PSSession для создания нового сеанса PSSession на удаленном компьютере. Переменная $skipCN используется в значении параметра SessionOption. 

Так как компьютер определяется по его IP-адресу, значение параметра ComputerName не соответствует ни одному из обычных имен в сертификате, используемом для SSL. В результате требуется параметр SkipCNCheck.