Add-NetEventNetworkAdapter

Add-NetEventNetworkAdapter

Adds a network adapter as a filter on a provider.

语法

Parameter Set: cim:CreateInstance0
Add-NetEventNetworkAdapter [-Name] <String> [[-PromiscuousMode] <System.Boolean> ] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

详细说明

The Add-NetEventNetworkAdapter cmdlet adds a network adapter as a filter on a Remote Packet Capture provider. The protocol stack uses multiple layers to transmit, receive, and process network traffic, or packets. The provider logs network traffic as Event Tracing for Windows (ETW) events.

Use this cmdlet multiple times to add several adapters. To see which adapters currently belong to a provider, use the Get-NetEventNetworkAdapter cmdlet.

When you add an adapter to provider in a session that is currently running, stop and start the session for your changes to take effect. Use the Stop-NetEventSession cmdlet to stop a session and the Start-NetEventSession cmdlet to restart it.

参数

-CimSession<CimSession[]>

在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。

-Name<String>

Specifies the name of a network adapter to add.

-PromiscuousMode<System.Boolean>

Specifies whether the network adapter uses promiscuous mode. Promiscuous mode starts when the packet capture session starts. When the packet capture session stops, the network adapter is restored to its original setting for promiscuous mode.

This cmdlet supports this parameter for the Windows 8.1 operating system and the Windows Server 2012 R2 operating system only. You must install the hotfix in the topic Promiscuous mode is not set on network adapter to monitor network traffic in Windows Server 2012 R2 (https://support.microsoft.com/en-us/kb/3047154) in the Microsoft Support library.

-ThrottleLimit<Int32>

指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0，那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目，计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet，而不适用于会话或计算机。

-Confirm

运行 cmdlet 之前提示你进行确认。

-WhatIf

显示如果运行 cmdlet 则会发生什么情况。cmdlet 未运行。

<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 network adapter

This example creates a network event session, adds a provider, and then adds a network adapter.

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

The second command adds a provider to the session named Session38 by using the Add-NetEventPacketCaptureProvider cmdlet. A session must have a provider in order to capture packets.

The third command adds a network adapter. After you create and configure the session, use the Start-NetEventSession cmdlet to start capturing packets.

PS C:\> New-NetEventSession -Name "Session38"
PS C:\> Add-NetEventPacketCaptureProvider -SessionName "Session38"
PS C:\> Add-NetEventNetworkAdapter -Name "Ethernet01"

相关主题

Get-NetEventNetworkAdapter

Remove-NetEventNetworkAdapter

New-NetEventSession

Add-NetEventPacketCaptureProvider