Compartilhar via

Remove-SCVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de adaptador de rede virtual do VMM.

Sintaxe

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

O cmdlet Remove-SCVirtualNetworkAdapter remove um ou mais objetos de adaptador de rede virtual de uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado em um ambiente do VMM (Virtual Machine Manager).

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro após falha.

Exemplos

Exemplo 1: remover um adaptador de rede virtual com o endereço MAC especificado de uma 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

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto do adaptador de rede virtual na VM01 que tem o endereço MAC especificado e armazena o objeto na variável $Adapter.

O último comando remove o adaptador de rede virtual armazenado em $Adapter da VM01.

Exemplo 2: remover um adaptador de rede virtual conectado a uma rede virtual específica de uma 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

O primeiro comando obtém o objeto de máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto do adaptador de rede virtual na VM02 que está conectado à rede virtual especificada e armazena o objeto na variável $Adapter.

O último comando remove o objeto do adaptador de rede virtual armazenado em $Adapter da VM02.

Exemplo 3: remover o único adaptador de rede virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

O primeiro comando obtém o objeto de máquina virtual chamado VM03 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto do adaptador de rede virtual na VM03 e armazena o objeto na variável $Adapter. Este exemplo pressupõe que a VM03 tenha apenas um adaptador de rede virtual.

O último comando remove o objeto do adaptador de rede virtual armazenado em $Adapter da VM03.

Exemplo 4: remover todos os adaptadores de rede virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

O primeiro comando obtém o objeto de máquina virtual chamado VM04 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos do adaptador de rede virtual na VM04 e armazena os objetos na matriz de objetos $Adapters.

O último comando passa cada objeto armazenado em $Adapters para Remove-SCVirtualNetworkAdapter, que remove cada objeto do adaptador de rede virtual da VM04.

Exemplo 5: remover o segundo adaptador de rede virtual de uma máquina virtual que tem três adaptadores de rede virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

O primeiro comando obtém o objeto de máquina virtual chamado VM05 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos do adaptador de rede virtual na VM05 e armazena os objetos na matriz de objetos $Adapters. Este exemplo pressupõe que a VM05 tenha três adaptadores de rede virtual.

O último comando passa o segundo objeto do adaptador de rede virtual ($Adapters [1]) para o cmdlet Remove-SCVirtualNetworkAdapter, que remove esse objeto do adaptador de rede virtual da VM05.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SlotID

Especifica uma ID numérica usada para identificar um dispositivo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualNetworkAdapter

Especifica um objeto de adaptador de rede virtual para uma máquina virtual.

Os tipos de hosts dão suporte ao seguinte número de adaptadores de rede virtual:

  • Hyper-V. Até quatro adaptadores emulados por máquina virtual. Não há nenhum driver disponível para um adaptador de rede emulado em um sistema operacional convidado do Windows Server 2003 x64.
  • Hyper-V. Até oito adaptadores sintéticos por máquina virtual.
  • VMware ESX. Até quatro adaptadores emulados por máquina virtual.
  • Citrix XenServer. Até sete adaptadores emulados por máquina virtual.
Tipo:VirtualNetworkAdapter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Observações

  • Requer um objeto de adaptador de rede virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualNetworkAdapter.