New-CimSession

Sintaxis

CredentialParameterSet (valor predeterminado)

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

CertificateParameterSet

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

Description

Ejemplos

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

New-CimSession

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

New-CimSession -ComputerName Server01

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

New-CimSession -ComputerName Server01,Server02,Server03

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

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

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

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

New-CimSession -ComputerName Server01 -Port 1234

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

$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 aceptables para este parámetro son:

• Predeterminado
• Resumen
• Negociar
• Básico
• 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), en la que las credenciales del usuario se pasan a un equipo remoto para autenticarse, 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 aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto está en peligro, se pueden usar las credenciales que se pasan a ella para controlar la sesión de red.

Propiedades de parámetro

Conjuntos de parámetros

-CertificateThumbprint

Especifica el certificado de clave pública digital (X.509) de una cuenta de usuario que tiene permiso para realizar esta acción. 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; no funcionan con cuentas de dominio.

Para obtener una huella digital de certificado, use los cmdlets Get-Item o Get-ChildItem en el proveedor de certificados de PowerShell. Para obtener más información sobre el uso del proveedor de certificados de PowerShell, escriba Get-Help Certificateo vea proveedor de certificados.

Propiedades de parámetro

Conjuntos de parámetros

-ComputerName

Especifica el nombre del equipo en el 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 plenamente calificados.

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

También puede pasar un nombre de equipo (entre comillas) a New-CimSession mediante la canalización.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

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

Especifique el valor de Credencial mediante 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 cmdlet Get-Credential.

Al escribir un nombre de usuario, se le pedirá una contraseña.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Especifica un nombre amigable 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. No es necesario que el nombre sea único para el equipo o la sesión actual.

Propiedades de parámetro

Conjuntos de parámetros

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

Propiedades de parámetro

Conjuntos de parámetros

-Port

Especifica el puerto de red en el 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 winRM en el equipo remoto para que escuche en ese puerto. Use 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. La configuración de puerto del comando se aplica a todos los equipos o sesiones en los que se ejecuta el comando. Una configuración de puerto alternativa podría impedir que el comando se ejecute en todos los equipos.

Propiedades de parámetro

Conjuntos de parámetros

-SessionOption

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

Propiedades de parámetro

Conjuntos de parámetros

-SkipTestConnection

De forma predeterminada, el cmdlet New-CimSession 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 conmutador SkipTestConnection si el punto de conexión remoto WS-Management no puede usar WS-Identify o si desea reducir algún tiempo de transmisión de datos.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

CimSession

Vínculos relacionados

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Remove-CimSession
• New-CimSessionOption
• Acerca de CimSession