New-CimSession

  • Referencia
Módulo:
CimCmdlets

Crea una sesión CIM.

Syntax

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El New-CimSession cmdlet crea una sesión CIM. Una sesión CIM es un objeto del lado cliente que representa una conexión a un equipo local o a un equipo remoto. La sesión CIM contiene información sobre la conexión, como ComputerName, el protocolo usado o varios identificadores.

Este cmdlet devuelve un objeto de sesión CIM que todos los demás cmdlets CIM pueden usar.

Ejemplos

Ejemplo 1: Creación de una sesión CIM con opciones predeterminadas

En este ejemplo se crea una sesión CIM local con opciones predeterminadas. Si no se especifica ComputerName , New-CimSession crea una sesión DCOM en el equipo local.

New-CimSession

Ejemplo 2: Crear una sesión CIM en un equipo específico

En este ejemplo se crea una sesión CIM en el equipo especificado por ComputerName. De forma predeterminada, New-CimSession crea una sesión de WSMan cuando se especifica ComputerName .

New-CimSession -ComputerName Server01

Ejemplo 3: Creación de una sesión CIM en varios equipos

En este ejemplo se crea una sesión CIM en cada uno de los equipos especificados por ComputerName, en la lista separada por comas.

New-CimSession -ComputerName Server01,Server02,Server03

Ejemplo 4: Crear una sesión CIM con un nombre descriptivo

En este ejemplo se crea una sesión CIM remota en cada uno de los equipos especificados por ComputerName, en la lista separada por comas y se asigna un nombre descriptivo a las nuevas sesiones, especificando Name.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

Puede usar el nombre descriptivo de una sesión CIM para hacer referencia a la sesión en otros cmdlets CIM, por ejemplo, Get-CimSession.

Ejemplo 5: Crear una sesión CIM en un equipo mediante un objeto PSCredential

En este ejemplo se crea una sesión CIM en el equipo especificado por ComputerName, mediante el objeto PSCredential especificado por Credential y el tipo de autenticación especificado por Authentication.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Puede crear un objeto PSCredential mediante el Get-Credential cmdlet .

Ejemplo 6: Creación de una sesión CIM en un equipo mediante un puerto específico

En este ejemplo se crea una sesión CIM en el equipo especificado por ComputerName mediante el puerto TCP especificado por Puerto.

New-CimSession -ComputerName Server01 -Port 1234

Ejemplo 7: Creación de una sesión CIM mediante DCOM

En este ejemplo se crea una sesión CIM mediante el protocolo COM distribuido (DCOM) en lugar de WSMan.

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Parámetros

-Authentication

Especifica el tipo de autenticación usado para las credenciales del usuario. Los valores permitidos para este parámetro son los siguientes:

  • Valor predeterminado
  • Digest
  • Negotiate
  • Basic
  • Kerberos
  • NtlmDomain
  • CredSsp

No puede usar el tipo de autenticación NtlmDomain para la conexión al equipo local. La autenticación CredSSP solo está disponible en Windows Vista, Windows Server 2008 y versiones posteriores de Windows.

Precaución

La autenticación del proveedor de servicios de seguridad de credenciales (CredSSP) está diseñada para comandos que requieren autenticación en más de un recurso, como el acceso a un recurso compartido de red remoto. Este mecanismo el riesgo de seguridad de la operación remota. Si el equipo remoto se ve comprometido, las credenciales que se pasen a él se pueden utilizar para controlar la sesión de red.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateThumbprint

Especifica el certificado de clave pública digital (X.509) de una cuenta de usuario que tiene permiso para realizar esta acción. 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 el proveedor de certificados de PowerShell.

Para obtener más información, consulte about_Certificate_Provider.

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

-ComputerName

Especifica el nombre del equipo al que se va a crear la sesión CIM. Especifique un solo nombre de equipo o varios nombres de equipo separados por una coma.

Si no se especifica ComputerName , se crea una sesión CIM en el equipo local. Puede especificar el valor del nombre del equipo en uno de los siguientes formatos:

  • Uno o varios nombres netBIOS
  • Una o varias direcciones IP
  • Uno o varios nombres de dominio completos.

Si el equipo está en un dominio diferente al del usuario, debe especificar el nombre de dominio completo.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica una cuenta de usuario con permiso para realizar esta acción. Si no se especifica Credential , se usa la cuenta de usuario actual.

Especifique el valor de Credential con uno de los siguientes formatos:

  • Un nombre de usuario: "User01"
  • Un nombre de dominio y un nombre de usuario: "Domain01\User01"
  • Un nombre principal de usuario: "User@Domain.com"
  • Un objeto PSCredential, como uno devuelto por el Get-Credential cmdlet .

Cuando escriba un nombre de usuario, se le solicitará una contraseña.

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

-Name

Especifica un nombre descriptivo para la sesión CIM.

Puede usar el nombre para hacer referencia a la sesión CIM al usar otros cmdlets, como el cmdlet Get-CimSession . El nombre no tiene que ser único en el equipo o en la sesión actual.

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

-OperationTimeoutSec

Duración para la que el cmdlet espera una respuesta del servidor.

De forma predeterminada, el valor de este parámetro es 0, lo que significa que el cmdlet usa el valor de tiempo de espera predeterminado para el servidor.

Si el parámetro OperationTimeoutSec se establece en un valor menor que el tiempo de espera de reintento de conexión sólido de 3 minutos, los errores de red que duran más que el valor del parámetro OperationTimeoutSec no se pueden recuperar, ya que la operación en el servidor agota el tiempo de espera antes de que el cliente pueda volver a conectarse.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

Especifica el puerto de red del equipo remoto que se usa para esta conexión. Para conectarse a un equipo remoto, este debe estar escuchando en el puerto que usa la conexión. Los puertos predeterminados son 5985 (el puerto WinRM para HTTP) y 5986 (el puerto WinRM para HTTPS).

Antes de usar un puerto alternativo, debe configurar el agente de escucha de WinRM en el equipo remoto para poder escuchar en ese puerto. Utilice los siguientes comandos para configurar el agente de escucha:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

No use el parámetro Port a menos que sea necesario. El puerto establecido en el comando se aplica a todos los equipos o sesiones en los que se ejecuta el comando. Una configuración de puerto alternativo podría impedir que el comando se ejecutara en todos los equipos.

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

-SessionOption

Establece opciones avanzadas para la nueva sesión CIM. Escriba el nombre de un objeto CimSessionOption creado mediante el New-CimSessionOption cmdlet .

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

-SkipTestConnection

De forma predeterminada, el New-CimSession cmdlet establece una conexión con un punto de conexión de WS-Management remoto por dos motivos: para comprobar que el servidor remoto está escuchando en el número de puerto especificado mediante el parámetro Port y para comprobar las credenciales de cuenta especificadas. La comprobación se realiza mediante una operación WS-Identity estándar. Puede agregar el parámetro de modificador SkipTest Conectar ion si el punto de conexión de WS-Management remoto no puede usar WS-Identify o para reducir el tiempo de transmisión de datos.

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

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

CimSession

Este cmdlet devuelve un objeto de sesión CIM.

Notas

PowerShell incluye los siguientes alias para New-CimSession:

  • Windows:
    • ncms

Este cmdlet solo está disponible en plataformas Windows.