Remove-SCVirtualNetworkAdapter
Quita un objeto de adaptador de red virtual 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
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 usados en un entorno de Virtual Machine Manager (VMM).
Este cmdlet devuelve el objeto cuando se ejecuta correctamente (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.
Ejemplos
Ejemplo 1: Quitar 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 de VM02 el adaptador de red virtual almacenado en $Adapter.
Ejemplo 3: Quitar el ú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 que tiene 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 , que quita este objeto de adaptador de red virtual de VM05.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlotID
Especifica un identificador numérico que se usa para identificar un dispositivo.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | VirtualNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Notas
- Requiere un objeto de adaptador de red virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualNetworkAdapter .