Get-SPLogEvent
Возвращает результаты из журнала трассировки единой службы ведения журнала (ULS).
Синтаксис
Get-SPLogEvent
[-AssignmentCollection <SPAssignmentCollection>]
[-AsString]
[-ContextKey <String[]>]
[-Directory <String>]
[-MinimumLevel <String>]
[-EndTime <DateTime>]
[-StartTime <DateTime>]
[<CommonParameters>] 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
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AsString
Возвращает каждую запись как отдельную строку.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ContextKey
Указывает, что данные контекста должны быть добавлены в результаты для указанных ключей контекста, например : -ContextKey @("UserName", "SiteName").
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Directory
Выводит список файлов журнала из другого каталога (любой другой каталог, кроме настроенного каталога LogLocation).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-EndTime
Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-File
Указывает файл, из которого будут запрашиваться записи.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-MinimumLevel
Возвращает записи, относящиеся к указанному и более высоким уровням. Допустимые значения: Error или Warning.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-StartTime
Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |