Compartir a través de


Merge-SPUsageLog

Devuelve los registros de los archivos de registro de uso.

Sintaxis

Default (Es el valor predeterminado).

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

Aplicable: 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

-DiagnosticLogPath

Aplicable: SharePoint Server 2016, SharePoint Server 2019

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

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

-EndTime

Aplicable: 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 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.

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

-Identity

Aplicable: SharePoint Server 2016, SharePoint Server 2019

Especifica el nombre del archivo de registro de uso.

Propiedades del parámetro

Tipo:SPUsageDefinitionPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OverWrite

Aplicable: SharePoint Server 2016, SharePoint Server 2019

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

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

-Partial

Aplicable: SharePoint Server 2016, SharePoint Server 2019

No se usa.

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

-Servers

Aplicable: SharePoint Server 2016, SharePoint Server 2019

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.

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

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.

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.

Entradas

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Salidas

System.Object