Read-SqlXEvent
Считывает SQL Server XEvents из файла XEL или динамического сеанса SQL XEvent.
Синтаксис
Read-SqlXEvent
[-FileName] <String>
[<CommonParameters>] Read-SqlXEvent
-ConnectionString <String>
-SessionName <String>
[<CommonParameters>] Описание
Read-SqlXEvent считывает SQL Server XEvents из файла или динамического сеанса XEvent SQL. Сеансы XEvent создаются API Transact-SQL CREATE EVENT SESSION. Файлы XEvent SQL обычно имеют . Расширения XEL или .sqlaudit и содержат поток событий XEvent. Структура XEvents определяется в конфигурации сеанса. Динамические потоки SQL доступны по протоколу SQL TDS и требуют проверки подлинности на сервере, который их создал.
New in v22: if you are using the -ConnectionString parameter, you may get an error like "The certificate chain was issued by an authority that is not trusted." This is because the new SQL driver changed its default to something more secure. Either make sure you configure your server properly, or install/trust the certificate; alternatively (not recommended), you can pass Encrypt=Optional or TrustServerCertificate=true in the connection string to go back to the behavior that existed in v21 of the module.
Примеры
Пример 1. Чтение и анализ файла sqlaudit. Каждый возвращаемый объект будет содержать все сведения из одной записи аудита.
Read-SqlXEvent -FileName C:\audits\Audit-20190529-132659.sqlaudit
# The output would look like this:
#
# Name : audit_event
# UUID : c6479a6f-f1bd-4759-9881-fcb493821aff
# Timestamp : 6/13/2019 7:49:42 AM +00:00
# Fields : {[audit_schema_version, 1], [event_time, 6/13/2019 7:49:42 AM +00:00], [sequence_number, 1], [action_id,
# 1129534785]...}
# Actions : {}
#
# Name : audit_event
# UUID : c6479a6f-f1bd-4759-9881-fcb493821aff
# Timestamp : 6/13/2019 12:42:28 PM +00:00
# Fields : {[audit_schema_version, 1], [event_time, 6/13/2019 12:42:28 PM +00:00], [sequence_number, 1], [action_id,
# 1129534785]...}
# Actions : {}
# ...Пример 2. Чтение и анализ динамического потока событий XEvents из SQL Server, работающего на том же компьютере, подключенном к проверка подлинности Windows. Каждый возвращаемый объект будет содержать все сведения из одной записи XEvent.
Read-SQLXEvent -ConnectionString "Server=.;Database=master;Trusted_Connection=True" -SessionName telemetry_xevents
# The output would look like this:
#
# Name : auto_stats
# UUID : 9237e17a-a73d-4832-8936-f319e19e219b
# Timestamp : 11/14/2022 5:31:12 AM +00:00
# Fields : {[database_id, 1], [object_id, 74], [index_id, 1], [job_id, 0]…}
# Actions : {}
#
# Name : auto_stats
# UUID : 9237e17a-a73d-4832-8936-f319e19e219b
# Timestamp : 11/14/2022 5:31:12 AM +00:00
# Fields : {[database_id, 1], [object_id, 74], [index_id, 17], [job_id, 0]…}
# Actions : {}
# ...Параметры
-ConnectionString
SQL Server строку подключения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileName
Имя файла XEvent для чтения.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SessionName
Имя сеанса SQL Server XEvent, определенное в transact-SQL CREATE EVENT SESSION.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
System.String
Выходные данные
Microsoft.SqlServer.XEvent.XELite.IXEvent