New-PSSession

Sintaxis

ComputerName (valor predeterminado)

New-PSSession
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-Port <Int32>]
    [-UseSSL]
    [-ConfigurationName <String>]
    [-ApplicationName <String>]
    [-ThrottleLimit <Int32>]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Uri

New-PSSession
    [-ConnectionUri] <Uri[]>
    [-Credential <PSCredential>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [-AllowRedirection]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Session

New-PSSession
    [[-Session] <PSSession[]>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Crear una sesión en el equipo local

PS C:\> $s = New-PSSession

Ejemplo 2: Crear una sesión en un equipo remoto

PS C:\> $Server01 = New-PSSession -ComputerName Server01

Ejemplo 3: Crear sesiones en varios equipos

PS C:\> $s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03

Ejemplo 4: Creación de una sesión con un puerto especificado

PS C:\> New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12

Ejemplo 5: Creación de una sesión basada en una sesión existente

PS C:\> New-PSSession -Session $s -Credential Domain01\User01

Ejemplo 6: Creación de una sesión con un ámbito global en un dominio diferente

PS C:\> $global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01

Ejemplo 7: Crear sesiones para muchos equipos

PS C:\> $rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50

Ejemplo 8: Creación de una sesión mediante un URI

PS C:\> $s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01

Ejemplo 9: Ejecución de un trabajo en segundo plano en un conjunto de sesiones

PS C:\> $s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
PS C:\> Invoke-Command -Session $s -ScriptBlock {Get-Process PowerShell} -AsJob

Ejemplo 10: Creación de una sesión para un equipo mediante su URI

PS C:\> New-PSSession -ConnectionURI https://management.exchangelabs.com/Management

Ejemplo 11: Crear una opción de sesión

PS C:\> $so = New-PSSessionOption -SkipCACheck
PS C:\> New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01

Parámetros

-AllowRedirection

Indica que este cmdlet permite el redireccionamiento de esta conexión a un identificador uniforme de recursos (URI) alternativo.

Cuando utilizas el parámetro ConnectionURI, el destino remoto puede devolver una instrucción para redirigirse a un URI diferente. De forma predeterminada, Windows PowerShell no redirige las conexiones, pero puede usar este parámetro para permitir que redirija la conexión.

También puede limitar el número de veces que se redirige la conexión cambiando el valor de la opción de sesión MaximumConnectionRedirectionCount. Use el parámetro MaximumRedirection del cmdlet New-PSSessionOption o establezca la propiedad MaximumConnectionRedirectionCount de la variable de preferencia $PSSessionOption. El valor predeterminado es 5.

Propiedades de parámetro

Conjuntos de parámetros

-ApplicationName

Especifica el segmento del nombre de aplicación del URI de conexión. Use este parámetro para especificar el nombre de la aplicación cuando no use el parámetro ConnectionURI en el comando .

El valor predeterminado es el valor de la variable de preferencia $PSSessionApplicationName en el equipo local. Si no se define esta variable de preferencia, el valor predeterminado es WSMAN. Este valor es adecuado para la mayoría de los usos. Para obtener más información, consulte about_Preference_Variables.

El servicio WinRM usa el nombre de la aplicación para seleccionar un agente de escucha para atender la solicitud de conexión. El valor de este parámetro debe coincidir con el valor del URLPrefix propiedad de un agente de escucha en el equipo remoto.

Propiedades de parámetro

Conjuntos de parámetros

-Authentication

Especifica el mecanismo que se usa para autenticar las credenciales del usuario. Los valores aceptables para este parámetro son:

• Predeterminado
• Básico
• Credssp
• Resumen
• Kerberos
• Negociar
• NegotiateWithImplicitCredential

El valor predeterminado es Default.

Para obtener más información sobre los valores de este parámetro, vea AuthenticationMechanism Enumeration en MSDN Library.

Precaución: La autenticación del proveedor de compatibilidad con seguridad de credenciales (CredSSP), en la que las credenciales de usuario se pasan a un equipo remoto para autenticarlas, 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 (X509) 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 un certificado, use el comando Get-Item o Get-ChildItem en la unidad Certificado de Windows PowerShell: .

Propiedades de parámetro

Conjuntos de parámetros

-ComputerName

Especifica una matriz de nombres de equipos. Este cmdlet crea una conexión persistente (PSSession) en el equipo especificado. Si escribe varios nombres de equipo, New-PSSession crea varios objetos PSSession , uno para cada equipo. El valor predeterminado es el equipo local.

Escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo de uno o varios equipos remotos. Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.). Cuando el equipo está en un dominio diferente al del usuario, se requiere el nombre de dominio completo. También puede canalizar el nombre de un equipo, entre comillas, a New-PSSession.

Para usar una dirección IP en el valor del parámetro ComputerName, el comando debe incluir el parámetro Credential . Además, el equipo debe configurarse para el transporte HTTPS o la dirección IP del equipo remoto debe incluirse en la lista WinRM TrustedHosts del equipo local. Para obtener instrucciones sobre cómo agregar un nombre de equipo a la lista TrustedHosts, consulte "Cómo agregar un equipo a la lista de hosts de confianza" en about_Remote_Troubleshooting (https://go.microsoft.com/fwlink/?LinkID=135188).

Para incluir el equipo local en el valor del parámetro ComputerName , inicie Windows PowerShell mediante la opción Ejecutar como administrador.

Propiedades de parámetro

Conjuntos de parámetros

-ConfigurationName

Especifica la configuración de sesión que se usa para la nueva PSSession.

Escriba un nombre de configuración o el URI de un recurso completo para configurar una sesión. Si especifica solo el nombre de configuración, se antepone el siguiente URI de esquema: https://schemas.microsoft.com/PowerShell.

La configuración de sesión de una sesión se encuentra en el equipo remoto. Si la configuración de sesión especificada no existe en el equipo remoto, se produce un error en el comando.

El valor predeterminado es el valor de la variable de preferencia $PSSessionConfigurationName en el equipo local. Si no se establece esta variable de preferencia, el valor predeterminado es Microsoft.PowerShell. Para obtener más información, consulte about_Preference_Variables.

Propiedades de parámetro

Conjuntos de parámetros

-ConnectionUri

Especifica un URI que define el punto de conexión de la sesión. El identificador URI debe ser completo. El formato de esta cadena es el siguiente:

<transport>://<ComputerName>:<Port>/<ApplicationName>

El valor predeterminado es el siguiente:

https://localhost:5985/WSMAN

Si no especifica unConnectionURI de , puede usar los parámetros UseSSL, ComputerName, Porty ApplicationName para especificar los valores de ConnectionURI de .

Los valores válidos para el segmento Transporte del URI son HTTP y HTTPS. Si especifica un URI de conexión con un segmento de transporte, pero no especifica un puerto, la sesión se crea con puertos estándar: 80 para HTTP y 443 para HTTPS. Para usar los puertos predeterminados para la comunicación remota de Windows PowerShell, especifique el puerto 5985 para HTTP o 5986 para HTTPS.

Si el equipo de destino redirige la conexión a un URI diferente, Windows PowerShell impide el redireccionamiento a menos que use el parámetro AllowRedirection en el comando.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como Usuario01, Dominio01\Usuario01 o User@Domain.com, o escriba un objeto PSCredential , como uno devuelto por el cmdlet Get-Credential.

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

Propiedades de parámetro

Conjuntos de parámetros

-EnableNetworkAccess

Indica que este cmdlet agrega un token de seguridad interactivo a las sesiones de bucle invertido. El token interactivo permite ejecutar comandos en la sesión de bucle invertido que obtienen datos de otros equipos. Por ejemplo, puede ejecutar un comando en la sesión que copia archivos XML desde un equipo remoto al equipo local.

Una sesión de bucle invertido es un psSession de que se origina y termina en el mismo equipo. Para crear una sesión de bucle invertido, omita el parámetro ComputerName o establezca su valor en punto (.), localhost o el nombre del equipo local.

De forma predeterminada, este cmdlet crea sesiones de bucle invertido mediante un token de red, lo que podría no proporcionar permiso suficiente para autenticarse en equipos remotos.

El parámetro EnableNetworkAccess solo es efectivo en sesiones de bucle invertido. Si usa EnableNetworkAccess al crear una sesión en un equipo remoto, el comando se realiza correctamente, pero se omite el parámetro .

También puede habilitar el acceso remoto en una sesión de bucle invertido mediante el valor CredSSP del parámetro Autenticación , que delega las credenciales de sesión a otros equipos.

Para proteger el equipo contra el acceso malintencionado, las sesiones de bucle invertido desconectadas que tienen tokens interactivos, que son los creados mediante el parámetro EnableNetworkAccess, solo se pueden volver a conectar desde el equipo en el que se creó la sesión. Las sesiones desconectadas que usan la autenticación CredSSP se pueden volver a conectar desde otros equipos. Para obtener más información, consulte Disconnect-PSSession.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Especifica un nombre descriptivo para el de PSSession de.

Puede usar el nombre para hacer referencia a PSSession cuando use otros cmdlets, como Get-PSSession y Enter-PSSession. No es necesario que el nombre sea único para el equipo o la sesión actual.

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, que es el puerto WinRM para HTTP y 5986, que es el puerto winRM para HTTPS.

Antes de usar otro puerto, 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:

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

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

-Session

Especifica una matriz de objetos de PSSession que este cmdlet usa como modelo para el nuevo PSSession. Este parámetro crea nuevos objetos PSSession que tienen las mismas propiedades que los objetos psSession especificados.

Escriba una variable que contenga los objetos PSSession o un comando que cree u obtenga los objetos PSSession , como un comando New-PSSession o Get-PSSession.

El psSession resultante los objetos tienen el mismo nombre de equipo, nombre de aplicación, URI de conexión, puerto, nombre de configuración, límite de limitación y nivel de sockets seguros (SSL) que los originales, pero tienen un nombre para mostrar, un identificador y otro identificador de instancia (GUID).

Propiedades de parámetro

Conjuntos de parámetros

-SessionOption

Especifica opciones avanzadas para la sesión. Escriba un objeto SessionOption, como uno que cree mediante el cmdlet New-PSSessionOption o una tabla hash en la que las claves son nombres de opción de sesión y los valores son valores de opción de sesión.

Los valores predeterminados de las opciones se determinan mediante el valor de la variable de preferencia $PSSessionOption, si se establece. De lo contrario, las opciones establecidas en la configuración de sesión establecen los valores predeterminados.

Los valores de opción de sesión tienen prioridad sobre los valores predeterminados de las sesiones establecidas en la variable de preferencia $PSSessionOption y en la configuración de la sesión. Sin embargo, no tienen prioridad sobre los valores máximos, cuotas o límites establecidos en la configuración de sesión.

Para obtener una descripción de las opciones de sesión que incluye los valores predeterminados, consulte New-PSSessionOption. Para obtener información sobre la variable de preferencia de $PSSessionOption, vea about_Preference_Variables. Para obtener más información sobre las configuraciones de sesión, consulte about_Session_Configurations.

Propiedades de parámetro

Conjuntos de parámetros

-ThrottleLimit

Especifica el número máximo de conexiones simultáneas que se pueden establecer para ejecutar este comando. Si omite este parámetro o especifica un valor de 0 (cero), se usa el valor predeterminado, 32.

El límite solo se aplica al comando actual, no a la sesión o al equipo.

Propiedades de parámetro

Conjuntos de parámetros

-UseSSL

Indica que este cmdlet usa el protocolo SSL para establecer una conexión al equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell transmitido a través de la red. El parámetro UseSSL ofrece una protección adicional que envía los datos a través de una conexión HTTPS en lugar de una conexión HTTP.

Si usa este parámetro, pero SSL no está disponible en el puerto que se usa para el comando, se produce un error en el comando.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

System.String, System.URI, System.Management.Automation.Runspaces.PSSession

Salidas

PSSession

Notas

Vínculos relacionados

• Connect-PSSession
• Disconnect-PSSession
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Invoke-Command
• Receive-PSSession
• Remove-PSSession
• acerca_de_PSSessions
• acerca de Remote