Set-NetIPInterface
Modifies IP interface properties.
Syntax
Set-NetIPInterface
[[-InterfaceAlias] <String[]>]
[-AddressFamily <AddressFamily[]>]
[-AdvertiseDefaultRoute <AdvertiseDefaultRoute>]
[-AdvertisedRouterLifetime <TimeSpan>]
[-Advertising <Advertising>]
[-AsJob]
[-AutomaticMetric <AutomaticMetric>]
[-BaseReachableTimeMs <UInt32>]
[-CimSession <CimSession[]>]
[-CurrentHopLimit <UInt32>]
[-DadTransmits <UInt32>]
[-Dhcp <Dhcp>]
[-DirectedMacWolPattern <DirectedMacWolPattern>]
[-EcnMarking <EcnMarking>]
[-ForceArpNdWolPattern <ForceArpNdWolPattern>]
[-Forwarding <Forwarding>]
[-IgnoreDefaultRoutes <IgnoreDefaultRoutes>]
[-InterfaceIndex <UInt32[]>]
[-InterfaceMetric <UInt32>]
[-ManagedAddressConfiguration <ManagedAddressConfiguration>]
[-NeighborDiscoverySupported <NeighborDiscoverySupported[]>]
[-NeighborUnreachabilityDetection <NeighborUnreachabilityDetection>]
[-NlMtuBytes <UInt32>]
[-OtherStatefulConfiguration <OtherStatefulConfiguration>]
[-PassThru]
[-PolicyStore <String>]
[-ReachableTime <UInt32[]>]
[-RetransmitTimeMs <UInt32>]
[-RouterDiscovery <RouterDiscovery>]
[-ThrottleLimit <Int32>]
[-WeakHostReceive <WeakHostReceive>]
[-WeakHostSend <WeakHostSend>]
[-Confirm]
[-WhatIf]
Set-NetIPInterface
[-AdvertiseDefaultRoute <AdvertiseDefaultRoute>]
[-AdvertisedRouterLifetime <TimeSpan>]
[-Advertising <Advertising>]
[-AsJob]
[-AutomaticMetric <AutomaticMetric>]
[-BaseReachableTimeMs <UInt32>]
[-CimSession <CimSession[]>]
[-CurrentHopLimit <UInt32>]
[-DadTransmits <UInt32>]
[-Dhcp <Dhcp>]
[-DirectedMacWolPattern <DirectedMacWolPattern>]
[-EcnMarking <EcnMarking>]
[-ForceArpNdWolPattern <ForceArpNdWolPattern>]
[-Forwarding <Forwarding>]
[-IgnoreDefaultRoutes <IgnoreDefaultRoutes>]
[-InterfaceMetric <UInt32>]
[-ManagedAddressConfiguration <ManagedAddressConfiguration>]
[-NeighborUnreachabilityDetection <NeighborUnreachabilityDetection>]
[-NlMtuBytes <UInt32>]
[-OtherStatefulConfiguration <OtherStatefulConfiguration>]
[-PassThru]
[-RetransmitTimeMs <UInt32>]
[-RouterDiscovery <RouterDiscovery>]
[-ThrottleLimit <Int32>]
[-WeakHostReceive <WeakHostReceive>]
[-WeakHostSend <WeakHostSend>]
-InputObject <CimInstance[]>
[-Confirm]
[-WhatIf]
Description
The Set-NetIPInterface cmdlet modifies IP interface properties such as is DHCP, IPv6 neighbor discovery settings, router settings and Wake on LAN (WoL) settings. The NetIPInterface object is automatically created by the computer and thus the NetIPInterface object has no New or Remove verbs.
Without identifier parameters, this cmdlet sets all of the IP interface properties on the computer, including virtual interfaces and loopback interfaces.
Examples
EXAMPLE 1
PS C:\>Set-NetIPInterface -InterfaceIndex 12 -Dhcp Disabled
This example gets information IP interface object for the InterfaceIndex 12 and disabled DHCP on it.
EXAMPLE 2
PS C:\>Set-NetIPInterface -AddressFamily IPv6
This example gets information about IP interface configuration for all of the IP interfaces that have IPv6 addresses configured.
EXAMPLE 3
PS C:\>Get-NetAdapter | Where-Object -FilterScript {$_.LinkSpeed -Eq "100 Mbps"} | Set-NetIPInterface -InterfaceMetric 21
This example gets all of the network adapters on the computer with a link speed of 100 Mbps and sets the interface metric on them to 21.
Parameters
-AddressFamily
Specifies the IP address family of the IP interface. The acceptable values for this parameter are:
-- IPv4: IP Interface properties for interfaces with IPv4 addresses.
-- IPv6: IP Interface properties for interfaces with IPv6 addresses.
Type: | AddressFamily[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdvertiseDefaultRoute
Modifies the IP interface advertise default route property. This parameter value indicates whether the IP interface should advertise itself as a default router regardless of whether the node has a default route itself. Valid only for advertising interfaces. The acceptable values for this parameter are:
-- Enabled: The IP interface advertises itself as the default router.
-- Disabled: The IP interface does not advertise itself as the default router.
Type: | AdvertiseDefaultRoute |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdvertisedRouterLifetime
Modifies IP interface advertised router lifetime property.
This parameter value indicates the lifetime of default routes when advertising routes on the IP interface, in seconds.
The default value is 1800
.
Valid only for advertising interfaces.
AdvertisedRouterLifetime uses time as defined by the TimeSpanhttp://msdn.microsoft.com/library/system.timespan.aspx structure.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Advertising
Modifies IP interface properties only for interfaces that send or do not send Router Advertisements. By default, interface properties have advertising set to Disabled. The acceptable values for this parameter are:
-- Enabled: IP Interface is enabled to send Router Advertisements.
-- Disabled: IP Interface has Router Advertisements disabled.
Type: | Advertising |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
ps_cimcommon_asjob
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutomaticMetric
Modifies the automatic metric property. This parameter value determines whether TCP/IP automatically calculates a value for an interface metric that is based on the speed of the interface. The highest-speed interface has the lowest interface metric value. The acceptable values for this parameter are:
-- Enabled: TCP/IP automatically calculates a value for an InterfaceMetric that is based on the speed of the interface.
-- Disabled: TCP/IP uses the manual setting for InterfaceMetric.
Type: | AutomaticMetric |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BaseReachableTimeMs
Modifies the BaseReachableTime property. BaseReachableTime is the base for random reachable time, in milliseconds. This parameter is described in RFC 2461http://go.microsoft.com/fwlink/p/?LinkId=84044.
The default value is 30.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227967 or Get-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227966 cmdlet. The default is the current session on the local computer.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CurrentHopLimit
Modifies the current hop limit property. This parameter value is the value that the IP interface writes in the hop limit (for IPv6) or TTL (for IPv4) field in all outbound traffic. When forwarding a packet, routers are required to decrease the Hop Limit or TTL by 1 and to discard the packet when the Hop Limit or TTL is 0. The default is defined as DefaultHopLimit in the NetIPv4Protocol and NetIPv6Protocol objects. When this parameter value is set to 0, it uses this default.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DadTransmits
Modifies the dad transmits property. This parameter value is the number of duplicate address detection transmits.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dhcp
Modifies the enabled state for the IP interface of the Dynamic Host Configuration Protocol (DHCP). Note: This setting is persistent across reboots and only stored in the active policy store.
Changes to the persistent store will have no effect. The acceptable values for this parameter are:
-- Enabled: IP Interface properties for interfaces that have DHCP enabled.
-- Disabled: IP Interface properties for interfaces that have DHCP disabled.
The default value is Enabled.
Type: | Dhcp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DirectedMacWolPattern
Modifies the directed MAC WoL pattern. This parameter value determines if an IP interface is configured to wake up a computer with directed MAC packet patterns. By default, IP interface properties have this parameter value set to Disabled. The acceptable values for this parameter are:
-- Enabled: IP Interface properties for interfaces that have DirectedMacWolPattern enabled.
-- Disabled: IP Interface properties for interfaces that have DirectedMacWolPattern disabled.
Type: | DirectedMacWolPattern |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EcnMarking
Modifies the ECN marking value. This parameter value controls the specific ECN marking in the ECN field of the IP header. The acceptable values for this parameter are:
-- AppDecide: Allow an application or higher layer such as TCP to decide how to apply ECN marking. In order for an application to fully control ECN capability value in the Network TCP setting must also be set to Enabled.
-- Disabled: Disable the ECN marking on the IP interface.
-- UseEct0: Mark all of the egress IP packets on the IP interface with the Ect0 bit set.
-- UseEct1: Mark all of the egress IP packets on the IP interface with the Ect1 bit set.
The default value is AppDecide.
Type: | EcnMarking |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceArpNdWolPattern
Modifies the force ARP ND WoL pattern parameter. This parameter value determines if an IP interface is configured to wake up a computer with Address Resolution Protocol (ARP) and Neighbor Discovery (ND) packet patterns. By default, IP interface properties have this parameter value set to Disabled. The acceptable values for this parameter are:
-- Enabled: IP Interface properties for interfaces that have ForceArpNdWolPattern enabled.
-- Disabled: IP Interface properties for interfaces that have ForceArpNdWolPattern disabled.
Type: | ForceArpNdWolPattern |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Forwarding
Modifies the forwarding property. The acceptable values for this parameter are:
-- Enabled: Packets arriving on this IP interface can be forwarded to other interfaces.
-- Disabled: Packets arriving on this IP interface cannot be forwarded to other interfaces.
Type: | Forwarding |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IgnoreDefaultRoutes
Modifies the ignore default routes property. The acceptable values for this parameter are:
-- Enabled: Ensures that default routes will not be dynamically added to the routing table.
-- Disabled: Allows default routes to be dynamically added to the routing table. This is the default.
Type: | IgnoreDefaultRoutes |
Position: | Named |
Default value: | Disabled |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.
Type: | CimInstance[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InterfaceAlias
Specifies the IP interface properties by interface, as defined by the InterfaceAlias property.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InterfaceIndex
Specifies the IP interface properties by interface, as defined by the InterfaceIndex number property.
Type: | UInt32[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InterfaceMetric
Modifies the interface metric property. When routes are chosen, the overall metric used to determine the preference is the sum of the route metric and the interface metric. Typically, the interface metric gives preference to a particular interface, such as using wired if both wired and wireless are available. This parameter value uses the value generated by AutomaticMetric by default. If this parameter value is set, then AutomaticMetric is automatically disabled.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagedAddressConfiguration
Modifies the managed address configuration property. This parameter value determines if an IP interface uses a stateful protocol (such as DHCP) to obtain an address. Setting this parameter will have no effect on an interface that has router discovery enabled and advertising disabled. In that case the parameter is controlled by router discovery. The acceptable values for this parameter are:
-- Enabled: The IP interface uses a stateful protocol (such as DHCP) to obtain an address.
-- Disabled: The IP interface does not use a stateful protocol (such as DHCP) to obtain an address.
Type: | ManagedAddressConfiguration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NeighborDiscoverySupported
Specifies the neighbor discovery supported property of the IP interface. This parameter value specifies if the IP interface supports neighbor discovery. The acceptable values for this parameter are:
-- Enabled: IP Interface properties for interfaces that have NeighborDiscoverySupported enabled.
-- Disabled: IP Interface properties for interfaces that have NeighborDiscoverySupported disabled.
Type: | NeighborDiscoverySupported[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NeighborUnreachabilityDetection
Modifies the neighbor unreachablility detection (NUD) property. NUD is how nodes determine that a neighbor is no longer reachable. Default depends on type of interface. This parameter is described in RFC 2461http://go.microsoft.com/fwlink/p/?LinkId=84044. Note For the ActiveStore, the NUD modification is allowed only from Disabled to Enabled state, but modifying NUD from Enabled to Disabled for ActiveStore fails with Invalid Parameter. For the PersistentStore, the NUD can be modified to either Enabled or Disabled. But the interface will need to be restarted for the setting to take effect. The acceptable values for this parameter are:
-- Enabled: NeighborUnreachabilityDetection is enabled.
-- Disabled: NeighborUnreachabilityDetection is disabled.
Type: | NeighborUnreachabilityDetection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NlMtuBytes
Modifies the Network Layer MTU (NlMtu) property. This parameter value is the network layer Maximum Transmission Unit, in bytes. For IPv4 the minimum value is 576 bytes. For IPv6 the minimum is value is 1280 bytes. For both IPv4 and IPv6, the maximum value is 2^32-1 (4294967295). Values outside these ranges will not be set. If this parameter is set to 0, then it will remain unchanged and maintain its current value. The IP interface will not transmit packets larger than NlMtuBytes.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OtherStatefulConfiguration
Modifies the other stateful property. This parameter value determines if an IP interface uses a stateful protocol (such as DHCP) to obtain configuration information other than addresses. Setting this parameter will have no effect on an interface that has router discovery enabled and advertising disabled. In that case the parameter is controlled by router discovery. The acceptable values for this parameter are:
-- Enabled: The IP interface uses a stateful protocol (such as DHCP) to obtain configuration information other than addresses.
-- Disabled: The IP Interface does not a stateful protocol (such as DHCP) to obtain configuration information other than addresses.
Type: | OtherStatefulConfiguration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PolicyStore
Specifies the PolicyStore value. The acceptable values for this parameter are:
-- ActiveStore: The IP address information is currently valid.
-- PersistentStore: The IP address information is persistent across reboots. When the computer starts, the PersistentStore settings are copied to the ActiveStore.
The default value is ActiveStore.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReachableTime
Specifies the base reachable time property of the IP interface. This parameter value is the time, in milliseconds, that a node assumes that a neighbor is reachable after having received a reachability confirmation. Used by neighbor unreachability detection.
Type: | UInt32[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetransmitTimeMs
Modifies the retransmit time.
This parameter value defines the timeout and retransmission of Neighbor Solicitation messages, in milliseconds.
This parameter is described as RetransTimer in RFC 2461http://go.microsoft.com/fwlink/p/?LinkId=84044.
The default value is 1000
.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RouterDiscovery
Modifies the router discovery property. By default, interface properties have router discovery controlled by DHCP for IPv4 and Enabled for IPv6. The acceptable values for this parameter are:
-- ControlledByDHCP: DHCP determines if the IP Interface can be used by the computer to locate routers that reside on an attached link.
-- Disabled: IP Interface will not be used by the computer to locate routers that reside on an attached link.
-- Enabled: IP Interface can be used by the computer to locate routers that reside on an attached link.
Type: | RouterDiscovery |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
ps_cimcommon_throttlelimit
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WeakHostReceive
Modifies the weak host receive property. By default, interface properties have this parameter value set to disabled. The acceptable values for this parameter are:
-- Enabled: A computer can receive IP packets on the IP interface that is not assigned the destination IP address of the packet being received.
-- Disabled: A computer cannot receive IP packets on the IP interface that is not assigned the destination IP address of the packet being received.
Type: | WeakHostReceive |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WeakHostSend
Modifies the weak host send property. By default, interface properties have this parameter value set to disabled. The acceptable values for this parameter are:
-- Enabled: A computer can send IP packets on an interface that is not assigned the destination IP address of the packet being sent.
-- Disabled: A computer cannot send IP packets on an interface that is not assigned the destination IP address of the packet being sent.
Type: | WeakHostSend |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
The Microsoft.Management.Infrastructure.CimInstance
object is a wrapper class that displays Windows Management Instrumentation (WMI) objects.
The path after the pound sign (#
) provides the namespace and class name for the underlying WMI object.
Outputs
None