Get-SPLogEvent

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Retorna resultados de um log de rastreamento do ULS (Serviço de Log Unificado).

Syntax

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>]

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O cmdlet Get-SPLogEvent retorna registros de um arquivo de log de rastreamento do ULS que correspondem aos critérios. Caso nenhum parâmetro seja especificado, todos os registros de todos os arquivos de log serão retornados. Use os parâmetros StartTime e EndTime para filtrar em um intervalo de tempo. O uso desses parâmetros é recomendado para otimizar o desempenho desse cmdlet.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

--------------EXEMPLO 1-----------------

Get-SPLogEvent -MinimumLevel "Warning"

Este exemplo retorna todas as entradas de log iguais ou mais severas do que Aviso do diretório de log padrão.

--------------EXEMPLO 2-----------------

Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}

Este exemplo retorna todas as entradas de aviso dos arquivos de log do diretório C:\Logs.

--------------EXEMPLO 3-----------------

Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"

Este exemplo retorna entradas de erro ocorridas durante um determinado intervalo de tempo, que é específico da cultura dos Estados Unidos.

--------------EXEMPLO 4-----------------

Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")

Este exemplo retorna o conteúdo do arquivo de log mais recente e adiciona os dados de chave de contexto especificados.

--------------EXEMPLO 5-----------------

Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}

Este exemplo retorna todas as entradas de erro relacionadas ao SharePoint Foundation.

--------------EXEMPLO 6-----------------

Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}

Este exemplo retorna o conteúdo do arquivo de log e adiciona dados de contexto.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

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

Retorna cada registro como uma cadeia de caracteres separada

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

Especifica que os dados de contexto devem ser adicionados aos resultados das Chaves de Contexto especificadas, por exemplo: -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

Lista os arquivos de log de um diretório alternativo (qualquer diretório diferente do diretório LogLocation configurado).

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

O tipo deve ter um formato de Data/Hora específico da cultura do idioma administrativo, como, por exemplo, 2/16/2007 12:15:12 para Inglês-EUA.

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

Especifica um arquivo do qual os registros serão consultados.

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

Retorna os registros do nível especificado ou superior. Os valores válidos são Erro ou Aviso.

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