Add-NetEventVmSwitch

發行項
11/17/2015

Add-NetEventVmSwitch

Adds a Hyper-V virtual switch as a filter on a provider.

語法

Parameter Set: cim:CreateInstance0
Add-NetEventVmSwitch [-Name] <String> [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

詳細描述

The Add-NetEventVmSwitch cmdlet adds a Hyper-V virtual switch as a filter on a Remote Packet Capture provider. Use this cmdlet multiple times to add multiple Hyper-V virtual switches. To get existing Hyper-V virtual switches, use the Get-NetEventVmSwitch cmdlet.

The protocol stack uses multiple layers to transmit, receive, and process network traffic as packets. The provider logs network traffic as Event Tracing for Windows (ETW) events.

參數

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

別名	Session
必要？	false
位置？	named
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Name<String>

Specifies a name for the Hyper-V virtual switch.

別名	none
必要？	true
位置？	1
預設值	none
接受管線輸入？	True (ByPropertyName)
接受萬用字元？	false

-ThrottleLimit<Int32>

指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0 的值，則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet，不適用於工作階段或電腦。

別名	none
必要？	false
位置？	named
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Confirm

執行 Cmdlet 之前先提示您確認。

必要？	false
位置？	named
預設值	false
接受管線輸入？	false
接受萬用字元？	false

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

必要？	false
位置？	named
預設值	false
接受管線輸入？	false
接受萬用字元？	false

<CommonParameters>

此 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

<WorkflowParameters>

此 Cmdlet 支援下列工作流程一般參數：-PSParameterCollection、-PSComputerName、-PSCredential、-PSConnectionRetryCount、-PSConnectionRetryIntervalSec、-PSRunningTimeoutSec、-PSElapsedTimeoutSec、-PSPersist、-PSAuthentication、-PSAuthenticationLevel、-PSApplicationName、-PSPort、-PSUseSSL、-PSConfigurationName、-PSConnectionURI、-PSAllowRedirection、-PSSessionOption、-PSCertificateThumbprint、-PSPrivateMetadata、-AsJob、-JobName 和 –InputObject。如需詳細資訊，請參閱 about_WorkflowCommonParameters。

輸入

輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。

輸出

輸出類型是 Cmdlet 所發出的物件類型。

範例

Example 1: Add a Hyper-V virtual switch on a provider

This example adds a Hyper-V virtual switch as a filter on the Remote Packet Capture provider for a network session. After you complete these commands to configure the network session, you can start and stop the event and packet capture for the network session by using the Start-NetEventSession and Stop-NetEventSession cmdlets.

The first command uses the New-NetEventSession cmdlet to create a network session named NESession01.

The second command uses the Add-NetEventPacketCaptureProvider cmdlet to add a Remote Packet Capture provider for the session named NESession01.

The third command adds a Hyper-V virtual switch as a filter on the Remote Packet Capture provider.

PS C:\> New-NetEventSession -Name "NESession01"
PS C:\> Add-NetEventPacketCaptureProvider -SessionName "NESession01"
PS C:\> Add-NetEventVMSwitch -Name “Network Adapter 2 - Virtual Switch"

共用方式為

Add-NetEventVmSwitch