New-WSManSessionOption

  • Referencia
Módulo:
Microsoft.WSMan.Management

Crea una tabla hash de opción de sesión que se usará como parámetros de entrada para cmdlets de WS-Management.

Syntax

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El New-WSManSessionOption cmdlet crea una tabla hash de opciones de sesión WSMan que se puede pasar a cmdlets de WSMan:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Ejemplos

Ejemplo 1: Crear una conexión que use opciones de conexión

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

En este ejemplo se crea una conexión al equipo remoto server01 mediante las opciones de conexión definidas por New-WSManSessionOption.

El primer comando usa New-WSManSessionOption para almacenar un conjunto de opciones de configuración de conexión en la $a variable . En este caso, las opciones de sesión definen un tiempo de espera de conexión 30 segundos (30.000 milisegundos).

El segundo comando usa el parámetro SessionOption para pasar las credenciales almacenadas en la $a variable a Connect-WSMan. A continuación, Connect-WSMan se conecta al equipo remoto server01 mediante las opciones de sesión especificadas.

Connect-WSMan normalmente se usa en el contexto del proveedor WSMan para conectarse a un equipo remoto, en este caso el equipo server01. Sin embargo, puede usar este cmdlet para establecer conexiones con equipos remotos antes de cambiar al proveedor de WSMan. Esas conexiones aparecen en la lista NombreDeEquipo .

Parámetros

-NoEncryption

Indica que la conexión no usa el cifrado para las operaciones remotas a través de HTTP.

De forma predeterminada, el tráfico sin cifrar no está habilitado. Debe estar habilitado en la configuración local.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Especifica el tiempo de espera, en milisegundos, para la operación WS-Management.

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

Especifica el mecanismo por el que se encuentra el servidor proxy. Los valores permitidos para este parámetro son los siguientes:

  • ProxyIEConfig - Usar la configuración del proxy de Internet Explorer para el usuario actual.
  • ProxyWinHttpConfig - El cliente WSMan usa la configuración de proxy configurada para WinHTTP, mediante la utilidad ProxyCfg.exe.
  • ProxyAutoDetect - Forzar la detección automática de un servidor proxy.
  • ProxyNoProxyServer - No use un servidor proxy. Resuelva todos los nombres de host localmente.

El valor predeterminado es 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

Especifica el método de autenticación que se va a usar en el proxy. Los valores permitidos para este parámetro son los siguientes:

  • Basic - Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto no cifrado al servidor o proxy.
  • Digest - Resumen es un esquema de desafío-respuesta que usa una cadena de datos especificada por el servidor para el desafío.
  • Negotiate - Negotiate es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar qué esquema usar para la autenticación. Algunos ejemplos son el protocolo Kerberos y NTLM.

El valor predeterminado es Negotiate.

Type:ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para obtener acceso a través de un proxy web intermedio.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

Especifica que, cuando se conecta a través de HTTPS, el cliente no valida que el certificado de servidor esté firmado por una entidad de certificación (CA) de confianza. Use esta opción solo cuando otro método sea de confianza para el equipo remoto, por ejemplo, si el equipo remoto forma parte de una red que está físicamente segura y aislada o el equipo remoto aparece como un host de confianza en la configuración de WS-Management.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

Especifica que el nombre común (CN) del certificado del servidor no tiene que coincidir con el nombre de host del servidor. Esto solo se usa en operaciones remotas mediante HTTPS. Esta opción solo se debe usar con equipos de confianza.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Indica que la conexión no valida el estado de revocación en el certificado de servidor.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SPNPort

Especifica un número de puerto que se va a anexar al nombre de entidad de seguridad de servicio (SPN) de conexión del servidor remoto. Un SPN se usa cuando el mecanismo de autenticación es Kerberos o Negotiate.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

Indica que la conexión codifica la solicitud en formato UTF16 en lugar del formato UTF8. El valor predeterminado es la codificación UTF8.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Salidas

SessionOption

Este cmdlet devuelve la opción de sesión WSMan creada como un objeto SessionOption .