New-PSSession

Permite la redirección de esta conexión a un identificador uniforme de recursos (URI) alternativo.

Cuando se utiliza el parámetro ConnectionURI, el destino remoto puede devolver una instrucción de redirección a otro URI. De forma predeterminada, Windows PowerShell no redirige conexiones, pero se puede usar el parámetro AllowRedirection para permitir que se redirija la conexión.

Puede limitar igualmente el uso de veces que se redirige la conexión estableciendo la propiedad MaximumConnectionRedirectionCount de la variable de preferencia $PSSessionOption o la propiedad MaximumConnectionRedirectionCount del valor del parámetro SessionOption.

El valor predeterminado es 5. Para obtener más información, vea la descripción del parámetro SessionOption y vea New-PSSessionOption.

Especifica el segmento del nombre de aplicación del identificador URI de la conexión. Utilice este parámetro para especificar el nombre de aplicación cuando no está utilizando el parámetro ConnectionURI del 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 resulta apropiado en la mayoría de los casos. Para obtener más información, vea about_Preference_Variables.

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

Especifica el mecanismo que se utiliza para autenticar las credenciales del usuario. Los valores válidos son "Default", "Basic", "Credssp", "Digest", "Kerberos", "Negotiate" y "NegotiateWithImplicitCredential". El valor predeterminado es "Default".

La autenticación CredSSP está disponible solo en Windows Vista, Windows Server 2008 y versiones posteriores de Windows.

Para obtener más información sobre los valores de este parámetro, vea la descripción de la enumeración System.Management.Automation.Runspaces.AuthenticationMechanism en MSDN (Microsoft Developer Network) Library, en https://go.microsoft.com/fwlink/?LinkID=144382.

Precaución: la autenticación Credential Security Service Provider (CredSSP), en la que las credenciales del usuario pasan a un equipo remoto para su autenticación, está diseñada para los comandos que requieren autenticación en más de un recurso, como acceso a un recurso compartido de red remota. Este mecanismo aumenta el riesgo que supone la operación remota para la seguridad. Si el equipo remoto está en peligro, las credenciales que se le pasen podrán usarse para controlar la sesión de red.

Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Escriba la huella digital del certificado.

Los certificados se usan en una autenticación basada en certificados del cliente. Pueden asignarse únicamente a cuentas de usuario locales; no funcionan con cuentas de dominio.

Para obtener la huella digital de un certificado, se usa el comando Get-Item o Get-ChildItem en la unidad Cert: de Windows PowerShell.

Crea una conexión persistente (PSSession) con el equipo especificado. Si escribe varios nombres de equipo, New-PSSession creará varias PSSessions, una para cada equipo. El valor predeterminado es el equipo local.

Se debe escribir el nombre NetBIOS, la dirección IP o el nombre de dominio completo de uno o varios equipos remotos. Para especificar el equipo local, escriba el nombre del equipo, "localhost", o bien, un punto (.). Cuando el equipo está en un dominio que no es el del usuario, se requiere el nombre de dominio completo. También se puede canalizar un nombre de 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. Se debe configurar igualmente el equipo para el transporte HTTPS o la dirección IP del equipo remoto debe estar incluida en la lista TrustedHosts de WinRM del equipo local. Para obtener instrucciones a fin de agregar un nombre de equipo a la lista TrustedHosts, vea el tema sobre cómo agregar un equipo a la lista de hosts de confianza en about_Remote_Troubleshooting.

Nota: en Windows Vista y versiones posteriores de Windows, para incluir el equipo local en el valor del parámetro ComputerName, se debe iniciar Windows PowerShell con la opción "Ejecutar como administrador".

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

Escriba un nombre de configuración o el identificador uniforme de recursos (URI) de recurso completo para una configuración de sesión. Si se especifica únicamente el nombre de configuración, se antepone el siguiente identificador URI de esquema: https://schemas.microsoft.com/powershell.

La configuració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, el comando generará un error.

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

Especifica un identificador uniforme de recursos (URI) que define el extremo de la conexión. El identificador URI debe ser completo.

El formato de esta cadena es:

<Transporte>://<nombreDeEquipo>:<Puerto>/<nombreDeAplicación>

El valor predeterminado es.

http://localhost:80/WSMAN

Los valores válidos para el segmento Transport del URI son HTTP y HTTPS. Si no se especifica un ConnectionURI, se pueden utilizar los parámetros UseSSL, ComputerName, Port y ApplicationName para especificar los valores URI.

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

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

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

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

Especifica un nombre simple para la PSSession.

Se puede utilizar el nombre para hacer referencia a la PSSession cuando se utilicen otros cmdlets, como Get-PSSession y Enter-PSSession. No se requiere que el nombre sea único en el equipo o la sesión actual.

Especifica el puerto de red del equipo remoto que se utiliza para este comando. El valor predeterminado es el puerto 80 (puerto HTTP).

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

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

2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port=&quot;&lt;númeroDePuerto&gt;&quot;}

El parámetro Port no se debe usar a menos que sea imprescindible. La configuración del puerto del comando se aplica a todos los equipos y sesiones en que el comando se ejecuta. La configuración de un puerto alternativo puede impedir la ejecución del comando en todos los equipos.

Utiliza la PSSession especificada como modelo para la nueva PSSession. Este parámetro crea nuevas PSSessions con las mismas propiedades que las PSSessions especificadas.

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

Las PSSessions resultantes tienen los mismos nombre de equipo, nombre de aplicación, URI de conexión, puerto, nombre de configuración, límite y valor de Capa de sockets seguros (SSL) que las originales, pero diferentes nombre simple, identificador e identificador de instancia (GUID).

Establece opciones avanzadas para la sesión. Se debe especificar un objeto SessionOption creado mediante el cmdlet New-PSSessionOption.

Los valores predeterminados para las opciones los determina el valor de la variable de preferencia $PSSessionOption, si se ha definido. De lo contrario, la sesión utiliza los valores predeterminados del sistema.

Para obtener una descripción de las opciones de sesión, incluidos los valores predeterminados, vea New-PSSessionOption. Para obtener información acerca de la variable de preferencia $PSSessionOption, vea about_Preference_Variables.

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

Este límite se aplica únicamente al comando actual; no se aplica a la sesión ni al equipo.

Use el protocolo Capa de sockets seguros (SSL) para establecer una conexión con el equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell que se transmite a través de la red. UseSSL es 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 se usa este parámetro pero SSL no está disponible en el puerto utilizado para el comando, se producirá un error en el comando.

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.