Nuevo-PSSession

Crea una conexión permanente a un equipo local o remoto.

precaución

la autenticación CredSSP (Credential Security Support Provider), en la que las credenciales de usuario se envían a un equipo remoto para autenticarse, está diseñada para comandos que requieren autenticación en más de un recurso, como acceder a un recurso compartido de red remoto. Este mecanismo reduce el riesgo de seguridad de la operación remota. Si el equipo remoto está comprometido, los datos que se le pasan se pueden usar para controlar la sesión de red.,div>

Type: AuthenticationMechanism Accepted values: Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False

-CertificateThumbprint

Specifies the digital public key certificate (X509) of a user account that has permission to performthis action., Introduzca la huella digital del certificado.

Los certificados se utilizan en la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario local; no funcionan con cuentas de dominio.

para obtener un certificado, utilice el comandoGet-Item oGet-ChildItem en la unidad Cert:de PowerShell.,

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

-ComputerName

Specifies an array of names of computers. This cmdlet creates a persistent connection(PSSession) to the specified computer., Si introduce 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 más ordenadores remotos. Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.). Cuando la computadora se encuentra en un dominio diferente al del Usuario, se requiere el nombre de dominio completo. También 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. Además, el equipo debe estar configurado para el transporte HTTPS o la dirección IP del equipo remoto debe incluirse en la lista WinRM TrustedHosts del ordenador local. Para obtener instrucciones sobre cómo agregar un nombre de equipo a la lista TrustedHosts, consulte «Cómo agregar un ordenador a la lista de Host de confianza» enabout_remote_troubleshooting.

para incluir el equipo local en el valor del parámetro ComputerName, inicie WindowsPowerShell con la opción Ejecutar como administrador.,

Type:	String
Aliases:	Cn
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

Specifies the session configuration that is used for the new PSSession.

Enter a configuration name or the fully qualified resource URI for a session configuration., Si especifica solo el nombre de la configuración, se antepone el siguiente URI de esquema:

The session configuration for a session is located on the remote computer. If the specified sessionconfiguration does not exist on the remote computer, the command fails.

The default value is the value of the $PSSessionConfigurationName variable de preferencia en el ordenador local. Si esta variable de preferencia no está establecida, el valor predeterminado es Microsoft.PowerShell. Para más información, vea about_Preference_Variables.,

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

-ConnectionUri

Specifies a URI that defines the connection endpoint for the session. The URI must be fullyqualified., El formato de esta cadena es como sigue:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

El valor por defecto es la siguiente:

If you do not specify a ConnectionURI, you can use the UseSSL, ComputerName, Port, andApplicationName parameters to specify the ConnectionURI values.

Valid values for the Transport segment of the URI are HTTP and HTTPS. If you specify a connectionURI with a Transport segment, but do not specify a port, the session is created with standardsports: 80 for HTTP and 443 for HTTPS. To use the default ports for PowerShell remoting, specify port5985 for HTTP or 5986 for HTTPS.

If the destination computer redirects the connection to a different URI, PowerShell prevents theredirection unless you use the AllowRedirection parameter in the command.

Type:	Uri
Aliases:	URI, CU
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerId

Specifies an array of IDs of containers. This cmdlet starts an interactive session with each of thespecified containers. Use the docker ps comando para obtener una lista de Id de contenedores. Para obtener más información, consulte la ayuda del comando docker ps.,

Tipo:	String
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	Sí
Aceptar caracteres comodín:	False

-Credencial

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 User01 o Domain01\User01, o introduzca un objeto PSCredential generado por el cmdlet Get-Credential., Si escribes un nombre de usuario, se te pedirá que introduzcas la contraseña.

Las credenciales se almacenan en un PSCredentialobject y la contraseña se almacena como una cadena de seguridad.

Type:	PSCredential
Position:	Named
Default value:	Current user
Accept pipeline input:	true
aceptar caracteres comodín:	false

-enablenetworkaccess

indica que este cmdlet agrega un token de seguridad interactivo a las sesiones de bucle invertido. Interactivetoken le 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 copie archivos XML de un equipo remoto al ordenador local.

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

de forma predeterminada, este cmdlet crea sesiones de bucle invertido mediante un token de red, que puede no proporcionar permisos suficientes para autenticarse en equipos remotos.

el parámetro EnableNetworkAccess solo es efectivo en sesiones de bucle invertido., Si utiliza enablenetworkaccess cuando crea una sesión en un equipo remoto, el comando se ejecuta correctamente, pero el parámetro se ignora.

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

para proteger el equipo de accesos maliciosos, las sesiones de bucle invertido desconectadas que tienen interactivetokens, que son las creadas 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 CredSSPauthentication se pueden volver a conectar desde otros equipos. Para obtener más información, consulteDisconnect-PSSession.

Este parámetro se introdujo en PowerShell 3.0.,

Tipo:	SwitchParameter
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

-HostName

Especifica una matriz de nombres de equipo para un Shell Seguro (SSH), basado en la conexión. Esto es similar al parámetro ComputerName, excepto que la conexión al equipo remoto se realiza utilizando SSHrather que Windows WinRM.,

This parameter was introduced in PowerShell 6.0.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyFilePath

Specifies a key file path used by Secure Shell (SSH) to authenticate a user on a remote computer.,

ssh permite que la autenticación del Usuario se realice a través de claves privadas / públicas como una alternativa a la autenticación basicpassword. Si el equipo remoto está configurado para la autenticación de claves, este parámetro se puede utilizar para proporcionar la clave que identifica al usuario.

Este parámetro se introdujo en PowerShell 6.0.,

Type:	String
Aliases:	IdentityFilePath
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies a friendly name for the PSSession.

You can use the name to refer to the PSSession when you use other cmdlets, such asGet-PSSession and Enter-PSSession., No es necesario que el nombre sea exclusivo del equipo o de la sesión actual.

Tipo:	String
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

Puerto

Especifica el puerto de red del equipo remoto que se utiliza para esta conexión., Para conectarse a un equipo remoto, el equipo remoto debe estar escuchando en el puerto que utiliza 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 oyente WinRM en el equipo remoto para que escuche en ese puerto. Utilice los siguientes comandos para configurar el listener:

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

no utilice el parámetro de Puerto a menos que usted debe., La configuración port del comando se aplica a todos los ordenadores o sesiones en los que se ejecuta el comando. Una configuración de puerto alternativo podría impedir que el comando se ejecute en todos los equipos.

Tipo:	Int32
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

-RunAsAdministrator

Indica que la han agregado ejecuta como administrador.,

Tipo:	SwitchParameter
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

Sesión

Especifica una matriz de se han agregado los objetos que este cmdlet se utiliza como un modelo para la newPSSession. Este parámetro crea nuevos objetos PSSession que tienen las mismas propiedades que los objetos PSSession especificados.,

introduzca una variable que contenga los objetos PSSession o un comando que cree u obtenga los objetos psssession, como un comandoNew-PSSession oGet-PSSession.

los objetos PSSession resultantes tienen el mismo nombre de equipo, nombre de aplicación, URI de conexión,Puerto, nombre de configuración, límite de aceleración y valor de Secure Sockets Layer (SSL) que los originales, pero tienen un nombre para mostrar, ID e ID de instancia (GUID) diferentes.,

Type:	PSSession
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Specifies advanced options for the session., Escriba un objeto SessionOption, como uno que cree mediante el cmdlet New-PSSessionOption, o una tabla hash en la que las claves sean nombres de sessionoption y los valores sean valores de opción de sesión.

los valores predeterminados para las opciones están determinados por el valor del $PSSessionOption preferencevariable, si está establecido. De lo contrario, los valores predeterminados se establecen mediante opciones establecidas en sessionconfiguration.,

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

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

Type:	PSSessionOption
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHConnection

This parameter takes an array of hashtables where each hashtable contains one or more connectionparameters needed to establish a Secure Shell (SSH) connection (HostName, Port, UserName,KeyFilePath).,

los parámetros de conexión de la tabla hash son los mismos definidos para el conjunto de parámetros HostName.

el parámetro SSHConnection es útil para crear varias sesiones donde cada sesión requiere información de conexión diferente.

Este parámetro se introdujo en PowerShell 6.0.,

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHTransport

Indicates that the remote connection is established using Secure Shell (SSH).

By default PowerShell uses Windows WinRM to connect to a remote computer., Este conmutador obliga a spowershell a usar el conjunto de parámetros HostName para establecer una conexión remota basada en SSH.

Este parámetro se introdujo en PowerShell 6.0.,

Type:	SwitchParameter
Accepted values:	true
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Subsystem

Specifies the SSH subsystem used for the new PSSession.

This specifies the subsystem to use on the target as defined in sshd_config.,El subsistema inicia una versión específica de PowerShell con parámetros predefinidos.Si el subsistema especificado no existe en el equipo remoto, el comando falla.

si no se utiliza este parámetro, el valor predeterminado es el subsistema ‘powershell’.,

Tipo:	String
Cargo:	Nombre
valor Predeterminado:	powershell
Aceptar tubería de entrada:	Sí
Aceptar caracteres comodín:	False

-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 introduce un valor de 0 (cero), se utiliza el valor predeterminado, 32.,

el límite del acelerador se aplica solo al comando actual, no a la sesión ni al equipo.

Tipo:	Int32
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

nombre de Usuario

Especifica el nombre de usuario para la cuenta que se utiliza para crear una sesión en el equipo remoto., El método Userauthentication dependerá de cómo se configure Secure Shell (SSH) en el equipo remoto.

si SSH está configurado para la autenticación básica de contraseña, se le solicitará la contraseña de usuario.

si SSH está configurado para la autenticación de usuario basada en clave, se puede proporcionar una ruta de archivo de clave a través del parámetro keyfilepath y no se producirá ninguna solicitud de contraseña. Tenga en cuenta que si el archivo de clave de usuario del cliente se encuentra en una ubicación conocida SSH, el parámetro KeyFilePath no es necesario para la autenticación basada en la clave, y la autenticación del Usuario se producirá automáticamente en función del nombre de usuario., Consulte sshdocumentation about key based user authentication para obtener más información.

Este parámetro no es obligatorio. Si no se especifica ningún parámetro de nombre de usuario, se utiliza el nombre de usuario actual para la conexión.

Este parámetro se introdujo en PowerShell 6.0.,

Tipo:	String
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	False
Aceptar caracteres comodín:	False

-UseSSL

Indica que este cmdlet se utiliza el protocolo SSL para establecer una conexión con el control remoto computer.By por defecto, no se utiliza SSL.

WS-Management cifra todo el contenido de 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 utiliza este parámetro, pero SSL no está disponible en el puerto que se utiliza para el comando, el comando falla.,e

Accept wildcard characters: False

-UseWindowsPowerShell

{{ Fill UseWindowsPowerShell Description }}

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

-VMId

Specifies an array of ID of virtual machines., Este cmdlet inicia una sesión interactiva con cada una de las máquinas virtuales especificadas., To see the virtual machines that are available to you, use thefollowing command:

Get-VM | Select-Object -Property Name, ID

Type:	Guid
Aliases:	VMGuid
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Specifies an array of names of virtual machines., Este cmdlet inicia una sesión interactiva con cada una de las máquinas virtuales especificadas. Para ver las máquinas virtuales disponibles, utilice el cmdletGet-VM.

Tipo:	String
Cargo:	Nombre
valor Predeterminado:	Ninguno
Aceptar tubería de entrada:	Sí
Aceptar caracteres comodín:	False