Get-SPLogEvent
Devuelve resultados de un registro de seguimiento del Servicio de creación de registros unificado (ULS).
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 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
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.
| 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
Devuelve cada registro como una cadena independiente.
| 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 los datos de contexto se deben agregar a los resultados de las claves de contexto especificadas, por ejemplo: -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
Incluye archivos de registro de un directorio alternativo (cualquier directorio que no sea el directorio 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
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.
| 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 un archivo específico desde el que se consultan registros.
| 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
Devuelve registros en el nivel especificado o por encima de dicho nivel. Los valores válidos son Error o Advertencia.
| 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
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.
| 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 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de