Merge-SPUsageLog

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2016, SharePoint Server 2019

Devuelve los registros de los archivos de registro de uso.

Syntax

Merge-SPUsageLog
     [-Identity] <SPUsageDefinitionPipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-DiagnosticLogPath <String>]
     [-EndTime <DateTime>]
     [-OverWrite]
     [-Partial]
     [-Servers <String[]>]
     [-StartTime <DateTime>]
     [<CommonParameters>]

Description

El cmdlet Merge-SPUsageLog devuelve los registros de los archivos del registro de uso de cada servidor de la granja de servidores que cumplan los criterios y escribe los resultados en la canalización.

El comando reúne, filtra y agrega los registros en función de los criterios que especifique el usuario. Le recomendamos filtrar mediante los parámetros StartTime y EndTime para optimizar el rendimiento de este cmdlet.

Debe especificar al menos un tipo basado en el uso. Para obtener información acerca de los tipos basados en el uso válidos, consulte Get-SPUsageDefinition.

Este cmdlet requiere que la comunicación remota de PowerShell esté habilitada.

Ejemplos

Ejemplo 1

Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1

Combina el registro de uso de la definición de uso "Trabajos del temporizador" del servidor especificado y las salidas a la consola de PowerShell.

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 2016, SharePoint Server 2019

-DiagnosticLogPath

Especifica el archivo en el que debe escribirse la información de diagnóstico. Se admite una ruta de acceso relativa.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 y hora válido y específico de la cultura del idioma de administración, como 16/2/2007, 12:15:12 para el español de España.

El valor predeterminado es la hora actual.

Si desea especificar la hora UTC, deberá agregar una "Z" al final del parámetro. Por ejemplo: "15-06-2016, 03:29:18.199 Z". Si no se especifica la "Z", se mostrará la hora del equipo local en lugar de la hora UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Identity

Especifica el nombre del archivo de registro de uso.

Type:SPUsageDefinitionPipeBind
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-OverWrite

Sobrescribe el archivo de registro de diagnóstico si ya existe en la ruta de acceso especificada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Partial

No se usa.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Servers

Dirección o direcciones del servidor en el que se va filtrar.

Para obtener una lista de las direcciones válidas en la granja de servidores, use Get-SPServer | Seleccionar dirección.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 y hora válido y específico de la cultura del idioma de administración, como "16/2/2007, 12:15:12" para el español de España.

El valor predeterminado es una hora anterior a la hora actual del equipo local.

Si desea especificar la hora UTC, deberá agregar una "Z" al final del parámetro. Por ejemplo: "15-06-2016, 03:29:18.199 Z". Si no se especifica la "Z", se mostrará la hora del equipo local en lugar de la hora UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

Entradas

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Salidas

System.Object