Sdílet prostřednictvím

Get-SCVirtualNetworkAdapter

  • Reference
Modul:
VirtualMachineManager

Získá objekty virtuálního síťového adaptéru VMM z virtuálního počítače, šablony virtuálního počítače nebo hardwarového profilu.

Syntaxe

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

Rutina Get-SCVirtualNetworkAdapter získá jeden nebo více objektů virtuálního síťového adaptéru z objektu virtuálního počítače, objektu šablony virtuálního počítače nebo objektu profilu hardwaru v prostředí virtual Machine Manageru (VMM).

Příklady

Příklad 1: Získání virtuálních síťových adaptérů z virtuálního počítače

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálních síťových adaptérů na virtuálním počítači VM01 a zobrazí informace o adaptérech uživateli.

Příklad 2: Získání virtuálních síťových adaptérů ze šablony virtuálního počítače

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

První příkaz získá všechny objekty šablony virtuálního počítače z knihovny VMM, vybere objekt šablony s názvem VMTemplate01 a uloží objekt do $VMTemplate proměnné.

Poslední příkaz získá všechny objekty virtuálních síťových adaptérů VMTemplate01 a zobrazí informace o těchto adaptérech uživateli.

Příklad 3: Získání virtuálních síťových adaptérů z hardwarového profilu

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

První příkaz získá všechny objekty hardwarového profilu v knihovně VMM, vybere objekt profilu s názvem NewHWProfile01 a pak uloží objekt do proměnné $HWProfile.

Druhý příkaz získá všechny objekty virtuálních síťových adaptérů NewHWProfile01 a zobrazí informace o těchto adaptérech uživateli.

Parametry

-All

Označuje, že tato rutina získá všechny podřízené objekty nezávislé na nadřazeného objektu.

Například příkaz Get-SCVirtualDiskDrive -All získá všechny objekty virtuální diskové jednotky bez ohledu na objekt virtuálního počítače nebo objekt šablony, ke kterému je každý objekt jednotky virtuálního disku přidružený.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-HardwareProfile

Určuje objekt hardwarového profilu.

Typ:HardwareProfile
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ID

Určuje číselný identifikátor jako globálně jedinečný identifikátor nebo identifikátor GUID konkrétního objektu.

Typ:Guid
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název síťového objektu.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ParentTypeVMOrHost

Označuje, že nadřazený typ je virtuální počítač nebo hostitel.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VM

Určuje objekt virtuálního počítače.

Typ:VM
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMHost

Určuje objekt hostitele virtuálního počítače. Nástroj VMM podporuje hostitele Hyper-V, hostitele VMware ESX a hostitele Citrix XenServer.

Další informace o jednotlivých typech hostitelů najdete v rutině Add-SCVMHost.

Typ:Host
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMTemplate

Určuje objekt šablony VMM použitý k vytvoření virtuálních počítačů.

Typ:Template
Aliasy:Template
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

VirtualNetworkAdapter

Tato rutina vrátí objekt VirtualNetworkAdap ter.

Poznámky

  • Vyžaduje objekt virtuálního počítače VMM, objekt šablony virtuálního počítače nebo objekt profilu hardwaru, který lze načíst pomocí rutin Get-SCVirtualMachine, Get-SCVMTemplatenebo Get-SCHardwareProfile rutin.