Get-SPLogEvent

  • Ссылка
Модуль:
SharePointServer
Применяется к:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Возвращает результаты из журнала трассировки единой службы ведения журнала (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