< Back

Remove-NetEventVmSwitch

Thu Apr 04, 2019 5:41 am

NAME Remove-NetEventVmSwitch



SYNOPSIS

Removes Hyper-V virtual switches from a provider.





SYNTAX

Remove-NetEventVmSwitch [-CimSession <CimSession[]>] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]

[-InformationVariable <System.String>] [-PassThru] [-ThrottleLimit <Int32>] [<CommonParameters>]



Remove-NetEventVmSwitch [-Name] <String[]> [-CimSession <CimSession[]>] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore

| Suspend}] [-InformationVariable <System.String>] [-PassThru] [-ThrottleLimit <Int32>] [<CommonParameters>]





DESCRIPTION

The Remove-NetEventVmSwitch cmdlet removes Hyper-V virtual switches and the settings for the virtual switches from a Remote Packet Capture

provider. You can specify the names of Hyper-V virtual switches, or use the InputObject parameter to specify a NetEventVmSwitch object to remove.

To obtain a NetEventVmSwitch object, use the Get-NetEventVmSwitch cmdlet. When you remove a Hyper-V virtual switch, the Remote Packet Capture

provider no longer uses the Hyper-V virtual switch to capture event packets.



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.





PARAMETERS

-CimSession [<CimSession[]>]

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession

or Get-CimSession cmdlet. The default is the current session on the local computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InformationAction [<System.Management.Automation.ActionPreference>]

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:



-- SilentlyContinue

-- Stop

-- Continue

-- Inquire

-- Ignore

-- Suspend



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InformationVariable [<System.String>]

Specifies a variable in which to store an information event message.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Name <String[]>

Specifies an array of names of Hyper-V virtual switches to remove.



Required? true

Position? 1

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ThrottleLimit [<Int32>]

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0

is entered, then Windows PowerShell?????? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running

on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS









Example 1: Remove a Hyper-V virtual switch from a provider



PS C:\\>New-NetEventSession -Name "NESession01"

PS C:\\> Add-NetEventPacketCaptureProvider -SessionName "NESession01"

PS C:\\> Add-NetEventVMSwitch -Name "Network Adapter 2 - Virtual Switch"

PS C:\\> Remove-NetEventVMSwitch -Name "Network Adapter 2 - Virtual Switch"



This example removes a Hyper-V virtual switch from the Remote Packet Capture for a network session.



The first command uses New-NetEventSession the creates the 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 uses the Add-NetEventVmSwitch cmdlet to add the Hyper-V virtual switch named Network Adapter 2 - Virtual Switch as a filter on

the Remote Packet Capture provider.



The fourth command removes the Hyper-V virtual switch named Network Adapter 2 - Virtual Switch from the provider.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294401

Get-NetEventVmSwitch

Add-NetEventVmSwitch





CommonParameters : True

WorkflowCommonParameters : False

details : @{name=Remove-NetEventVmSwitchProvider; noun=; verb=}

Syntax : @{syntaxItem=System.Object[]}

parameters : @{parameter=System.Object[]}

inputTypes : @{inputType=}

returnValues : @{returnValue=}

aliases : None



remarks : Get-Help cannot find the Help files for this cmdlet on this computer. It is displaying only partial help.

-- To download and install Help files for the module that includes this cmdlet, use Update-Help.

alertSet :

description :

examples :

Synopsis :

Remove-NetEventVmSwitchProvider [-SessionName] <string[]> [-CimSession <CimSession[]>] [-ThrottleLimit <int>] [-AsJob]

[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]



Remove-NetEventVmSwitchProvider -InputObject <CimInstance#MSFT_NetEventVmSwitchProvider[]> [-CimSession <CimSession[]>]

[-ThrottleLimit <int>] [-AsJob] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]



ModuleName : NetEventPacketCapture

nonTerminatingErrors :

xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10

xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10

xmlns:maml : http://schemas.microsoft.com/maml/2004/10

Name : Remove-NetEventVmSwitchProvider

Category : Function

Component :

Role :

Functionality :