Remove-SCVirtualNetworkAdapter
Supprime un objet de carte réseau virtuelle de VMM.
Syntaxe
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 l’objet de carte réseau virtuelle stocké dans $Adapter de VM02.
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 passe 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 invite à confirmer avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobGroup
Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SlotID
Spécifie un ID numérique utilisé pour identifier un appareil.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualNetworkAdapter
Spécifie un objet de carte réseau virtuelle pour une machine virtuelle.
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. Aucun pilote n’est 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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
.