Partilhar via

Get-SCVirtualNetworkAdapter

  • Referência
Módulo:
VirtualMachineManager

Obtém objetos adaptador de rede virtuais VMM de uma máquina virtual, modelo de máquina virtual ou perfil de hardware.

Syntax

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-All]
   [-ParentTypeVMOrHost]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMHost <Host>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Get-SCVirtualNetworkAdapter obtém um ou mais objetos adaptadores de rede virtuais de um objeto de máquina virtual, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware num ambiente virtual de Gestor de Máquinas (VMM).

Exemplos

Exemplo 1: Obter adaptadores de rede virtuais a partir de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM

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 todos os objetos adaptadores de rede virtuais em VM01 e exibe informações sobre os adaptadores ao utilizador.

Exemplo 2: Obtenha adaptadores de rede virtuais a partir de um modelo de máquina virtual

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate

O primeiro comando obtém todos os objetos de modelo de máquina virtual da biblioteca VMM, seleciona o objeto do modelo chamado VMTemplate01 e armazena o objeto na variável $VMTemplate.

O último comando obtém todos os objetos adaptadores de rede virtuais VMTemplate01 e exibe informações sobre estes adaptadores ao utilizador.

Exemplo 3: Obtenha adaptadores de rede virtuais a partir de um perfil de hardware

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile

O primeiro comando obtém todos os objetos de perfil de hardware na biblioteca VMM, seleciona o objeto de perfil chamado NewHWProfile01 e, em seguida, armazena o objeto na variável $HWProfile.

O segundo comando obtém todos os objetos adaptadores de rede virtuais NewHWProfile01 e apresenta informações sobre estes adaptadores ao utilizador.

Parâmetros

-All

Indica que este cmdlet obtém todos os objetos subordinados independentemente do objeto principal.

Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo com o qual cada objeto de unidade de disco virtual esteja associado.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Type:HardwareProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ID

Especifica o identificador numérico como um identificador globalmente único, ou GUID, para um objeto específico.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome de um objeto de rede.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-ParentTypeVMOrHost

Indica que o tipo de pai é uma máquina virtual ou um hospedeiro.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Especifica um objeto de máquina virtual.

Type:VM
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Especifica um objeto hospedeiro de máquina virtual. A VMM suporta anfitriões Hiper-V, anfitriões VMware ESX e anfitriões Citrix XenServer.

Para obter mais informações sobre cada tipo de hospedeiro, consulte o cmdlet Add-SCVMHost .

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMTemplate

Especifica um objeto de modelo VMM usado para criar máquinas virtuais.

Type:Template
Aliases:Template
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

VirtualNetworkAdapter

Este cmdlet devolve um objeto VirtualNetworkAdapter .

Notas

  • Requer um objeto de máquina virtual VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado utilizando os cmdletes Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivamente.