Test-VMNetworkAdapter
Test-VMNetworkAdapter
Tests connectivity between virtual machines.
Синтаксис
Parameter Set: VMName
Test-VMNetworkAdapter [-VMName] <String> -ReceiverIPAddress <String> -SenderIPAddress <String> -SequenceNumber <Int32> [-ComputerName <String[]> ] [-IsolationId <Int32> ] [-Name <String> ] [-NextHopMacAddress <String> ] [-Passthru] [-Receiver] [-Sender] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ManagementOS
Test-VMNetworkAdapter -ManagementOS -ReceiverIPAddress <String> -SenderIPAddress <String> -SequenceNumber <Int32> [-ComputerName <String[]> ] [-IsolationId <Int32> ] [-Name <String> ] [-NextHopMacAddress <String> ] [-Passthru] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ResourceObject
Test-VMNetworkAdapter [-VMNetworkAdapter] <VMNetworkAdapterBase> -ReceiverIPAddress <String> -SenderIPAddress <String> -SequenceNumber <Int32> [-IsolationId <Int32> ] [-NextHopMacAddress <String> ] [-Passthru] [-Receiver] [-Sender] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMObject
Test-VMNetworkAdapter [-VM] <VirtualMachine> -ReceiverIPAddress <String> -SenderIPAddress <String> -SequenceNumber <Int32> [-IsolationId <Int32> ] [-Name <String> ] [-NextHopMacAddress <String> ] [-Passthru] [-Receiver] [-Sender] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Подробное описание
The Test-VMNetworkAdapter cmdlet tests connectivity between virtual machines by using Internet Control Message Protocol (ICMP) Ping packets. Ping verifies IP-level connectivity to another TCP/IP computer by sending ICMP Echo Request messages.
Параметры
-ComputerName<String[]>
Specifies an array of Hyper-V hosts. The cmdlet tests connectivity for virtual machines hosted by the computers that you specify.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-IsolationId<Int32>
Specifies an ID of a virtual subnet.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-ManagementOS
Indicates that the cmdlet operates on the parent or host operating system.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Name<String>
Specifies the name of the virtual machine.
Псевдонимы |
VMNetworkAdapterName |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-NextHopMacAddress<String>
Specified the MAC address for the next hop VM required for non-HNV (non Hyper-V Network Virtualization) configurations.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Passthru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Receiver
Indicates that the cmdlet targets the receiver virtual machine.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-ReceiverIPAddress<String>
Specifies the IP address of the receiver virtual machine.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Sender
Indicates that the cmdlet targets the sender virtual machine.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-SenderIPAddress<String>
Specifies the IP address of the sender virtual machine.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-SequenceNumber<Int32>
Specifies the sequence number to use to generate ICMP Ping packets. The default value is 100.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-VM<VirtualMachine>
Specifies a virtual machine. The cmdlet tests connectivity for adapters that belong to the virtual machines that you specify.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
1 |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByValue) |
Принимать подстановочные знаки? |
false |
-VMName<String>
Specifies the name of a virtual machine.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
1 |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByValue) |
Принимать подстановочные знаки? |
false |
-VMNetworkAdapter<VMNetworkAdapterBase>
Specifies a virtual machine network adapter as a VMNetworkAdapterBase object. The cmdlet tests connectivity for the adapters that you specify. To obtain a network adapter, use the Get-VMNetworkAdapter cmdlet.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
1 |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByValue) |
Принимать подстановочные знаки? |
false |
-VMNetworkAdapterName<String>
Specifies the name of a virtual network adapter. The cmdlet tests connectivity for the adapters that you specify.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Confirm
Запрос на подтверждение перед выполнением командлета.
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не запущен.
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входные данные
Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.
Выходные данные
Тип выходных данных — это тип объектов, которые выдает командлет.
Примеры
Example 1: Test connectivity
This command tests connectivity by using the virtual network adapter named ContosoNic01. The command targets the receiver virtual machine.
PS C:\> Test-VMNetworkAdapter –VMName "ContosoVM01" –Receiver –SenderIPAddress "10.20.20.5" –ReceiverIPAddress "10.20.20.6" –VMNetworkAdapterName "ContosoNic01"