Merge-SPLogFile
Combina entradas del registro de seguimiento de todos los equipos del conjunto de servidores en un solo archivo de registro del equipo local.
Syntax
Merge-SPLogFile
-Path <String>
[-Area <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Category <String[]>]
[-ContextFilter <String[]>]
[-Correlation <Guid[]>]
[-EndTime <DateTime>]
[-EventID <String[]>]
[-ExcludeNestedCorrelation]
[-Level <String>]
[-Message <String[]>]
[-Overwrite]
[-Process <String[]>]
[-StartTime <DateTime>]
[-ThreadID <UInt32[]>]
[<CommonParameters>] Description
El cmdlet Merge-SPLogFile devuelve registros de archivos de registro de seguimiento del Servicio de creación de registros unificado (ULS) para cada servidor de la granja que coincida con los criterios y escribe los resultados en un nuevo archivo de registro en el equipo local. Si no se devuelve ningún resultado, se escribe una advertencia en la ventana de consola de Windows PowerShell.
Le recomendamos filtrar mediante los parámetros StartTime y EndTime para optimizar el rendimiento de este cmdlet. Algunos parámetros de filtrado, como Process, Area, Category, EventID y Message, admiten caracteres comodín.
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-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -OverwriteEn este ejemplo se combina la última hora de los datos de registro de todos los equipos del conjunto de servidores sin filtrado.
--------------EJEMPLO 2-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area SearchEn este ejemplo se combina la última hora de los datos de registro del área Search.
--------------EJEMPLO 3-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"En este ejemplo se combina la última hora de los datos de registro de las áreas SharePoint Foundation y Web Analytics Services.
--------------EJEMPLO 4-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level HighEn este ejemplo se combinan los datos de registro del nivel High o superior.
--------------EJEMPLO 5-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"En este ejemplo se combinan los datos de registro para los eventos de un intervalo de tiempo concreto con referencias culturales específicas de Estados Unidos.
--------------EJEMPLO 6-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"En este ejemplo se combinan los datos de registro para eventos con permission changed en el texto del mensaje.
--------------EJEMPLO 7-----------------
Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"En este ejemplo se combinan los datos de registro para todos los trabajos del temporizador de búsqueda.
--------------EJEMPLO 8-----------------
Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"En este ejemplo se muestra cómo combinar los datos de registro para todos los nombres de usuario que tienen el formato contoso\joeuser o Contoso/joeuser.
Parámetros
-Area
Especifica el nombre del área en la que se debe realizar el filtrado.
El tipo debe ser un nombre válido (por ejemplo, SharePoint Foundation). .
Es posible usar caracteres comodín.
| 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 |
-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 |
-Category
Especifica el identificador de categoría en por el que se debe filtrar.
El tipo debe ser un nombre válido (por ejemplo, category1).
Es posible usar caracteres comodín.
| 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 |
-ContextFilter
Especifica un filtro para hacer un seguimiento de las entradas en un contexto concreto con el formato clave=valor (por ejemplo, user=contoso\joeuser.
| 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 |
-Correlation
Especifica el identificador de correlación por el que se debe filtrar. El tipo debe ser un GUID válido, con el formato F0BB0790-4323-A153-096F-ABCDC80E24D4.
| Type: | Guid[] |
| 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
Especifica la hora de finalización de las entradas de registro devueltas.
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 |
-EventID
Especifica el identificador de evento por el que filtrar. Es posible usar caracteres comodín.
| 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 |
-ExcludeNestedCorrelation
Excluye los valores de correlación anidados de los resultados. Este parámetro solo se usa cuando se filtran los resultados con el parámetro ContextFilter.
De forma predeterminada, los registros devueltos por el parámetro ContextFilter incluyen todos los registros relacionados además de los que coinciden con el filtro. Si se especifica esta opción, se incluyen solamente los registros que coinciden con el filtro y se excluyen todos los registros relacionados.
| 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 |
-Level
Especifica el nombre del nivel por el que se debe filtrar.
Los resultados incluyen el nivel especificado y todo cuanto sea superior.
| 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 |
-Message
Especifica el texto del mensaje por el que se debe filtrar.
El tipo debe ser un texto válido. El texto con espacios se debe incluir entre comillas (por ejemplo, "Esto es texto").
Es posible usar caracteres comodín.
| 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 |
-Overwrite
Sobrescribe el archivo de registro si ya existe en la ruta de acceso especificada.
El tipo debe ser uno de los siguientes valores:
- $True
- $False
El valor predeterminado es $False.
| 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 |
-Path
Especifica el nombre de archivo y la ruta de acceso en la que se debe escribir el archivo de registro combinado. Se admiten rutas de acceso relativas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Process
Especifica el nombre del proceso por el que se debe filtrar.
Es posible usar caracteres comodín.
| 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
Especifica la hora de inicio de las entradas del registro devueltas.
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.
El valor predeterminado es una hora anterior a la hora actual en el equipo local.
| 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 |
-ThreadID
Especifica el identificador de subproceso por el que se debe filtrar.
El tipo debe ser un entero válido entre 0 y 4.294.967.295.
| Type: | UInt32[] |
| 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 |