Partager via

Set-SCLogicalSwitchVirtualNetworkAdapter

Module:
VirtualMachineManager Module

Valide toutes les modifications apportées aux paramètres d’une carte réseau virtuelle (VNIC) existante connectée à un commutateur logique.

Syntaxe

Default (Par défaut) 

Set-SCLogicalSwitchVirtualNetworkAdapter

    [-LogicalSwitchVirtualNetworkAdapter] <LogicalSwitchVirtualNetworkAdapter>
    [-EthernetAddressType <EthernetAddressType>]
    [-IPv4AddressType <EthernetAddressType>]
    [-IPv6AddressType <EthernetAddressType>]
    [-VMNetwork <VMNetwork>]
    [-VMSubnet <VMSubnet>]
    [-PortClassification <PortClassification>]
    [-VLanEnabled <Boolean>]
    [-VLanID <UInt16>]
    [-IPv4AddressPool <StaticIPAddressPool>]
    [-IPv6AddressPool <StaticIPAddressPool>]
    [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
    [-IsUsedForHostManagement <Boolean>]
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-Description <String>]
    [-RemoveVMNetwork]
    [-RemoveVMSubnet]
    [-RemovePortClassification]
    [-RemoveIPv4AddressPool]
    [-RemoveIPv6AddressPool]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Set-SCLogicalSwitchVirtualNetworkAdapter valide les modifications apportées à une carte de réseau virtuel existante qui a été ajoutée au profil de port de liaison montante dans le cadre de la définition du commutateur logique.

Exemples

Exemple 1 : Renommer une carte réseau virtuelle de commutateur logique

PS C:\> $HostVNic= Get-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_hostMgmt"
PS C:\> Set-SCLogicalSwitchVirtualNetworkAdapter -LogicalSwitchVirtualNetworkAdapter $HostVNic -Name "LogSw01_cluster"

La première commande obtient une carte réseau virtuelle de commutateur logique à l’aide de l’applet de commande Get-SCLogicalSwitchVirtualNetworkAdapter , puis la stocke dans la variable $HostVNic.

La deuxième commande renomme l’adaptateur en $HostVNic.

Paramètres

-Description

Spécifie une description de la carte réseau virtuelle.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EthernetAddressType

Spécifie un type d’adresse Ethernet. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Dynamique
  • Statique

Propriétés du paramètre

Type:EthernetAddressType
Valeur par défaut:None
Valeurs acceptées:Dynamic, Static
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InheritsAddressFromPhysicalNetworkAdapter

Indique si la carte réseau hérite de son adresse d’une carte réseau physique.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPv4AddressPool

Spécifie un pool d’adresses statiques qui contient des adresses IPv4.

Propriétés du paramètre

Type:StaticIPAddressPool
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPv4AddressType

Spécifie un type d’adresse IPv4. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Dynamique
  • Statique

Propriétés du paramètre

Type:EthernetAddressType
Valeur par défaut:None
Valeurs acceptées:Dynamic, Static
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPv6AddressPool

Spécifie un pool d’adresses statiques qui contient des adresses IPv6.

Propriétés du paramètre

Type:StaticIPAddressPool
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPv6AddressType

Spécifie un type d’adresse IPv6. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Dynamique
  • Statique

Propriétés du paramètre

Type:EthernetAddressType
Valeur par défaut:None
Valeurs acceptées:Dynamic, Static
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsUsedForHostManagement

Indique si la carte réseau virtuelle est utilisée pour la gestion de l’hôte.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogicalSwitchVirtualNetworkAdapter

Spécifie un objet de carte réseau virtuelle de commutateur logique.

Propriétés du paramètre

Type:LogicalSwitchVirtualNetworkAdapter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom de la carte réseau.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PortClassification

Spécifie la classification de port du commutateur auquel la carte réseau virtuelle se connecte.

Propriétés du paramètre

Type:PortClassification
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveIPv4AddressPool

Indique que cette applet de commande supprime un pool d’adresses IPv4.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveIPv6AddressPool

Indique que cette applet de commande supprime un pool d’adresses IPv6.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemovePortClassification

Indique que cette applet de commande supprime une classification de port.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveVMNetwork

Indique que cette applet de commande supprime un réseau de machines virtuelles.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveVMSubnet

Indique que cette applet de commande supprime un sous-réseau de machine virtuelle.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VLanEnabled

Indique s’il faut activer un réseau local virtuel (VLAN) pour une utilisation par des machines virtuelles sur un hôte Hyper-V ou Citrix XenServer.

  • Exemple de format pour un seul VLAN : -VLANEnabled -VLANMode "Access" -VLANID 35
  • Exemple de format pour plusieurs VLAN : -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VLanID

Attribue un identificateur numérique compris entre 1 et 4094 à une carte réseau virtuelle sur une machine virtuelle ou à une carte réseau physique sur un hôte de machine virtuelle.

Configurez un VLanID sur un hôte Hyper-V, VMware ESX ou Citrix XenServer sur une carte réseau physique externe lorsque le mode VLan est Access.

Configurez un VLanID sur une carte de réseau virtuel d’une machine virtuelle liée à une carte réseau physique sur l’hôte ou liée à un réseau virtuel interne sur l’hôte.

Exemple de format : -VLanEnabled -VLanMode "Access" -VLANID 35

Propriétés du paramètre

Type:UInt16
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMMServer

Spécifie un objet serveur VMM.

Propriétés du paramètre

Type:ServerConnection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMNetwork

Spécifie un objet réseau de machine virtuelle.

Propriétés du paramètre

Type:VMNetwork
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMSubnet

Spécifie un objet de sous-réseau de machine virtuelle.

Pour obtenir un objet VMSubnet , utilisez l’applet de commande Get-SCVMSubnet .

Propriétés du paramètre

Type:VMSubnet
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.