Compartir a través de

New-WSManSessionOption

Módulo:
Microsoft.WSMan.Management Module

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

Sintaxis

Default (Es el valor predeterminado). 

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

Description

El cmdlet New-WSManSessionOption crea una tabla hash de opción de sesión WSMan que se puede pasar a cmdlets 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 variable $a. En este caso, las opciones de sesión establecen un tiempo de espera de conexión de 30 segundos (30 000 milisegundos).

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

Connect-WSMan se usa generalmente en el contexto del proveedor WSMan para conectarse a un equipo remoto, en este caso el equipo server01. Sin embargo, puede usar el cmdlet para establecer conexiones a equipos remotos antes de cambiar al proveedor WSMan. Esas conexiones aparecen en la lista de 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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OperationTimeout

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:OperationTimeoutMSec

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyAccessType

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

  • ProxyIEConfig: use 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.

Propiedades del parámetro

Tipo:ProxyAccessType
Valor predeterminado:None
Valores aceptados:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyAuthentication

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

  • 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: el 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.

Propiedades del parámetro

Tipo:ProxyAuthentication
Valor predeterminado:None
Valores aceptados:Negotiate, Basic, Digest
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyCredential

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

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 debe usarse para equipos de confianza.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipRevocationCheck

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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. Se usa un SPN cuando el mecanismo de autenticación es Kerberos o Negotiate.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

SessionOption

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