Export (0) Print
Expand All

New-PefTimeSpanTrigger

Windows Server 2012 R2 and Windows 8.1

Updated: September 10, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

New-PefTimeSpanTrigger

Creates a trigger that signals after the specified time span.

Syntax

Parameter Set: Default
New-PefTimeSpanTrigger [-TimeSpan] <TimeSpan> [-Repeat] [ <CommonParameters>]




Detailed Description

The New-PefTimeSpanTrigger cmdlet creates a trigger that signals after a specified time span. You can use a timer trigger to start or stop a Protocol Engineering Framework (PEF) Trace Session after a specified time interval elapses. The trigger becomes active when you associate it to a PEF action.

Parameters

-Repeat

Indicates that the trigger runs on each occurrence of a time-span interval that you specify. If you do not specify this parameter, the trigger runs only once.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TimeSpan<TimeSpan>

Specifies the amount of time before the server fires the trigger.


Aliases

none

Required?

true

Position?

1

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.

Outputs

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

Examples

Example 1: Add a Trace Filter by using a time span trigger

This example adds a Trace Filter to a Trace Session after a period of 150 seconds expires.

The first command uses the New-PefTraceSession cmdlet to create a PEF Trace Session object and stores it in the $TraceSession01 variable.

The second command uses the current cmdlet to create a trigger with a TimeSpan value of 150 seconds. The command stores the trigger in the $Trigger01 variable. To specify the TimeSpan value, type Get-Help New-TimeSpan to learn how to use the New-TimeSpan cmdlet.

The third command uses the Set-PefTraceFilter to set a Trace Filter with the string value “icmp” for the Trace Session object that is stored in the $TraceSession01 variable. This command specifies the trigger stored in the $Trigger01 variable, which causes the specified Trace Filter to be applied to the Trace Session message retrieval action 150 seconds after the session starts.

The fourth command uses the Add-PefMessageSource cmdlet to specify a message provider for the Trace Session object stored in the $TraceSession01 variable.

The final command uses the Start-PefTraceSession cmdlet to start the Trace Session stored in the $TraceSession01 variable.


PS C:\> $TraceSession01 = New-PefTraceSession -Mode Circular
PS C:\> $Trigger01 = New-PefTimeSpanTrigger -TimeSpan (New-TimeSpan -Seconds 150)
PS C:\> Set-PefTraceFilter -PEFSession $TraceSession01 -Filter "icmp" -Trigger $Trigger01
PS C:\> Add-PefMessageSource -Session $TraceSession01 –Source "Microsoft-PEF-NDIS-PacketCapture"
PS C:\> Start-PefTraceSession –PEFSession $TraceSession01

Related topics

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