Register-CimIndicationEvent

Modül:

CimCmdlets Module

Filtre ifadesi veya sorgu ifadesi kullanarak göstergelere abonedir.

Syntax

ClassNameComputerSet (Varsayılan)

Register-CimIndicationEvent
    [-ClassName] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

ClassNameSessionSet

Register-CimIndicationEvent
    [-ClassName] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    -CimSession <CimSession>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

QueryExpressionSessionSet

Register-CimIndicationEvent
    [-Query] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    -CimSession <CimSession>
    [-Namespace <String>]
    [-QueryDialect <String>]
    [-OperationTimeoutSec <UInt32>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

QueryExpressionComputerSet

Register-CimIndicationEvent
    [-Query] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-QueryDialect <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Register-CimIndicationEvent cmdlet, gösterge sınıf adı veya sorgu ifadesi kullanarak göstergelere abone olur. SourceIdentifier parametresini kullanarak aboneliğe bir ad verin.

Bu cmdlet bir EventSubscription nesnesi döndürür. Aboneliği iptal etmek için bu nesneyi kullanabilirsiniz.

Örnekler

Örnek 1: Sınıf tarafından oluşturulan olayları kaydetme

Bu örnek, Win32_ProcessStartTraceadlı sınıf tarafından oluşturulan olaylara abonedir. Bu sınıf, bir işlem her başlatıldığında bir olay oluşturur.

$event = @{
    ClassName = 'Win32_ProcessStartTrace'
    SourceIdentifier = 'ProcessStarted'
}
Register-CimIndicationEvent @event
Get-Event -SourceIdentifier "ProcessStarted"

Get-Event cmdlet'i, ProcessStarted aboneliğiyle olayları alır. Daha fazla bilgi için bkz. Get-Event.

Uyarı

Bu örnekte PowerShell'i Yönetici olarak çalıştırmanız gerekir.

Örnek 2: Sorgu kullanarak olayları kaydetme

Bu örnekte, Win32_LocalTimeadlı bir sınıfın örneğinde değişiklik olduğunda oluşturulan bir olaya abone olmak için bir sorgu kullanılır.

$query = "SELECT * FROM CIM_InstModification WHERE TargetInstance ISA 'Win32_LocalTime'"
Register-CimIndicationEvent -Query $query -SourceIdentifier "Timer"

Örnek 3: Olay geldiğinde betik çalıştır

Bu örnekte, bir olaya yanıt olarak bir eylemin nasıl kullanılacağı gösterilmektedir. değişkeni$action, CIM'den alınan olaya erişmek için değişkeni kullanan $EventAction için betik bloğuna sahiptir.

$action = {
  $name = $Event.SourceEventArgs.NewEvent.ProcessName
  $id = $Event.SourceEventArgs.NewEvent.ProcessId
  Write-Host -Object "New Process Started : Name = $name ID = $id"
}
$event = @{
    ClassName = 'Win32_ProcessStartTrace'
    SourceIdentifier = 'ProcessStarted'
    Action = $action
}
Register-CimIndicationEvent @event

Daha fazla bilgi için bkz. Win32_ProcessStartTrace.

Örnek 4: Olayları uzak bilgisayara kaydetme

Bu örnek, Server01adlı uzak bilgisayardaki olaylara abonedir. CIM sunucusundan alınan olaylar, geçerli PowerShell oturumundaki olay kuyruğunda depolanır ve ardından olayları almak için yerel bir Get-Event komutu çalıştırılır.

$event = @{
    ClassName = 'Win32_ProcessStartTrace'
    SourceIdentifier = 'ProcessStarted'
    ComputerName = 'Server01'
}
Register-CimIndicationEvent @event
Get-Event -SourceIdentifier "ProcessStarted"

Parametreler

-Action

Olayları işleyen komutları belirtir. Bu parametre tarafından belirtilen komutlar, olayı olay kuyruğuna göndermek yerine bir olay tetiklendiğinde çalıştırılır. Betik bloğu oluşturmak için komutları küme ayraçları ({}) içine alın.

Eylem ile belirtilen betik bloğu, Eylem betik bloğuna $Eventolay hakkında bilgi sağlayan , $EventSubscriber$Sender, , $SourceEventArgsve $SourceArgs otomatik değişkenlerini içerebilir. Daha fazla bilgi için otomatik değişkenler hakkında'e bakın.

Parametre özellikleri

Tür:	ScriptBlock
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

-CimSession

Belirtilen CIM oturumunu kullanarak komutunu çalıştırır. CIM oturumunu içeren bir değişken veya New-CimSession veya Get-CimSession cmdlet'leri gibi CIM oturumunu oluşturan veya alan bir komut girin. Daha fazla bilgi için bkz. about_CimSession.

Parametre özellikleri

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

Parametre kümeleri

ClassNameSessionSet

Position:	Named
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

QueryExpressionSessionSet

Position:	Named
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

-ClassName

Abone olduğunuz gösterge sınıfını belirtir. PowerShell, sınıf adlarının listesini sağlamak için yerel WMI sunucusundan sınıfların listesini aldığından, sınıf listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.

Parametre özellikleri

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

Parametre kümeleri

ClassNameComputerSet

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

ClassNameSessionSet

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

-ComputerName

CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam olarak belirtilmiş etki alanı adı (FQDN), NetBIOS adı veya IP adresi belirtebilirsiniz.

Bu parametreyi belirtirseniz, cmdlet WsMan protokolunu kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur. Bu parametreyi belirtmezseniz, cmdlet Bileşen Nesne Modeli 'ni (COM) kullanarak yerel sistemde işlem gerçekleştirir.

Aynı bilgisayarda birden çok işlem gerçekleştiriliyorsa, daha iyi performans için CIM oturumu kullanarak bağlanın.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Çin, SunucuAdı

Parametre kümeleri

ClassNameComputerSet

Position:	Named
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

QueryExpressionComputerSet

Position:	Named
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

-Forward

Abonelik olaylarının yerel bilgisayardaki oturuma iletildiğini gösterir. Uzak bir bilgisayarda veya uzak bir oturumda olaylara kaydolırken bu parametreyi kullanın.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
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

-MaxTriggerCount

Belirtilen sayıda tetiklendikten sonra abonenin otomatik olarak kaydının silinmesi gerektiğini belirten parametre. Değer sıfıra eşit veya sıfırdan küçükse, kaydı kaldırılmadan olayın tetiklenme sayısı sınırı yoktur.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
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

Bu olay aboneliğiyle ilişkilendirilecek ek verileri belirtir. Bu parametrenin değeri, bu abonelikle ilişkili tüm olayların MessageData özelliğinde görünür.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
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

-Namespace

CIM işlemi için ad alanını belirtir. Varsayılan ad alanı kök/CIMV2 . PowerShell, ad alanlarının listesini sağlamak üzere yerel WMI sunucusundan bir ad alanı listesi aldığından, ad alanları listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
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

-OperationTimeoutSec

Cmdlet'in bilgisayardan yanıt bekleme süresini belirtir. Varsayılan olarak, bu parametrenin değeri 0'dır; bu da cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir.

OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.

Parametre özellikleri

Tür:	UInt32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	OT

Parametre kümeleri

(All)

Position:	Named
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

-Query

CIM sunucusunda çalıştırılacak sorguyu belirtir. Belirtilen değer çift tırnak işareti ", tek tırnak işareti 'veya ters eğik çizgi \içeriyorsa, bu karakterlere ters eğik çizgi karakteri ön ekleyerek bu karakterlerden kaçmalısınız. Belirtilen değer WQL LIKE işlecini kullanıyorsa, bunları köşeli ayraç içine []içine alarak şu karakterlerden kaçmalısınız: yüzde %, alt çizgi _veya [köşeli ayraç açma.

Parametre özellikleri

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

Parametre kümeleri

QueryExpressionSessionSet

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

QueryExpressionComputerSet

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

-QueryDialect

Sorgu parametresi için kullanılan sorgu dilini belirtir. Bu parametre için kabul edilebilir değerler şunlardır: WQL veya CQL. Varsayılan değer WQLdeğeridir.

Parametre özellikleri

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

Parametre kümeleri

QueryExpressionSessionSet

Position:	Named
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

QueryExpressionComputerSet

Position:	Named
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

Abonelik için bir ad belirtir. Belirttiğiniz ad geçerli oturumda benzersiz olmalıdır. Varsayılan değer, PowerShell tarafından atanan bir GUID'dir. Bu değer, abone nesnesinin ve bu abonelikle ilişkili tüm olay nesnelerinin SourceIdentifier özelliğinin değerinde görünür.

Parametre özellikleri

Tür:	String
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

-SupportEvent

Olay aboneliğinin gizli olduğunu gösterir. Geçerli abonelik daha karmaşık bir olay kayıt mekanizmasının parçası olduğunda ve bağımsız olarak keşfedilmemesi gerektiğinde bu parametreyi kullanın.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
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

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

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

Object

Bu cmdlet bir EventSubscription nesnesi döndürür.

Notlar

PowerShell, Register-CimIndicationEventiçin aşağıdaki diğer adları içerir:

• Windows:
  • rcie

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

İlişkili Bağlantılar

• Get-Event komutu
• Olayı Kaldır
• Etkinlik Kaydını Sil
• Write-Host (PowerShell'e özgü bir komut)
• Get-CimSession
• New-CimSession
• about_WQL