Get-SPLogEvent
Devuelve resultados de un registro de seguimiento del Servicio de creación de registros unificado (ULS).
Sintaxis
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>]
Description
Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.
El cmdlet Get-SPLogEvent devuelve registros para un archivo de registro de seguimiento de ULS que coincide con los criterios. Si no se especifica ningún parámetro, se devuelven todos los registros de todos los archivos de registro. Use los parámetros StartTime y EndTime para filtrar por un intervalo de tiempo. Se recomienda usar estos parámetros para optimizar el rendimiento de este cmdlet.
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
EJEMPLO 1
Get-SPLogEvent -MinimumLevel "Warning"
En este ejemplo se devuelven todas las entradas del registro con una gravedad igual o superior a la advertencia del directorio de registros predeterminado.
EJEMPLO 2
Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}
En este ejemplo se devuelven todas las entradas de advertencia de los archivos de registro del directorio C:\Logs.
EJEMPLO 3
Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"
En este ejemplo se devuelven las entradas de errores producidos durante un período de tiempo determinado, lo que es específico de la referencia cultural de Estados Unidos.
EJEMPLO 4
Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")
En este ejemplo se devuelve el contenido del archivo de registro más reciente y se agregan los datos clave de contexto especificados.
EJEMPLO 5
Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}
En este ejemplo se devuelven todas las entradas de errores relacionadas con SharePoint Foundation.
EJEMPLO 6
Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}
En este ejemplo se devuelve el contenido del archivo de registro y se agregan datos de contexto.
Parámetros
-AssignmentCollection
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AsString
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Devuelve cada registro como una cadena independiente.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ContextKey
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica que los datos de contexto se deben agregar a los resultados de las claves de contexto especificadas, por ejemplo: -ContextKey @("UserName", "SiteName").
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Directory
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Incluye archivos de registro de un directorio alternativo (cualquier directorio que no sea el directorio LogLocation configurado).
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Directory
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EndTime
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
El tipo debe ser un formato de fecha hora válido y específico de la cultura del idioma de administración, como 2/16/2007 12:15:12 para inglés de EE. UU.
Propiedades del parámetro
| Tipo: | DateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-File
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica un archivo específico desde el que se consultan registros.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
File
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MinimumLevel
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Devuelve registros en el nivel especificado o por encima de dicho nivel. Los valores válidos son Error o Advertencia.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-StartTime
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
El tipo debe ser un formato de fecha hora válido y específico de la cultura del idioma de administración, como 2/16/2007 12:15:12 para inglés de EE. UU.
Propiedades del parámetro
| Tipo: | DateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.