Remove-Event
Elimina gli eventi dalla coda di eventi.
Sintassi
BySource (impostazione predefinita).
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Remove-Event elimina gli eventi dalla coda di eventi nella sessione corrente.
Questo cmdlet elimina solo gli eventi attualmente presenti nella coda. Per annullare le registrazioni di eventi o annullare la sottoscrizione, usare il cmdlet Unregister-Event.
Esempio
Esempio 1: Rimuovere un evento in base all'identificatore di origine
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Questo comando elimina gli eventi con un identificatore di origine Process Started dalla coda di eventi.
Esempio 2: Rimuovere un evento in base all'identificatore di evento
PS C:\> Remove-Event -EventIdentifier 30
Questo comando elimina l'evento con un ID evento pari a 30 dalla coda di eventi.
Esempio 3: Rimuovere tutti gli eventi
PS C:\> Get-Event | Remove-Event
Questo comando elimina tutti gli eventi dalla coda di eventi.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EventIdentifier
Specifica l'identificatore dell'evento per il quale viene eliminato il cmdlet. In ogni comando è necessario un parametro EventIdentifier o SourceIdentifier.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByIdentifier
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SourceIdentifier
Specifica l'identificatore di origine da cui questo cmdlet elimina gli eventi. I caratteri jolly non sono consentiti. In ogni comando è necessario un parametro EventIdentifier o SourceIdentifier.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
BySource
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSEventArgs
È possibile inviare tramite pipe gli eventi da Get-Event a questo cmdlet.
Output
None
Questo cmdlet non restituisce alcun output.
Note
Nessuna origine evento disponibile nelle piattaforme Linux o macOS.
Gli eventi, le sottoscrizioni di eventi e la coda di eventi esistono solo nella sessione corrente. Se si chiude la sessione corrente, la coda di eventi viene eliminata e la sottoscrizione di eventi viene annullata.
