Compartilhar via

Get-SCVirtualNetworkAdapter

Módulo:
VirtualMachineManager Module

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

Sintaxe

All 

Get-SCVirtualNetworkAdapter
    [-VMMServer <ServerConnection>]
    [-All]
    [-ParentTypeVMOrHost]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HardwareProfile 

Get-SCVirtualNetworkAdapter
    -HardwareProfile <HardwareProfile>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM 

Get-SCVirtualNetworkAdapter
    -VM <VM>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Template 

Get-SCVirtualNetworkAdapter
    -VMTemplate <Template>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMHost 

Get-SCVirtualNetworkAdapter
    -VMHost <Host>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID 

Get-SCVirtualNetworkAdapter
    [-ID] <Guid>
    [[-Name] <String>]
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet Get-SCVirtualNetworkAdapter obtém um ou mais objetos de adaptador de rede virtual de um objeto de máquina virtual, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware em um ambiente do Virtual Machine Manager (VMM).

Exemplos

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

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

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 todos os objetos do adaptador de rede virtual na VM01 e exibe informações sobre os adaptadores para o usuário.

Exemplo 2: Obter adaptadores de rede virtual 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 do VMM, seleciona o objeto de modelo chamado VMTemplate01 e armazena o objeto na variável $VMTemplate.

O último comando obtém todos os objetos do adaptador de rede virtual VMTemplate01 e exibe informações sobre esses adaptadores para o usuário.

Exemplo 3: Obter adaptadores de rede virtual 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 do VMM, seleciona o objeto de perfil chamado NewHWProfile01 e armazena o objeto na variável $HWProfile.

O segundo comando obtém todos os objetos do adaptador de rede virtual NewHWProfile01 e exibe informações sobre esses adaptadores para o usuário.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentemente do objeto pai.

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 ao qual cada objeto de unidade de disco virtual está associado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

All
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Propriedades do parâmetro

Tipo:HardwareProfile
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

HardwareProfile
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ID
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome de um objeto de rede.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ID
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ParentTypeVMOrHost

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

All
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VM

Especifica um objeto de máquina virtual.

Propriedades do parâmetro

Tipo:VM
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VM
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM oferece suporte a hosts Hyper-V, hosts VMware ESX e hosts Citrix XenServer.

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

Propriedades do parâmetro

Tipo:Host
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VMHost
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMTemplate

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

Propriedades do parâmetro

Tipo:Template
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Modelo

Conjuntos de parâmetros

Template
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Saídas

VirtualNetworkAdapter

Esse cmdlet retorna um objeto VirtualNetworkAdapter .

Observações

  • Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado usando o Get-SCVirtualMachine, Get-SCVMTemplateou Get-SCHardwareProfile cmdlets, respectivamente.