Compartir a través de

Remove-SCVirtualNetworkAdapter

Módulo:
VirtualMachineManager Module

Quita un objeto de adaptador de red virtual de VMM.

Sintaxis

VirtualNicSpecified 

Remove-SCVirtualNetworkAdapter
    [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

SlotIdSpecified 

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 en caso de éxito (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error en caso de 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 $Adapter

El 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: Quitar 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 $Adapter

El 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 del 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: 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 $Adapter

El 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 del adaptador de red virtual en VM03 y almacena el objeto en la variable $Adapter. En este ejemplo se supone que VM03 solo tiene un adaptador de red virtual.

El último comando quita el objeto de adaptador de red virtual almacenado en $Adapter de VM03.

Ejemplo 4: Quitar 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-SCVirtualNetworkAdapter

El 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 del adaptador de red virtual de VM04.

Ejemplo 5: Quitar el 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-SCVirtualNetworkAdapter

El 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 pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VirtualNicSpecified
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que este progreso se almacena en la variable denominada por este parámetro.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet opera en nombre del rol de usuario que especifica este parámetro.

Propiedades del parámetro

Tipo:UserRole
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SlotID

Especifica un identificador numérico utilizado para identificar un dispositivo.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SlotIdSpecified
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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:

  • Hiper-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.
  • Hiper-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.

Propiedades del parámetro

Tipo:VirtualNetworkAdapter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VirtualNicSpecified
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Notas

  • Requiere un objeto de adaptador de red virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualNetworkAdapter .