PowerShell Logo Small

Get-NetFirewallInterfaceTypeFilter



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.

SYNOPSIS

Retrieves interface type filter objects from the target computer.

SYNTAX


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

DESCRIPTION


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.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=280242
Format-Table
Where-Object
Copy-NetIPsecRule
Get-NetFirewallRule
Get-NetIPSecRule
New-NetFirewallRule
New-NetIPsecMainModeRule
New-NetIPSecRule
Open-NetGPO
Save-NetGPO
Set-NetFirewallInterfaceFilter
Set-NetFirewallInterfaceTypeFilter
Set-NetFirewallRule
Set-NetIPSecRule
New-GPO

REMARKS

<

Examples


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.