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.
Sintaxis
Default (Es el valor predeterminado).
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" -Overwrite
En 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 Search
En 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 High
En 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
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-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 |
-Category
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-ContextFilter
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica un filtro para hacer un seguimiento de las entradas en un contexto concreto con el formato clave=valor (por ejemplo, user=contoso\joeuser.
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 |
-Correlation
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | Guid[] |
| 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 |
-EndTime
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-EventID
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el identificador de evento por el que filtrar. Es posible usar caracteres comodín.
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 |
-ExcludeNestedCorrelation
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-Level
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el nombre del nivel por el que se debe filtrar.
Los resultados incluyen el nivel especificado y todo cuanto sea superior.
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 |
-Message
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-Overwrite
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-Path
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Process
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el nombre del proceso por el que se debe filtrar.
Es posible usar caracteres comodín.
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
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.
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 |
-ThreadID
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | UInt32[] |
| 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.