PowerShell Logo Small


This is the built-in help made by Microsoft for the command 'Get-NetFirewallInterfaceTypeFilter', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.


Retrieves interface type filter objects from the target computer.


Get-NetFirewallInterfaceTypeFilter [-All] [-AsJob] [-CimSession <CimSession[]>] [-GPOSession <String>] [-PolicyStore <String>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob] [-CimSession <CimSession[]>] [-GPOSession <String>] [-PolicyStore <String>] [-ThrottleLimit <Int32>] -AssociatedNetIPsecRule
<CimInstance> [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob] [-CimSession <CimSession[]>] [-GPOSession <String>] [-PolicyStore <String>] [-ThrottleLimit <Int32>] -AssociatedNetFirewallRule
<CimInstance> [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob] [-CimSession <CimSession[]>] [-GPOSession <String>] [-InterfaceType <InterfaceType[]>] [-PolicyStore <String>] [-ThrottleLimit
<Int32>] [<CommonParameters>]

Search powershellhelp.space


The Get-NetFirewallInterfaceTypeFilter cmdlet returns the interface type filter objects with the input rules.

Interface type filter objects represent the interface types associated with firewall and IPsec rules. The InterfaceType parameter of a single rule is represented in a
separate NetFirewallInterfaceTypeFilter object. The filter to rule relationship is always one-to-one and is managed automatically. Rule parameters associated with filters
can only be queried using filter objects.

This cmdlet displays the interface types associated with firewall and IPsec rules. This allows for rule querying based on the InterfaceType parameter value; this cmdlet
returns filter objects that may be further queried with the Where-Object cmdlet. This cmdlet also allows the interface type filters to be obtained by InterfaceType query.
The resultant filters are passed into the Get-NetFirewallRule or Get-NetIPsecRule cmdlet to return the rules queried by interface type.

To modify the interface type conditions, two methods can be used starting with the interface type filters returned by this cmdlet and optional additional querying.

The array of NetFirewallInterfaceTypeFilter objects can be piped into the Get-NetFirewallRule or Get-NetIPsecrule cmdlet, which returns the rules associated with the
filters. These rules are then piped into the Set-NetFirewallRule or Set-NetIPsecrule cmdlet where the interface properties can be configured.

Alternatively, piping the array of NetFirewallInterfaceTypeFilter objects directly into the Set-NetFirewallInterfaceTypeFilter cmdlet allows the InterfaceType parameter of
the rules to be modified.



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




Example 1

PS C:\>Get-NetFirewallInterfaceTypeFilter -PolicyStore ActiveStore

This cmdlet shows the same information in a dynamically-sized, formatted table.
PS C:\>Get-NetFirewallInterfaceTypeFilter -PolicyStore ActiveStore | Format-Table

This example retrieves the interface types associated with all the rules in the active store. Note: Running this cmdlet without specifying the policy store retrieves the
persistent store.

Example 2

PS C:\>Get-NetFirewallRule –DisplayName "Contoso Messenger" | Get-NetFirewallInterfaceTypeFilter

This example gets the interface aliases associated with a particular firewall rule.

Example 3

PS C:\>Get-FirewallRule –DisplayName "Contoso Messenger" | Get-NetFirewallInterfaceTypeFilter | Set-NetFirewallInterfaceTypeFilter –InterfaceType Any

This cmdlet is an alternate method of performing the task.
PS C:\>Set-NetFirewallRule –DisplayName "Contoso Messenger" –InterfaceType Any

This example modifies the interface type field of a particular firewall rule.

Example 4

PS C:\>Get-NetFirewallInterfaceTypeFilter –InterfaceType Wired | Set-NetFirewallInterfaceTypeFilter –InterfaceType Any

This example modifies the interface type for all of the rules previously associated with the wired interface type.

Example 5

PS C:\>Get-NetIPsecRule –Group DirectAccess | Get-NetFirewallInterfaceTypeFilter | Where-Object –Property { $_.InterfaceType –Eq "Wired" } |
Set-NetFirewallInterfaceTypeFilter –InterfaceType RemoteAccess

This example modifies the interface type associated with all of the IPsec rules in a specified group.