New-Event

Modül:
Microsoft.PowerShell.Utility Module

Yeni bir olay oluşturur.

Syntax

Default (Varsayılan) 

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

Description

New-Event cmdlet'i yeni bir özel olay oluşturur.

Özel olayları, kullanıcılara programınızdaki durum değişiklikleri ve donanım veya sistem koşulları, uygulama durumu, disk durumu, ağ durumu veya bir arka plan işinin tamamlanması gibi programınızın algılayabileceğiniz herhangi bir değişiklik hakkında bilgi vermek için kullanabilirsiniz.

Özel olaylar her tetiklendiğinde oturumunuzda olay kuyruğuna otomatik olarak eklenir; bunlara abone olmanız gerekmez. Ancak, bir olayı yerel oturuma iletmek veya olaya yanıt vermek için bir eylem belirtmek istiyorsanız, özel olaya abone olmak için Register-EngineEvent cmdlet'ini kullanın.

Özel bir olaya abone olduğunuzda, olay abonesi oturumunuza eklenir. olay aboneliğini Unregister-Event cmdlet'ini kullanarak iptal ederseniz, olay abonesi ve özel olay oturumdan silinir. Özel olaya abone değilseniz, olayı silmek için program koşullarını değiştirmeniz veya PowerShell oturumunu kapatmanız gerekir.

Örnekler

Örnek 1: Olay kuyruğunda yeni bir olay oluşturma

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

Bu komut PowerShell olay kuyruğunda yeni bir olay oluşturur. Olayı göndermek için bir Windows.Timer nesnesi kullanır.

Örnek 2: Başka bir olaya yanıt olarak olay oluşturma

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)
   }
}

Bu örnek işlev New-Event cmdlet'ini kullanarak başka bir olaya yanıt olarak bir olay oluşturur. Komut, yeni bir işlem oluşturulduğunda oluşturulan Windows Yönetim Araçları (WMI) olayına abone olmak için Register-ObjectEvent cmdlet'ini kullanır. Komut, yeni olayı oluşturan cmdlet'ini çağırmak için cmdlet'in New-Event parametresini kullanır.

New-Event oluşturan olaylar PowerShell olay kuyruğuna otomatik olarak eklendiğinden, bu olaya kaydolmanız gerekmez.

Parametreler

-EventArguments

Olay için seçenekler içeren bir nesne belirtir.

Parametre özellikleri

Tür:

PSObject[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:2
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-MessageData

Olayla ilişkili ek verileri belirtir. Bu parametrenin değeri, olay nesnesinin MessageData özelliğinde görüntülenir.

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:3
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Sender

Olayı tetikleyen nesneyi belirtir. Varsayılan olarak PowerShell altyapısı kullanılır.

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-SourceIdentifier

Yeni olay için bir ad belirtir. Bu parametre gereklidir ve oturumda benzersiz olmalıdır.

Bu parametrenin değeri, olayların SourceIdentifier özelliğinde görüntülenir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Bu cmdlet'e giriş kanalı yapamazsınız.

Çıkışlar

PSEventArgs

Notlar

Linux veya macOS platformlarında kullanılabilir olay kaynağı yok.

Yeni özel olay, olay aboneliği ve olay kuyruğu yalnızca geçerli oturumda bulunur. Mevcut oturumu kapatırsanız, etkinlik kuyruğu silinir ve etkinlik aboneliği iptal edilir.