Remove-SCVirtualNetworkAdapter
Supprime un objet de carte réseau virtuelle de VMM.
Syntax
Remove-SCVirtualNetworkAdapter
[-VirtualNetworkAdapter] <VirtualNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Remove-SCVirtualNetworkAdapter
-SlotID <Int32>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
L’applet de commande Remove-SCVirtualNetworkAdapter supprime un ou plusieurs objets de carte réseau virtuelle d’une machine virtuelle, d’un modèle de machine virtuelle ou d’un profil matériel utilisé dans un environnement Virtual Machine Manager (VMM).
Cette applet de commande retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou retourne un message d’erreur en cas d’échec.
Exemples
Exemple 1 : Supprimer une carte réseau virtuelle avec l’adresse MAC spécifiée d’une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande obtient l’objet de carte réseau virtuelle sur VM01 qui a l’adresse MAC spécifiée et stocke l’objet dans la variable $Adapter.
La dernière commande supprime la carte réseau virtuelle stockée dans $Adapter de VM01.
Exemple 2 : Supprimer une carte réseau virtuelle connectée à un réseau virtuel spécifique d’une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterLa première commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM.
La deuxième commande obtient l’objet de carte réseau virtuelle sur VM02 connecté au réseau virtuel spécifié et stocke l’objet dans la variable $Adapter.
La dernière commande supprime de VM02 l’objet carte réseau virtuelle stocké dans $Adapter.
Exemple 3 : Supprimer la seule carte réseau virtuelle d’une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterLa première commande obtient l’objet de machine virtuelle nommé VM03 et stocke l’objet dans la variable $VM.
La deuxième commande obtient l’objet de carte réseau virtuelle sur VM03 et stocke l’objet dans la variable $Adapter. Cet exemple suppose que VM03 n’a qu’une seule carte réseau virtuelle.
La dernière commande supprime l’objet de carte réseau virtuelle stocké dans $Adapter de VM03.
Exemple 4 : Supprimer toutes les cartes réseau virtuelles d’une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapterLa première commande obtient l’objet de machine virtuelle nommé VM04 et stocke l’objet dans la variable $VM.
La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM04 et stocke les objets dans le tableau d’objets $Adapters.
La dernière commande transmet chaque objet stocké dans $Adapters à Remove-SCVirtualNetworkAdapter, ce qui supprime chaque objet de carte réseau virtuelle de VM04.
Exemple 5 : Supprimer la deuxième carte réseau virtuelle d’une machine virtuelle avec trois cartes réseau virtuelles
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapterLa première commande obtient l’objet de machine virtuelle nommé VM05 et stocke l’objet dans la variable $VM.
La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM05 et stocke les objets dans le tableau d’objets $Adapters. Cet exemple suppose que VM05 a trois cartes réseau virtuelles.
La dernière commande transmet le deuxième objet de carte réseau virtuelle ($Adapters [1]) à l’applet de commande Remove-SCVirtualNetworkAdapter , qui supprime cet objet de carte réseau virtuelle de VM05.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlotID
Spécifie un ID numérique utilisé pour identifier un appareil.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapter
Spécifie un objet carte réseau virtuelle pour un ordinateur virtuel.
Les types d’hôtes prennent en charge le nombre suivant de cartes réseau virtuelles :
- Hyper-V. Jusqu’à quatre adaptateurs émulés par machine virtuelle. Il n’existe aucun pilote disponible pour une carte réseau émulée sur un système d’exploitation invité Windows Server 2003 x64.
- Hyper-V. Jusqu’à huit adaptateurs synthétiques par machine virtuelle.
- VMware ESX. Jusqu’à quatre adaptateurs émulés par machine virtuelle.
- Citrix XenServer. Jusqu’à sept adaptateurs émulés par machine virtuelle.
| Type: | VirtualNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Notes
- Nécessite un objet de carte réseau virtuelle VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualNetworkAdapter .