Remove-SCVirtualNetworkAdapter
Quita un objeto de adaptador de red virtual de VMM.
Sintaxis
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
El cmdlet Remove-SCVirtualNetworkAdapter quita uno o varios objetos de adaptador de red virtual de una máquina virtual, una plantilla de máquina virtual o un perfil de hardware usado en un entorno de Virtual Machine Manager (VMM).
Este cmdlet devuelve el objeto tras éxito (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.
Ejemplos
Ejemplo 1: Eliminación de un adaptador de red virtual con la dirección MAC especificada de una máquina virtual
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 $AdapterEl primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de adaptador de red virtual en VM01 que tiene la dirección MAC especificada y almacena el objeto en la variable $Adapter.
El último comando quita el adaptador de red virtual almacenado en $Adapter de VM01.
Ejemplo 2: Eliminación de un adaptador de red virtual conectado a una red virtual específica de una máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterEl primer comando obtiene el objeto de máquina virtual denominado VM02 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de adaptador de red virtual en VM02 que está conectado a la red virtual especificada y almacena el objeto en la variable $Adapter.
El último comando quita el objeto de adaptador de red virtual almacenado en $Adapter de VM02.
Ejemplo 3: Eliminación del único adaptador de red virtual de una máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterEl primer comando obtiene el objeto de máquina virtual denominado VM03 y almacena el objeto en la variable $VM.
El segundo comando obtiene el objeto de adaptador de red virtual en VM03 y almacena el objeto en la variable $Adapter. En este ejemplo se supone que VM03 tiene solo un adaptador de red virtual.
El último comando quita el objeto de adaptador de red virtual almacenado en $Adapter de VM03.
Ejemplo 4: Eliminación de todos los adaptadores de red virtual de una máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapterEl primer comando obtiene el objeto de máquina virtual denominado VM04 y almacena el objeto en la variable $VM.
El segundo comando obtiene todos los objetos del adaptador de red virtual en VM04 y almacena los objetos en la matriz de objetos $Adapters.
El último comando pasa cada objeto almacenado en $Adapters a Remove-SCVirtualNetworkAdapter, que quita cada objeto de adaptador de red virtual de VM04.
Ejemplo 5: Eliminación del segundo adaptador de red virtual de una máquina virtual con tres adaptadores de red virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapterEl primer comando obtiene el objeto de máquina virtual denominado VM05 y almacena el objeto en la variable $VM.
El segundo comando obtiene todos los objetos del adaptador de red virtual en VM05 y almacena los objetos en la matriz de objetos $Adapters. En este ejemplo se supone que VM05 tiene tres adaptadores de red virtual.
El último comando pasa el segundo objeto de adaptador de red virtual ($Adapters [1]) al cmdlet Remove-SCVirtualNetworkAdapter
Parámetros
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario.
Para obtener un rol de usuario, use el cmdlet
| Tipo: | UserRole |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PROTipID
Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SlotID
Especifica un identificador numérico que se usa para identificar un dispositivo.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VirtualNetworkAdapter
Especifica un objeto de adaptador de red virtual para una máquina virtual.
Los tipos de hosts admiten el siguiente número de adaptadores de red virtual:
- Hyper-V. Hasta cuatro adaptadores emulados por máquina virtual. No hay ningún controlador disponible para un adaptador de red emulado en un sistema operativo invitado windows Server 2003 x64.
- Hyper-V. Hasta ocho adaptadores sintéticos por máquina virtual.
- VMware ESX. Hasta cuatro adaptadores emulados por máquina virtual.
- Citrix XenServer. Hasta siete adaptadores emulados por máquina virtual.
| Tipo: | VirtualNetworkAdapter |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Notas
- Requiere un objeto de adaptador de red virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualNetworkAdapter.