Test-VMNetworkAdapter
Test-VMNetworkAdapter
Tests connectivity between virtual machines.
語法
Parameter Set: VMName
Test-VMNetworkAdapter [-VMName] <String> -ReceiverIPAddress <System.String> -SenderIPAddress <System.String> -SequenceNumber <System.Int32> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-IsolationId <Nullable [System.Int32]> ] [-Name <System.String> ] [-NextHopMacAddress <System.String> ] [-Passthru] [-Receiver] [-Sender] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ResourceObject
Test-VMNetworkAdapter [-VMNetworkAdapter] <VMNetworkAdapter> -ReceiverIPAddress <System.String> -SenderIPAddress <System.String> -SequenceNumber <System.Int32> [-IsolationId <Nullable [System.Int32]> ] [-NextHopMacAddress <System.String> ] [-Passthru] [-Receiver] [-Sender] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMObject
Test-VMNetworkAdapter [-VM] <VirtualMachine> -ReceiverIPAddress <System.String> -SenderIPAddress <System.String> -SequenceNumber <System.Int32> [-IsolationId <Nullable [System.Int32]> ] [-Name <System.String> ] [-NextHopMacAddress <System.String> ] [-Passthru] [-Receiver] [-Sender] [-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.
參數
-CimSession<Microsoft.Management.Infrastructure.CimSession[]>
在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-ComputerName<System.String[]>
Specifies one or more Hyper-V hosts on which this cmdlet operates. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Credential<System.Management.Automation.PSCredential[]>
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-IsolationId<Nullable [System.Int32]>
Specifies the ID of a virtual subnet.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Name<System.String>
Specifies the name of the virtual machine.
別名 |
VMNetworkAdapterName |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-NextHopMacAddress<System.String>
Specified the MAC address for the next hop VM required for non-Hyper-V Network Virtualization configurations.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Passthru
傳回物件，表示您所使用的項目。此 Cmdlet 依預設不會產生任何輸出。
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Receiver
Indicates that the cmdlet targets the receiver virtual machine.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-ReceiverIPAddress<System.String>
Specifies the IP address of the receiver virtual machine.
別名 |
none |
必要項？ |
true |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-Sender
Indicates that the cmdlet targets the sender virtual machine.
別名 |
none |
必要項？ |
false |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-SenderIPAddress<System.String>
Specifies the IP address of the sender virtual machine.
別名 |
none |
必要項？ |
true |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-SequenceNumber<System.Int32>
Specifies the sequence number to use to generate ICMP Ping packets. The default value is 100.
別名 |
none |
必要項？ |
true |
位置？ |
named |
預設值 |
none |
接受管線輸入？ |
false |
接受萬用字元？ |
false |
-VM<VirtualMachine>
Specifies a virtual machine. The cmdlet tests connectivity for adapters that belong to the virtual machines that you specify.
別名 |
none |
必要項？ |
true |
位置？ |
1 |
預設值 |
none |
接受管線輸入？ |
True (ByValue) |
接受萬用字元？ |
false |
-VMName<String>
Specifies the name of a virtual machine.
別名 |
none |
必要項？ |
true |
位置？ |
1 |
預設值 |
none |
接受管線輸入？ |
True (ByValue) |
接受萬用字元？ |
false |
-VMNetworkAdapter<VMNetworkAdapter>
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.
別名 |
none |
必要項？ |
true |
位置？ |
1 |
預設值 |
none |
接受管線輸入？ |
True (ByValue) |
接受萬用字元？ |
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"