Compartir a través de

New-CimSessionOption

  • Referencia
Módulo:
CimCmdlets

Especifica opciones avanzadas para el cmdlet New-CimSession.

Sintaxis

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
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>]
New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El New-CimSessionOption cmdlet 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 New-CimSession cmdlet 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 New-CimSession cmdlet . New-CimSession a continuación, crea una nueva sesión CIM con el servidor remoto denominado Server01, con 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 referencia cultural que se usa para la sesión CIM. De forma predeterminada, la referencia cultural 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 referencia cultural 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 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
Tipo:CultureInfo
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EncodePortInServicePrincipalName

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Encoding

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

Tipo:PacketEncoding
Valores aceptados:Default, Utf8, Utf16
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.
  • Suplantación: permite que los objetos usen las credenciales del autor de la llamada.
  • Delegado: permite a los objetos permitir que otros objetos usen las credenciales del autor de la llamada.

Si no se especifica Suplantación , el New-CimSession cmdlet usa el valor de Impersonate.

Tipo:ImpersonationType
Valores aceptados:Default, None, Identify, Impersonate, Delegate
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxEnvelopeSizeKB

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

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NoEncryption

Especifica que el cifrado de datos está desactivado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PacketIntegrity

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PacketPrivacy

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Protocol

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

Tipo:ProtocolType
Valores aceptados:Dcom, Default, Wsman
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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, NtlmDomain o CredSsp.

Tipo:PasswordAuthenticationMechanism
Valores aceptados:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyCertificateThumbprint

Especifica el certificado de clave pública digital (x.509) de una cuenta de usuario para la autenticación de proxy. Escriba la huella digital del certificado. Los certificados se usan para 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 Get-Item cmdlets o Get-ChildItem en la unidad Cert: de PowerShell.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyCredential

Especifica las credenciales que se usarán para la autenticación de proxy. Escriba uno de los datos siguientes:

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

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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, Auto o InternetExplorer.

El valor predeterminado de este parámetro es InternetExplorer.

Tipo:ProxyType
Valores aceptados:None, WinHttp, Auto, InternetExplorer
Posición:Named
Valor predeterminado:InternetExplorer
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UICulture

Especifica la referencia cultural 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 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.
Tipo:CultureInfo
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

CimSessionOptions

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

Notas

PowerShell incluye los siguientes alias para New-CimSessionOption:

  • Windows:
    • ncso

Este cmdlet solo está disponible en plataformas Windows.