New-PefDateTimeTrigger
New-PefDateTimeTrigger
Creates a trigger that signals at the specified time.
Syntax
Parameter Set: Default
New-PefDateTimeTrigger [-DateTime] <DateTime> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Repeat] [ <CommonParameters>]
Detaillierte Beschreibung
The New-PefDateTimeTrigger cmdlet creates a trigger that signals at the specified time. You can use a date-time trigger to start or stop a Protocol Engineering Framework (PEF) Trace Session, or trigger other actions, on the date and time that you specify. The trigger becomes active when you associate it to a PEF action.
Parameter
-DateTime<DateTime>
Specifies a DateTime object.
Aliasse |
none |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Die folgenden Werte für diesen Parameter sind zulässig:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Aliasse |
infa |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Aliasse |
iv |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Repeat
Indicates that the trigger runs on each occurrence of the date and time that you specify. If you do not specify this parameter, the trigger runs only once.
Aliasse |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
Beispiele
Example 1: Add a Trace Filter by using a date-time trigger
This example adds a Trace Filter to a Trace Session at 3am on January 31, 2013. The first command uses the New-PefTraceSession cmdlet to create a PEF Trace Session object and store it in the $TraceSession01 variable.
The second command uses the Get-Date cmdlet to create a DateTime object, and then stores in in the $TriggerTime variable. For more information, type Get-Help Get-Date
. You can specify a future time, but no more than 25 days in the future.
The third command uses the New-PefDateTimeTrigger cmdlet to create a trigger with the DateTime value that is stored in the $TriggerTime variable. The command stores the trigger in the $Trigger02 variable.
The fourth command uses the Set-PefTraceFilter to specify a Trace Filter with the string value "icmp" for the Trace Session stored in the $TraceSession01 variable. This command also specifies the trigger stored in the $Trigger02 variable, which adds the specified Trace Filter to the Trace Session at 3am on January 31, 2013.
The fifth command uses the Add-PefMessageSource cmdlet to specify a 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:\> $TriggerTime = Get-Date -Year 2013 -Month 1 -Day 31 -Hour 3 -Minute 0 -Second 0
PS C:\> $Trigger02 = New-PefDateTimeTrigger -DateTime $TriggerTime
PS C:\> Set-PefTraceFilter -PEFSession $TraceSession01 -Filter "icmp" -Trigger $Trigger02
PS C:\> Add-PefMessageSource –Source "Microsoft-Pef-WFP-MessageProvider"
PS C:\> Start-PefTraceSession –PEFSession $TraceSession01