Remove-SCVirtualNetworkAdapter
Remove um objeto de adaptador de rede virtual do VMM.
Sintaxe
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
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 Virtual Machine Manager (VMM).
Este cmdlet retorna o objeto após o êxito (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro em caso de 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 no 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 no $Adapter do 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 no 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 no $Adapter do 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 no VM03 e armazena o objeto na variável $Adapter. Este exemplo pressupõe que o VM03 tenha apenas um adaptador de rede virtual.
O último comando remove o objeto do adaptador de rede virtual armazenado no $Adapter do 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 de adaptador de rede virtual no VM04 e armazena os objetos na matriz de objetos $Adapters.
O último comando passa cada objeto armazenado no $Adapters para Remove-SCVirtualNetworkAdapter, que remove cada objeto de adaptador de rede virtual do VM04.
Exemplo 5: Remover o segundo adaptador de rede virtual de uma máquina virtual que tenha 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 no VM05 e armazena os objetos na matriz de objetos $Adapters. Este exemplo pressupõe que o VM05 tenha três adaptadores de rede virtual.
O último comando passa o segundo objeto de adaptador de rede virtual ($Adapters [1]) para o cmdlet Remove-SCVirtualNetworkAdapter , que remove esse objeto de adaptador de rede virtual do VM05.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
VirtualNicSpecified
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | UserRole |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SlotID
Especifica uma ID numérica usada para identificar um dispositivo.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SlotIdSpecified
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-VirtualNetworkAdapter
Especifica um objeto de adaptador de rede virtual para uma máquina virtual.
Os tipos de hosts suportam o seguinte número de adaptadores de rede virtual:
- Hiper-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.
- 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.
Propriedades dos parâmetros
| Tipo: | VirtualNetworkAdapter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
VirtualNicSpecified
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Notas
- Requer um objeto de adaptador de rede virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualNetworkAdapter .