Share via


Set-VMSwitchTeam

Set-VMSwitchTeam

Configures a virtual switch team.

Syntaxe

Parameter Set: SwitchName_NetAdapterInterfaceDescription
Set-VMSwitchTeam [-Name] <String[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-LoadBalancingAlgorithm <VMSwitchLoadBalancingAlgorithm]> ] [-NetAdapterInterfaceDescription <String[]> ] [-Passthru] [-TeamingMode <VMSwitchTeamingMode]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SwitchName_NetAdapterName
Set-VMSwitchTeam [-Name] <String[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-LoadBalancingAlgorithm <VMSwitchLoadBalancingAlgorithm]> ] [-NetAdapterName <String[]> ] [-Passthru] [-TeamingMode <VMSwitchTeamingMode]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SwitchObject_NetAdapterInterfaceDescription
Set-VMSwitchTeam [-VMSwitch] <VMSwitch[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-LoadBalancingAlgorithm <VMSwitchLoadBalancingAlgorithm]> ] [-NetAdapterInterfaceDescription <String[]> ] [-Passthru] [-TeamingMode <VMSwitchTeamingMode]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SwitchObject_NetAdapterName
Set-VMSwitchTeam [-VMSwitch] <VMSwitch[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-LoadBalancingAlgorithm <VMSwitchLoadBalancingAlgorithm]> ] [-NetAdapterName <String[]> ] [-Passthru] [-TeamingMode <VMSwitchTeamingMode]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Set-VMSwitchTeam cmdlet configures a virtual switch team.

Paramètres

-CimSession<CimSession[]>

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts that run this cmdlet. 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

PSComputerName

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

true(ByPropertyName)

Accepter les caractères génériques ?

false

-Credential<PSCredential[]>

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

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-LoadBalancingAlgorithm<VMSwitchLoadBalancingAlgorithm]>

Specifies the load balancing algorithm that this switch team uses. Les valeurs acceptables pour ce paramètre sont les suivantes :  Dynamic and HyperVPort. The default value is Dynamic.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Name<String[]>

Specifies an array of names of virtual switches that this cmdlet configures for teaming.

Alias

SwitchName

Requis ?

true

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NetAdapterInterfaceDescription<String[]>

Specifies an array of interface descriptions of the virtual network adapters that this cmdlet includes in the switch team. This value replaces the existing members.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NetAdapterName<String[]>

Specifies an array of names of the virtual network adapters that this cmdlet includes in the switch team. This value replaces the existing members.

Alias

InterfaceAlias

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Passthru

Indicates that this cmdlet returns the Microsoft.HyperV.PowerShell.VMSwitch object that it configures.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-TeamingMode<VMSwitchTeamingMode]>

Specifies the teaming mode. Currently, the only option is SwitchIndependent.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-VMSwitch<VMSwitch[]>

Specifies an array of virtual switches that this cmdlet configures for teaming. To obtain a VMSwitch object, use the Get-VMSwitch cmdlet.

Alias

none

Requis ?

true

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

true(ByValue)

Accepter les caractères génériques ?

false

-Confirm

Vous invite à confirmer l'exécution de l'applet de commande.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Indique ce qui se produit en cas d'exécution de l'applet de commande. L'applet de commande n'est pas exécutée.

Requis ?

false

Position ?

named

Valeur par défaut

false

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

  • Microsoft.HyperV.PowerShell.VMSwitch

    This cmdlet returns a VMSwitch object, if you specify the Passthru parameter.

Exemples

Example 1: Configure a switch team to user dynamic load balancing

This command configures the switch team named SwitchTeam07 to use a dynamic load balancing algorithm.

PS C:\> Set-VMSwitchTeam -Name "SwitchTeam07" -LoadBalancingAlgorithm Dynamic 

Rubriques connexes

Get-VMSwitchTeam

Get-VMSwitch