Udostępnij za pośrednictwem

Get-SCVirtualNetworkAdapter

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera obiekty wirtualnej karty sieciowej programu VMM z maszyny wirtualnej, szablonu maszyny wirtualnej lub profilu sprzętowego.

Składnia

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>]

Opis

Polecenie cmdlet Get-SCVirtualNetworkAdapter pobiera co najmniej jeden obiekt wirtualnej karty sieciowej z obiektu maszyny wirtualnej, obiektu szablonu maszyny wirtualnej lub obiektu profilu sprzętowego w środowisku programu Virtual Machine Manager (VMM).

Przykłady

Przykład 1. Pobieranie wirtualnych kart sieciowych z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej na maszynie wirtualnej VM01 i wyświetla informacje o kartach użytkownika.

Przykład 2. Pobieranie wirtualnych kart sieciowych z szablonu maszyny wirtualnej

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

Pierwsze polecenie pobiera wszystkie obiekty szablonu maszyny wirtualnej z biblioteki programu VMM, wybiera obiekt szablonu o nazwie VMTemplate01 i przechowuje obiekt w zmiennej $VMTemplate.

Ostatnie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej VMTemplate01 i wyświetla informacje o tych kartach użytkownikowi.

Przykład 3. Pobieranie wirtualnych kart sieciowych z profilu sprzętowego

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

Pierwsze polecenie pobiera wszystkie obiekty profilu sprzętowego w bibliotece programu VMM, wybiera obiekt profilu o nazwie NewHWProfile01, a następnie przechowuje obiekt w zmiennej $HWProfile.

Drugie polecenie pobiera wszystkie obiekty wirtualnej karty sieciowej NewHWProfile01 i wyświetla informacje o tych kartach użytkownikowi.

Parametry

-All

Wskazuje, że to polecenie cmdlet pobiera wszystkie obiekty podrzędne niezależnie od obiektu nadrzędnego.

Na przykład polecenie Get-SCVirtualDiskDrive -All pobiera wszystkie obiekty dysku wirtualnego niezależnie od obiektu maszyny wirtualnej lub obiektu szablonu, z którymi jest skojarzony każdy obiekt dysku wirtualnego.

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

-HardwareProfile

Określa obiekt profilu sprzętowego.

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

-ID

Określa identyfikator liczbowy jako globalnie unikatowy identyfikator lub identyfikator GUID dla określonego obiektu.

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

-Name

Określa nazwę obiektu sieciowego.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika określonego przez ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

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

-ParentTypeVMOrHost

Wskazuje, że typem nadrzędnym jest maszyna wirtualna lub host.

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

-VM

Określa obiekt maszyny wirtualnej.

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

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty funkcji Hyper-V, hosty VMware ESX i hosty Citrix XenServer.

Aby uzyskać więcej informacji na temat każdego typu hosta, zobacz polecenie cmdlet Add-SCVMHost .

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

-VMMServer

Określa obiekt serwera programu VMM.

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

-VMTemplate

Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.

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

Dane wyjściowe

VirtualNetworkAdapter

To polecenie cmdlet zwraca obiekt VirtualNetworkAdapter .

Uwagi

  • Wymaga obiektu maszyny wirtualnej programu VMM, obiektu szablonu maszyny wirtualnej lub obiektu profilu sprzętu, który można pobrać przy użyciu odpowiednio poleceń cmdlet Get-SCVirtualMachine, Get-SCVMTemplate lub Get-SCHardwareProfile .