Start-PefTraceSession
Start-PefTraceSession
Starts a PEF Trace Session.
Sintaxis
Parameter Set: Default
Start-PefTraceSession [-PEFSession] <IPpkTraceSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Trigger <Trigger[]> ] [ <CommonParameters>]
Descripción detallada
The Start-PefTraceSession cmdlet creates an action that starts a Protocol Engineering Framework (PEF) Trace Session. You can specify a trigger for this action.
If you do not specify a new trigger or a trigger that already fired, the start action enters a message processing loop. The Trace Session uses that loop to process messages that are delivered by the specified message providers. The loop stops when the Trace Session stops. A session is terminated when the stop action occurs or when there are no more messages to process. Use the Stop-PefTraceSession cmdlet to create a stop action.
Parámetros
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Los valores aceptables para este parámetro son los siguientes:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Alias |
infa |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Alias |
iv |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-PEFSession<IPpkTraceSession>
Specifies an object that contains a Trace Session. To create a Trace Session, use the New-PefTraceSession cmdlet.
Alias |
none |
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
none |
¿Aceptar canalización? |
True (ByValue) |
¿Aceptar caracteres comodín? |
false |
-Trigger<Trigger[]>
Specifies an array of Trigger objects.
Alias |
none |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
Ejemplos
Example 1: Start a Trace Session that closes with a stop trigger
This example creates and starts a PEF Trace Session.
The first command uses the New-PefTraceSession cmdlet to create a Trace Session object, and then stores it in the $TraceSession01 variable.
The second command uses the Add-PefMessageSource cmdlet to specify a provider for the Trace Session object stored in $TraceSession01.
The third command uses the New-PefMessageTrigger cmdlet to create a message trigger object, and then stores it in the $Trigger01 variable.
The fourth command uses the Stop-PefTraceSession cmdlet to create a stop action for the Trace Session, which is activated by the trigger stored in $Trigger01.
The last command starts the PEF Trace Session stored in $TraceSession01.
PS C:\> $TraceSession01 = New-PefTraceSession
PS C:\> Add-PefMessageSource -PEFSession $TraceSession01 –Provider "Microsoft-Pef-WFP-MessageProvider"
PS C:\> $Trigger01 = New-PefMessageTrigger -Filter "icmp"
PS C:\> Stop-PefTraceSession -PEFSession $TraceSession01 -Trigger $Trigger01
PS C:\> Start-PefTraceSession -PEFSession $TraceSession01