Merge-SPUsageLog

  • Referência
Módulo:
sharepoint-server

Retorna registros dos arquivos de log de uso.

Syntax

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

Description

O cmdlet Merge-SPUsageLog retorna registros de arquivos de log de uso em cada servidor do farm que corresponda aos critérios e grave os resultados no pipeline.

O comando reúne, filtra e agrega logs com base em critérios especificados pelo usuário. Recomendamos filtrar usando os parâmetros StartTime e EndTime para otimizar o desempenho deste cmdlet.

Você deve especificar pelo menos um tipo de uso. Para obter informações sobre tipos de uso válidos, confira Get-SPUsageDefinition.

Esse cmdlet requer que o PowerShell Remoting seja habilitado.

Exemplos

------------Exampla 1 -----------

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

Mescla o log de uso para a definição de uso 'Trabalhos de temporizador' do servidor e saídas especificados para o console do PowerShell.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DiagnosticLogPath

Especifica o arquivo para o qual as informações de diagnóstico serão gravadas. Um caminho relativo é suportado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-EndTime

Especifica a hora de término das entradas de log retornadas.

O tipo deve ter um formato de Data/Hora válido, específico da cultura do idioma administrativo, como 16/2/2007 12:15:12 para português do Brasil.

O valor padrão é a hora atual.

Se quiser especificar o horário UTC, você deve adicionar "Z" ao final do parâmetro. Por exemplo, "2016-06-15 03:29:18.199 Z". Se "Z" não for especificado, a hora do computador local será exibida em vez de UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Especifica o nome do arquivo de log.

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

-OverWrite

Substitui o arquivo de log de diagnóstico se ele já existir no caminho especificado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Partial

Não usado.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Servers

O endereço do servidor ou endereços para filtrar.

Para obter uma lista de endereços válidos no farm, utilize Get-SPServer | Select Address.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-StartTime

Especifica a hora de início das entradas de log retornadas.

O tipo deve ter um formato de Data/Hora válido, específico da cultura do idioma administrativo, como 16/2/2007 12:15:12 para português do Brasil.

O valor padrão é uma hora antes do horário atual no computador local.

Se quiser especificar o horário UTC, você deve adicionar "Z" ao final do parâmetro. Por exemplo, "2016-06-15 03:29:18.199 Z". Se "Z" não for especificado, a hora do computador local será exibida em vez de UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

Entradas

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft. SharePoint.PowerShell.SPAssignmentCollection

Saídas

System.Object