Export (0) Print
Expand All

Get-NetIPv6Protocol

Applies To: Windows Server 2012

Get-NetIPv6Protocol

Gets information about the IPv6 protocol configuration.

Syntax

Parameter Set: ByName
Get-NetIPv6Protocol [-AddressMaskReply <AddressMaskReply[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-DefaultHopLimit <UInt32[]> ] [-DhcpMediaSense <DhcpMediaSense[]> ] [-GroupForwardedFragments <GroupForwardedFragments[]> ] [-IcmpRedirects <IcmpRedirects[]> ] [-MaxDadAttempts <UInt32[]> ] [-MaxPreferredLifetime <TimeSpan[]> ] [-MaxRandomTime <TimeSpan[]> ] [-MaxValidLifetime <TimeSpan[]> ] [-MediaSenseEventLog <MediaSenseEventLog[]> ] [-MldLevel <MldLevel[]> ] [-MldVersion <MldVersion[]> ] [-MulticastForwarding <MulticastForwarding[]> ] [-NeighborCacheLimitEntries <UInt32[]> ] [-RandomizeIdentifiers <RandomizeIdentifiers[]> ] [-ReassemblyLimitBytes <UInt32[]> ] [-RegenerateTime <TimeSpan[]> ] [-RouteCacheLimitEntries <UInt32[]> ] [-SourceRoutingBehavior <SourceRoutingBehavior[]> ] [-ThrottleLimit <Int32> ] [-UseTemporaryAddresses <UseTemporaryAddresses[]> ] [ <CommonParameters>]




Detailed Description

The Get-NetIPv6Protocol cmdlet gets the global IPv6 protocol configuration for the computer. This includes parameters such as the default hop limit, the neighbor cache limit, and multicast configuration.

Parameters

-AddressMaskReply<AddressMaskReply[]>

Gets IPv6 protocol configuration by the AddressMaskReply. AddressMaskReply indicates whether the computer will respond to ICMP Address mask packets. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the AddressMaskReply set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the AddressMaskReply set to Disabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. The cmdlet immediately returns an object that represents the job and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the *-Job cmdlets. To get the job results, use the Receive-Job cmdlet. For more information about Windows PowerShell® background jobs, see about_Jobs.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DefaultHopLimit<UInt32[]>

Gets IPv6 protocol configuration by the DefaultHopLimit. DefaultHopLimit sets the default value for the CurrentHopLimit property in NetIPInterface. The CurrentHopLimit is the value that the IP interface writes in the hop limit field in all outbound IPv6 traffic. When forwarding a packet, routers are required to decrease the Hop Limit by 1 and to discard the packet when the Hop Limit is 0.
The default value is 128.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DhcpMediaSense<DhcpMediaSense[]>

Gets IPv6 protocol configuration by the DHCPMediaSense. DHCP Media Sense provides a mechanism for the network interface card (NIC) to notify the protocol stack of media connect and disconnect events. These events trigger the DHCP client to take some action, such as attempting to renew a DHCP lease or removing routes related to a disconnected network. One use of Media Sense enables the network parameters on the notebook computer of a roaming user to automatically and transparently update without rebooting when the user moves from one location to another. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the DhcpMediaSense set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the DhcpMediaSense set to Disabled.
The default value is Enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-GroupForwardedFragments<GroupForwardedFragments[]>

Gets IPv6 protocol configuration by the GroupForwardedFragments. GroupForwardedFragments determines whether fragments should be collected into groups before being forwarded. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the GroupForwardedFragments set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the GroupForwardedFragments set to Disabled.
The default value is Disabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-IcmpRedirects<IcmpRedirects[]>

Gets IPv6 protocol configuration by the IcmpRedirects. IcmpRedirects determine whether the path cache is updated in response to ICMP redirect packets. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the IcmpRedirects set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the IcmpRedirects set to Disabled.
The default value is Enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaxDadAttempts<UInt32[]>

Gets IPv6 protocol configuration by the number of MaxDadAttempts. MaxDadAttempts determines the number of duplicate address detection attempts. The default value is 5.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaxPreferredLifetime<TimeSpan[]>

Gets IPv6 protocol configuration by MaxPreferredLifetime. MaxPreferredLifetime determines the maximum lifetime over which a temporary address is preferred. MaxPreferredLifetime uses time as defined by the TimeSpan structure.
The default value is 1 day.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaxRandomTime<TimeSpan[]>

Gets IPv6 protocol configuration by MaxRandomTime. MaxRandomTime determines the upper bound to use when computing a random delay at startup time. MaxRandomTime uses time as defined by the TimeSpan structure.
The default value is 10 minutes.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaxValidLifetime<TimeSpan[]>

Gets IPv6 protocol configuration by MaxValidLifetime. MaxValidLifetime determines the Maximum lifetime over which a temporary address is valid. MaxValidLifetime uses time as defined by the TimeSpan structure.
The default value is 7 days.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MediaSenseEventLog<MediaSenseEventLog[]>

Gets IPv6 protocol configuration by the MediaSenseEventLog. MediaSenseEventLog determines if the computer logs DHCP Media Sense events.
When enabled, Media Sense events (connection/disconnection from the network) are logged in the event log for troubleshooting purposes. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the MediaSenseEventLog set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the MediaSenseEventLog set to Disabled.
The default value is Disabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MldLevel<MldLevel[]>

Gets IPv6 protocol configuration by the MLDLevel. MLDLevel determines the level of multicast support. MLDLevel may determine (None) that multicast packets can neither be sent nor received; (SendOnly) the multicast packets can be sent but not received; or (All) multicast packets can be sent and received. The acceptable values for this parameter are: 
-- None: IPv6 protocol configuration that contains the MLDLevel set to None.
-- SendOnly: IPv6 protocol configuration that contains the MLDLevel set to SendOnly.
-- All: IPv6 protocol configuration that contains the MLDLevel set to All.
The default value is All.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MldVersion<MldVersion[]>

Gets IPv6 protocol configuration by the MLDVersion number. The MLDVersion shows the maximum MLD version supported by the host.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MulticastForwarding<MulticastForwarding[]>

Gets IPv6 protocol configuration by the MulticastForwarding. MulticastForwarding determines whether multicast packets can be forwarded. The acceptable values for this parameter are: 
-- Enabled: IPv6 protocol configuration that contains the MulticastForwarding set to Enabled.
-- Disabled: IPv6 protocol configuration that contains the MulticastForwarding set to Disabled.
The default value is Disabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NeighborCacheLimitEntries<UInt32[]>

Gets IPv6 protocol configuration by the number of NeighborCacheLimitEntries. NeighborCacheLimitEntries determines the maximum number of neighbor cache entries.
The default is 256.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RandomizeIdentifiers<RandomizeIdentifiers[]>

Gets IPv6 protocol configuration by the RandomizeIdentifiers. RandomizeIdentifiers determines whether interface identifiers are randomized. The acceptable values for this parameter are: 
-- Enabled: IPv4 protocol configuration that contains the RandomizeIdentifiers set to Enabled.
-- Disabled: IPv4 protocol configuration that contains the RandomizeIdentifiers set to Disabled.
The default is Enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReassemblyLimitBytes<UInt32[]>

Gets IPv6 protocol configuration by ReassemblyLimitBytes. ReassemblyLimitBytes determines the maximum size of the reassembly buffer.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RegenerateTime<TimeSpan[]>

Gets IPv6 protocol configuration by RegenerateTime. RegenerateTime determines Time prior to deprecating a temporary address when a new address is generated. RegenerateTime uses time as defined by the TimeSpan structure.
The default value is 5 seconds.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RouteCacheLimitEntries<UInt32[]>

Gets IPv6 protocol configuration by the number of RouteCacheLimitEntries. RouteCacheLimitEntries determines the maximum number of route cache entries.
The default value is 128.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SourceRoutingBehavior<SourceRoutingBehavior[]>

Gets IPv6 protocol configuration by the SourceRoutingBehavior. SourceRoutingBehavior determines the behavior for source routed packets. (DontForward) source routed packets can be received but not forwarded. DontForward is the default setting. (Drop) source routed packets will be dropped. (Forward) Per RFC 5095 support for forwarding of source routed IPv6 packets has been removed, and the Forward setting now has the same effect as DontForward. The acceptable values for this parameter are: 
-- DontForward: IPv6 protocol configuration that contains the SourceRoutingBehavior set to DontForward.
-- Drop: IPv6 protocol configuration that contains the SourceRoutingBehavior set to Drop.


Aliases

none

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UseTemporaryAddresses<UseTemporaryAddresses[]>

Gets IPv6 protocol configuration by the UseTemporaryAddresses. UseTemporaryAddresses determines whether temporary addresses are enabled. Temporary addresses are described in RFC 3041. UseTemporary address may be set to (Disabled) don’t use temporary addresses; (Enabled) use temporary addresses; (Always) Always generate random numbers; (Counter) Generate temporary addresses with the interface identifier. The acceptable values for this parameter are: 
-- Disabled: IPv6 protocol configuration that contains the UseTemporaryAddresses set to Disabled.
-- Enabled: IPv6 protocol configuration that contains the UseTemporaryAddresses set to Enabled.
-- Always: IPv6 protocol configuration that contains the UseTemporaryAddresses set to Always.
-- Counter: IPv6 protocol configuration that contains the UseTemporaryAddresses set to Counter. Typically used for for test purposes.


Aliases

none

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, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetIPv6Protocol

    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.


Examples

EXAMPLE 1

This example gets information about IPv6 protocol configuration.


 

PS C:\> Get-NetIPv6Protocol

 

The default output omits some properties. Run the cmdlet to display all fields (all properties of the object).


PS C:\> Get-NetIPv6Protocol | Format-List -Property *

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft