Connect-VMNetworkAdapter

Connect-VMNetworkAdapter

Connects a virtual network adapter to a virtual switch.

Sintaxis

Parameter Set: Name_SwitchName
Connect-VMNetworkAdapter [-VMName] <String[]> [[-Name] <String[]> ] [-SwitchName] <String> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Name_SwitchObject
Connect-VMNetworkAdapter [-VMName] <String[]> [[-Name] <String[]> ] [-VMSwitch] <VMSwitch> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Name_UseAutomaticConnection
Connect-VMNetworkAdapter [-VMName] <String[]> [[-Name] <String[]> ] -UseAutomaticConnection [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Object_SwitchName
Connect-VMNetworkAdapter [-VMNetworkAdapter] <VMNetworkAdapter[]> [-SwitchName] <String> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Object_SwitchObject
Connect-VMNetworkAdapter [-VMNetworkAdapter] <VMNetworkAdapter[]> [-VMSwitch] <VMSwitch> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Object_UseAutomaticConnection
Connect-VMNetworkAdapter [-VMNetworkAdapter] <VMNetworkAdapter[]> -UseAutomaticConnection [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Connect-VMNetworkAdapter cmdlet connects a virtual network adapter to a virtual switch.

Parámetros

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-ComputerName<String[]>

Specifies one or more virtual machine hosts on which the virtual network adapter is to be connected. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Name<String[]>

Specifies the name of the virtual network adapter to be connected.

Alias	VMNetworkAdapterName
¿Necesario?	false
¿Posición?	2
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Passthru

Specifies that a Microsoft.HyperV.PowerShell.VMNetworkAdapter object is to be passed through to the pipeline representing the virtual network adapter to be connected.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-SwitchName<String>

Specifies the name of the virtual switch to which the virtual network adapter is to be connected.

Alias	none
¿Necesario?	true
¿Posición?	2
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-UseAutomaticConnection

Specifies that the network adapter is to be connected to any virtual switch in the resource pool, rather than to a specific virtual switch.

Alias	none
¿Necesario?	true
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-VMName<String[]>

Specifies the name of the virtual machine in which the network adapter is to be connected.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-VMNetworkAdapter<VMNetworkAdapter[]>

Specifies the virtual network adapter to be connected.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

-VMSwitch<VMSwitch>

Specifies the virtual switch to which the virtual network adapter is to be connected.

Alias	none
¿Necesario?	true
¿Posición?	2
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

• None by default; Microsoft.HyperV.PowerShell.VMNetworkAdapter if –PassThru is specified.

Ejemplos

Example 1

Connects a virtual network adapter named Internet in virtual machines Test1 and Test2 to a virtual switch InternetAccess.

PS C:\> Connect-VMNetworkAdapter -VMName Test1,Test2 -Name Internet -SwitchName InternetAccess

Example 2

Connects a virtual network adapter in virtual machine Test1 to virtual switch InternetAccess.

PS C:\> Get-VMNetworkAdapter –VMName Test1 | Connect-VMNetworkAdapter –SwitchName InternetAccess

Example 3

Connects a virtual network adapter in virtual machine Test1 to switch InternetAccess.

PS C:\> Get-VMSwitch InternetAccess | Connect-VMNetworkAdapter -VMName Test1