New-CimSessionOption

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

Ejemplos

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

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

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

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

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:

Escriba un nombre de referencia cultural en <languagecode2>-<country/regioncode2> formato como "EN-US".

Variable que contiene un objeto CultureInfo.

Comando que obtiene un objeto CultureInfo, como Get-Culture

Propiedades de parámetro

Conjuntos de parámetros

-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

Conjuntos de parámetros

-Encoding

Especifica la codificación utilizada para el protocolo WsMan.

Los valores aceptables para este parámetro son: Default, Utf8 o Utf16.

Propiedades de parámetro

Conjuntos de parámetros

-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

Conjuntos de parámetros

-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 suplantación, el cmdlet New-CimSession usa el valor de 3: Suplantar

Propiedades de parámetro

Conjuntos de parámetros

-MaxEnvelopeSizeKB

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

Propiedades de parámetro

Conjuntos de parámetros

-NoEncryption

Especifica que el cifrado de datos está desactivado.

Propiedades de parámetro

Conjuntos de parámetros

-PacketIntegrity

Especifica que la sesión DCOM creada en WMI usa la funcionalidad PacketIntegrity del modelo de objetos componentes (COM). Para mejorar la seguridad, de forma predeterminada todas las sesiones CIM creadas mediante DCOM tienen el parámetro PacketIntegrity establecido en True.

Propiedades de parámetro

Conjuntos de parámetros

-PacketPrivacy

Crea una sesión DCOM en WMI mediante PacketPrivacy COM. Para mejorar la seguridad, de forma predeterminada, todas las sesiones CIM creadas mediante DCOM tienen el parámetro PacketPrivacy establecido en true.

Propiedades de parámetro

Conjuntos de parámetros

-Protocol

Especifica el protocolo que se va a usar.

Los valores aceptables para este parámetro son: DCOM o WinRM.

Propiedades de parámetro

Conjuntos de parámetros

-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, NtlmDomain o CredSsp.

Propiedades de parámetro

Conjuntos de parámetros

-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

Conjuntos de parámetros

-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

Conjuntos de parámetros

-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, Auto o InternetExplorer.

De forma predeterminada, el valor de este parámetro es InternetExplorer.

Propiedades de parámetro

Conjuntos de parámetros

-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

Conjuntos de parámetros

-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 que usan el protocolo HTTPS.

Nota: use este parámetro solo para equipos de confianza.

Propiedades de parámetro

Conjuntos de parámetros

-SkipRevocationCheck

Indica que se omite la comprobación de revocación de los certificados de servidor.

Nota: use este parámetro solo para equipos de confianza.

Propiedades de parámetro

Conjuntos de parámetros

-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:

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

Propiedades de parámetro

Conjuntos de parámetros

-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. 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

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

CIMSessionOption

Vínculos relacionados

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession