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

Descripción
-----------
Este comando crea un objeto de opciones de sesión con todos los valores predeterminados.

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

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

Descripción
-----------
En este ejemplo se muestra cómo utilizar un objeto de opciones de sesión para configurar una sesión.

El primer comando crea un nuevo objeto de opciones de sesión y lo guarda en el valor de la variable $pso.

El segundo comando utiliza el cmdlet New-PSSession para crear una PSSession en el equipo remoto Server01. El comando utiliza el objeto de opciones de sesión contenido en el valor de la variable $pso como valor del parámetro SessionOption del comando.

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

Descripción
-----------
Este primer comando utiliza el cmdlet Enter-PSSession para iniciar una sesión interactiva con el equipo Server01. El valor del parámetro SessionOption es un comando New-PSSessionOption con los parámetros de modificador NoEncryption y NoCompression.

El comando New-PSSessionOption se coloca entre paréntesis para asegurarse de que se ejecuta antes que el comando 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

Descripción
-----------
En este ejemplo se demuestra que es posible modificar el objeto de opciones de sesión. Todas las propiedades tienen valores de lectura y escritura.

Este método se utiliza para crear un objeto de sesión estándar para la empresa y, a continuación, crear versiones personalizadas de él para usos específicos.

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

Descripción
-----------
Este comando crea una variable de preferencia $PSSessionOption. 

Cuando la variable de preferencia $PSSessionOption existe en la sesión, establece los valores predeterminados de las opciones de las PSSessions creadas mediante los cmdlets New-PSSession, Enter-PSSession e Invoke-Command.

Para que la variable $PSSessionOption esté disponible en todas las sesiones, debe agregarse a la sesión de Windows PowerShell y al perfil de Windows PowerShell del usuario.

Para obtener más información acerca de la variable $PSSessionOption, vea about_Preference_Variables. Para obtener más información sobre perfiles, vea about_Profiles.

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

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

Descripción
-----------
En este ejemplo se muestra cómo utilizar un objeto SessionOption para cumplir los requisitos de una configuración de sesión remota.

El primer comando utiliza el cmdlet New-PSSessionOption para crear un objeto de opciones de sesión con la propiedad SkipCNCheck. El comando guarda el objeto de sesión resultante en la variable $skipCN.

El segundo comando utiliza el cmdlet New-PSSession para crear una PSSession nueva en un equipo remoto. La variable de comprobación $skipCN se utiliza en el valor del parámetro SessionOption. 

Dado que el equipo se identifica mediante su dirección IP, el valor del parámetro ComputerName no coincide con ninguno de los nombres comunes del certificado utilizado para el protocolo Capa de sockets seguros (SSL). En consecuencia, se requiere la opción SkipCNCheck.