New-Event

New-Event
    [-SourceIdentifier] <String>
    [[-Sender] <PSObject>]
    [[-EventArguments] <PSObject[]>]
    [[-MessageData] <PSObject>]
    [<CommonParameters>]

Cmdleten New-Event skapar en ny anpassad händelse.

Du kan använda anpassade händelser för att meddela användare om tillståndsändringar i programmet och eventuella ändringar som programmet kan identifiera, inklusive maskinvaru- eller systemvillkor, programstatus, diskstatus, nätverksstatus eller slutförande av ett bakgrundsjobb.

Anpassade händelser läggs automatiskt till i händelsekön i din session när de aktiveras. du behöver inte prenumerera på dem. Men om du vill vidarebefordra en händelse till den lokala sessionen eller ange en åtgärd för att svara på händelsen använder du cmdleten Register-EngineEvent för att prenumerera på den anpassade händelsen.

När du prenumererar på en anpassad händelse läggs händelseprenumeranten till i sessionen. Om du avbryter händelseprenumerationen med hjälp av cmdleten Unregister-Event tas händelseprenumeranten och den anpassade händelsen bort från sessionen. Om du inte prenumererar på den anpassade händelsen måste du ändra programvillkoren eller stänga PowerShell-sessionen om du vill ta bort händelsen.

PS C:\> New-Event -SourceIdentifier Timer -Sender Windows.Timer -MessageData "Test"

Det här kommandot skapar en ny händelse i PowerShell-händelsekön. Den använder ett Windows.Timer--objekt för att skicka händelsen.

PS C:\> function Enable-ProcessCreationEvent
{
   $Query = New-Object System.Management.WqlEventQuery "__InstanceCreationEvent", (New-Object TimeSpan 0,0,1), "TargetInstance isa 'Win32_Process'"
   $ProcessWatcher = New-Object System.Management.ManagementEventWatcher $Query
   $Identifier = "WMI.ProcessCreated"
   Register-ObjectEvent $ProcessWatcher "EventArrived" -SupportEvent $Identifier -Action
   {
      [void] (New-Event -SourceId "PowerShell.ProcessCreated" -Sender $args[0] -EventArguments $args[1].SourceEventArgs.NewEvent.TargetInstance)
   }
}

Den här exempelfunktionen använder cmdleten New-Event för att skapa en händelse som svar på en annan händelse. Kommandot använder cmdleten Register-ObjectEvent för att prenumerera på WMI-händelsen (Windows Management Instrumentation) som aktiveras när en ny process skapas. Kommandot använder parametern Action för cmdleten för att anropa cmdleten New-Event, vilket skapar den nya händelsen.

Eftersom de händelser som New-Event genererar läggs automatiskt till i PowerShell-händelsekön behöver du inte registrera dig för händelsen.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan inte skicka objekt till den här cmdleten.

Inga händelsekällor är tillgängliga på Linux- eller macOS-plattformarna.

Den nya anpassade händelsen, händelseprenumerationen och händelsekön finns bara i den aktuella sessionen. Om du stänger den aktuella sessionen ignoreras händelsekön och händelseprenumerationen avbryts.