Compartir a través de

New-CimSessionOption

Módulo:
CimCmdlets Module

Especifica opciones avanzadas para el cmdlet New-CimSession.

Sintaxis

ProtocolTypeSet (valor predeterminado) 

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet 

New-CimSessionOption
    [-NoEncryption]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-EncodePortInServicePrincipalName]
    [-Encoding <PacketEncoding>]
    [-HttpPrefix <Uri>]
    [-MaxEnvelopeSizeKB <UInt32>]
    [-ProxyAuthentication <PasswordAuthenticationMechanism>]
    [-ProxyCertificateThumbprint <String>]
    [-ProxyCredential <PSCredential>]
    [-ProxyType <ProxyType>]
    [-UseSsl]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

DcomParameterSet 

New-CimSessionOption
    [-Impersonation <ImpersonationType>]
    [-PacketIntegrity]
    [-PacketPrivacy]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet New-CimSessionOption crea una instancia de un objeto de opciones de sesión CIM. Use un objeto de opciones de sesión CIM como entrada para el cmdlet New-CimSession para especificar las opciones de una sesión CIM.

Este cmdlet tiene dos conjuntos de parámetros, uno para las opciones de WsMan y otro para las opciones del modelo de objetos de componente distribuido (DCOM). En función de los parámetros que use, el cmdlet devuelve una instancia de las opciones de sesión DCOM o devuelve las opciones de sesión de WsMan.

Ejemplos

Ejemplo 1: Crear un objeto de opciones de sesión CIM para DCOM

En este ejemplo se crea un objeto de opciones de sesión CIM para el protocolo DCOM y se almacena en una variable denominada $so. A continuación, el contenido de la variable se pasa al cmdlet New-CimSession. New-CimSession, a continuación, crea una nueva sesión CIM con el servidor remoto denominado Server01, utilizando las opciones definidas en la variable.

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

Ejemplo 2: Crear un objeto de opciones de sesión CIM para WsMan

En este ejemplo se crea un objeto de opciones de sesión CIM para el protocolo WsMan. El objeto contiene la configuración del modo de autenticación de kerberos especificado por el parámetro ProxyAuthentication, las credenciales especificadas por el parámetro ProxyCredential y especifica que el comando es omitir la comprobación de CA, omitir la comprobación de CN y usar SSL.

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Ejemplo 3: Crear un objeto de opciones de sesión CIM con la referencia cultural especificada

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

En este ejemplo se especifica la cultura que se usa para la sesión CIM. De forma predeterminada, la cultura del cliente se usa al realizar operaciones. Sin embargo, la referencia cultural predeterminada se puede invalidar mediante el parámetro Culture.

Parámetros

-Culture

Especifica la cultura de la interfaz de usuario que se va a usar para la sesión CIM. Especifique el valor de este parámetro mediante uno de los siguientes formatos:

  • Nombre de idioma en formato <languagecode2>-<country/regioncode2>, como "EN-US".
  • Variable que contiene un objeto de CultureInfo.
  • Comando que obtiene un objeto CultureInfo, como Get-Culture

Propiedades de parámetro

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

Conjuntos de parámetros

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

-EncodePortInServicePrincipalName

Indica que la conexión Kerberos se conecta a un servicio que incluye en su nombre de entidad de servicio (SPN) el número de puerto de servicio. Este tipo de conexión no es común.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Encoding

Especifica la codificación utilizada para el protocolo WsMan. Los valores aceptables para este parámetro son: predeterminado , Utf8 o Utf16.

Propiedades de parámetro

Tipo:PacketEncoding
Valor predeterminado:None
Valores aceptados:Default, Utf8, Utf16
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-HttpPrefix

Especifica la parte de la dirección URL HTTP después del nombre del equipo y el número de puerto. Cambiar esto no es habitual. De forma predeterminada, el valor de este parámetro es /wsman.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Impersonation

Crea una sesión DCOM en Instrumental de administración de Windows (WMI) mediante la suplantación.

Los valores válidos para este parámetro son:

  • Valor predeterminado: DCOM puede elegir el nivel de suplantación mediante su algoritmo de negociación de seguridad normal.
  • Ninguno: el cliente es anónimo para el servidor. El proceso de servidor puede suplantar al cliente, pero el token de suplantación no contiene ninguna información y no se puede usar.
  • Identificar: permite a los objetos consultar las credenciales del autor de la llamada.
  • Suplantar: permite que los objetos usen las credenciales de la persona que llama.
  • Delegado: permite a los objetos permitir que otros objetos usen las credenciales del autor de la llamada.

Si no se especifica Impersonation, el cmdlet New-CimSession usa el valor de Impersonate.

Propiedades de parámetro

Tipo:ImpersonationType
Valor predeterminado:None
Valores aceptados:Default, None, Identify, Impersonate, Delegate
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DcomParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaxEnvelopeSizeKB

Especifica el límite de tamaño de los mensajes XML de WsMan para cualquier dirección.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NoEncryption

Especifica que el cifrado de datos está desactivado.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PacketIntegrity

Especifica que la sesión DCOM creada para WMI usa la funcionalidad Modelo de Objetos Componentes (COM) PacketIntegrity. De forma predeterminada, todas las sesiones CIM creadas con DCOM tienen el parámetro PacketIntegrity establecido en True.

Propiedades de parámetro

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

Conjuntos de parámetros

DcomParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PacketPrivacy

Crea una sesión DCOM en WMI usando el COM PacketPrivacy. De forma predeterminada, todas las sesiones CIM creadas con DCOM tienen el parámetro PacketPrivacy establecido en true.

Propiedades de parámetro

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

Conjuntos de parámetros

DcomParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Protocol

Especifica el protocolo que se va a usar. Los valores aceptables para este parámetro son: DCOM , defaulto Wsman.

Propiedades de parámetro

Tipo:ProtocolType
Valor predeterminado:None
Valores aceptados:Dcom, Default, Wsman
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ProtocolTypeSet
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyAuthentication

Especifica el método de autenticación que se va a usar para la resolución de proxy. Los valores aceptables para este parámetro son: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomaino CredSsp.

Propiedades de parámetro

Tipo:PasswordAuthenticationMechanism
Valor predeterminado:None
Valores aceptados:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyCertificateThumbprint

Especifica el certificado de clave pública digital (x.509) de una cuenta de usuario para la autenticación de proxy. Ingrese la huella digital del certificado. Los certificados se usan en la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales y no funcionan con cuentas de dominio.

Para obtener una huella digital de certificado, use los cmdlets Get-Item o Get-ChildItem en la unidad Cert: de PowerShell.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyCredential

Especifica las credenciales que se van a usar para la autenticación de proxy. Escriba una de las siguientes opciones:

  • Variable que contiene un objeto PSCredential.
  • Comando que obtiene un objeto PSCredential, como Get-Credential

Si esta opción no está establecida, no puede especificar ninguna credencial.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyType

Especifica el mecanismo de resolución de nombres de host que se va a usar. Los valores aceptables para este parámetro son: None, WinHttp, Autoo InternetExplorer.

El valor predeterminado de este parámetro es internetExplorer.

Propiedades de parámetro

Tipo:ProxyType
Valor predeterminado:InternetExplorer
Valores aceptados:None, WinHttp, Auto, InternetExplorer
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SkipCACheck

Indica que al conectarse 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 este parámetro solo cuando el equipo remoto sea de confianza mediante otro mecanismo, como cuando el equipo remoto forma parte de una red que está físicamente segura y aislada, o cuando el equipo remoto aparece como un host de confianza en una configuración de WinRM.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SkipCNCheck

Indica que el nombre común (CN) del certificado del servidor no necesita coincidir con el nombre de host del servidor. Use este parámetro solo para las operaciones remotas con equipos de confianza que usen el protocolo HTTPS.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SkipRevocationCheck

Indica que se omite la comprobación de revocación de los certificados de servidor. Use este parámetro solo para equipos de confianza.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UICulture

Especifica la cultura de la interfaz de usuario que se va a usar para la sesión CIM. Especifique el valor de este parámetro mediante uno de los siguientes formatos:

  • Nombre de idioma en formato <languagecode2>-<country/regioncode2>, como "EN-US".
  • Variable que contiene un objeto CultureInfo.
  • Comando que obtiene un objeto CultureInfo, como Get-Culture.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-UseSsl

Indica que se debe usar SSL para establecer una conexión al equipo remoto. De forma predeterminada, no se usa SSL. WsMan cifra todo el contenido que se transmite a través de la red, incluso cuando se usa HTTP.

Este parámetro le permite especificar la protección adicional de HTTPS en lugar de HTTP. Si SSL no está disponible en el puerto usado para la conexión y especifica este parámetro, se produce un error en el comando.

Se recomienda usar este parámetro solo cuando no se especifica el parámetro PacketPrivacy.

Propiedades de parámetro

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

Conjuntos de parámetros

WSManParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
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.

Entradas

None

Este cmdlet no acepta objetos de entrada.

Salidas

CIMSessionOption

Este cmdlet devuelve un objeto que contiene información de opciones de sesión CIM.