Get-SPLogEvent
Возвращает результаты из журнала трассировки единой службы ведения журнала (ULS).
Синтаксис
Directory
Get-SPLogEvent
[-AssignmentCollection <SPAssignmentCollection>]
[-AsString]
[-ContextKey <String[]>]
[-Directory <String>]
[-MinimumLevel <String>]
[-EndTime <DateTime>]
[-StartTime <DateTime>]
[<CommonParameters>]
File
Get-SPLogEvent
[-AssignmentCollection <SPAssignmentCollection>]
[-AsString]
[-ContextKey <String[]>]
[-MinimumLevel <String>]
[-EndTime <DateTime>]
[-File <String>]
[-StartTime <DateTime>]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Командлет Get-SPLogEvent возвращает записи из файла журнала трассировки единой службы ведения журнала, соответствующие условиям. Если никакие параметры не указаны, возвращаются все записи из всех файлов журнала. Задать фильтр по диапазону времени можно с помощью параметров StartTime и EndTime. Рекомендуется использовать эти параметры для оптимизации работы командлета.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
ПРИМЕР 1
Get-SPLogEvent -MinimumLevel "Warning"
В этом примере из каталога журнала по умолчанию возвращаются все записи журнала уровней не ниже предупреждения.
ПРИМЕР 2
Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}
В этом примере возвращаются все записи предупреждений из файлов журнала в каталоге C:\Logs.
ПРИМЕР 3
Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"
В этом примере возвращаются записи об ошибках, возникших за определенный период времени (с региональными параметрами США).
ПРИМЕР 4
Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")
В этом примере возвращается содержимое последнего файла журнала и добавляются данные для заданного ключа контекста.
ПРИМЕР 5
Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}
В этом примере возвращаются все записи об ошибках, связанных с SharePoint Foundation.
ПРИМЕР 6
Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}
В этом примере возвращается содержимое файла журнала и добавляются данные контекста.
Параметры
-AssignmentCollection
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
Свойства параметра
| Тип: | SPAssignmentCollection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AsString
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Возвращает каждую запись как отдельную строку.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContextKey
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает, что данные контекста должны быть добавлены в результаты для указанных ключей контекста, например : -ContextKey @("UserName", "SiteName").
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Directory
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Выводит список файлов журнала из другого каталога (любой другой каталог, кроме настроенного каталога LogLocation).
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Directory
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndTime
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).
Свойства параметра
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-File
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Указывает файл, из которого будут запрашиваться записи.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
File
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MinimumLevel
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Возвращает записи, относящиеся к указанному и более высоким уровням. Допустимые значения: Error или Warning.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StartTime
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).
Свойства параметра
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.