This is the built-in help made by Microsoft for the command 'Get-NetFirewallInterfaceTypeFilter', in PowerShell version 3 - as retrieved from
Windows version 'Microsoft Windows Server 2012 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 [<SwitchParameter>]] [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-GPOSession <String>]
[-PolicyStore <String>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-GPOSession <String>] [-InterfaceType
<InterfaceType[]>] [-PolicyStore <String>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-GPOSession <String>] [-PolicyStore <String>]
[-ThrottleLimit <Int32>] -AssociatedNetIPsecRule <CimInstance> [<CommonParameters>]
Get-NetFirewallInterfaceTypeFilter [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-GPOSession <String>] [-PolicyStore <String>]
[-ThrottleLimit <Int32>] -AssociatedNetFirewallRule <CimInstance> [<CommonParameters>]
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.
<
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
<
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.