Remove-SCVirtualNetworkAdapter
Remove um objeto adaptador de rede virtual do 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
O cmdlet Remove-SCVirtualNetworkAdapter remove um ou mais objetos adaptadores de rede virtuais de uma máquina virtual, modelo de máquina virtual ou perfil de hardware utilizado num ambiente virtual de Gestor de Máquinas (VMM).
Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para $True) ou devolve 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 recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto adaptador de rede virtual em 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 de VM01.
Exemplo 2: Remover um adaptador de rede virtual ligado 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 da máquina virtual chamado VM02 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto adaptador de rede virtual em VM02 que está ligado à rede virtual especificada e armazena o objeto na variável $Adapter.
O último comando remove o objeto de placa de rede virtual armazenado em $Adapter a partir de 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 recebe o objeto da máquina virtual chamado VM03 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto adaptador de rede virtual em VM03 e armazena o objeto na variável $Adapter. Este exemplo pressupõe que o VM03 tem apenas um adaptador de rede virtual.
O último comando remove o objeto adaptador de rede virtual armazenado em $Adapter de VM03.
Exemplo 4: Remover todos os adaptadores de rede virtuais 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 recebe o objeto da máquina virtual chamado VM04 e armazena o objeto na variável $VM.
O segundo comando obtém todos os objetos adaptador de rede virtuais em 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 adaptador de rede virtual de VM04.
Exemplo 5: Remover o segundo adaptador de rede virtual de uma máquina virtual que tem três adaptadores de rede virtuais
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter
O primeiro comando recebe o objeto da máquina virtual chamado VM05 e armazena o objeto na variável $VM.
O segundo comando obtém todos os objetos adaptador de rede virtuais em VM05 e armazena os objetos na matriz de objetos $Adapters. Este exemplo pressupõe que o VM05 tem três adaptadores de rede virtuais.
O último comando passa o segundo objeto adaptador de rede virtual ($Adapters [1]) para o cmdlet Remove-SCVirtualNetworkAdapter , que remove este objeto adaptador de rede virtual de VM05.
Parâmetros
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Especifica um identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SlotID
Especifica um ID numérico usado para identificar um dispositivo.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualNetworkAdapter
Especifica um objeto adaptador de rede virtual para uma máquina virtual.
Os tipos de anfitriões suportam o seguinte número de adaptadores de rede virtuais:
- Hiper-V. Até quatro adaptadores emulados por máquina virtual. Não existe nenhum controlador disponível para um adaptador de rede emulsionado num sistema operativo de hóspedes Windows Server 2003 x64.
- Hiper-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.
Type: | VirtualNetworkAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Notas
- Requer um objeto adaptador de rede virtual VMM, que pode ser recuperado utilizando o cmdlet Get-SCVirtualNetworkAdapter .