Compartilhar via

Merge-SPLogFile

Módulo:
SharePointServer module

Combina as entradas de log de rastreamento de todos os computadores do farm em um único arquivo de log no computador local.

Sintaxe

Default (Padrão) 

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

O cmdlet Merge-SPLogFile retorna os registros dos arquivos de log de rastreamento Serviço de Log Unificado (ULS) em cada servidor do farm que corresponde aos critérios e grava os resultados em um novo arquivo de log no computador local. Se não forem devolvidos resultados, é escrito um aviso na janela da consola do Windows PowerShell.

Recomendamos que você filtre usando os parâmetros StartTime e EndTime para otimizar o desempenho desse cmdlet. Alguns parâmetros de filtragem (como Process, Area, Category, EventID e Message) dão suporte a curingas.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite

Este exemplo mescla a última hora de dados de log de todos os computadores do farm sem filtro.

EXEMPLO 2

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area Search

Este exemplo mescla a última hora de dados de log da área Search.

EXEMPLO 3

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"

Este exemplo mescla a última hora de dados de log das áreas SharePoint Foundation e Web Analytics Services.

EXEMPLO 4

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level High

Este exemplo mescla os dados do log de nível High ou superior.

EXEMPLO 5

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"

Este exemplo mescla os dados de log de eventos em um determinado intervalo de tempo, o que é específico da cultura dos EUA.

EXEMPLO 6

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"

Este exemplo mescla os dados de log de eventos com o texto de mensagem permission changed.

EXEMPLO 7

Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"

Este exemplo mescla os dados de log de todos os trabalhos de timer de pesquisa.

EXEMPLO 8

Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"

Este exemplo mostra como mesclar os dados de log de todos os nomes de usuário que possuem o formato contoso\joeuser ou Contoso/joeuser.

Parâmetros

-Area

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome da área a ser filtrada.

O tipo deve ser um nome válido (por exemplo, SharePoint Foundation).

Há suporte para o uso de curingas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Category

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ID da categoria a ser filtrada.

O tipo deve ser um nome de categoria válido (por exemplo, category1).

Há suporte para o uso de curingas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContextFilter

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica um filtro para entradas de rastreamento em um determinado contexto no formato key=value, por exemplo, user=contoso\joeuser.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Correlation

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ID de correlação a ser filtrada. O tipo deve ser um GUID válido, no formato F0BB0790-4323-A153-096F-ABCDC80E24D4.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EndTime

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

O tipo deve ter um formato de Data/Hora específico da cultura do idioma administrativo, como, por exemplo, 2/16/2007 12:15:12 para Inglês-EUA.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EventID

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ID de Evento a ser filtrada. Há suporte para o uso de curingas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExcludeNestedCorrelation

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exclui valores de correlação aninhados nos resultados. Este parâmetro é usado apenas quando os resultados são filtrados com o uso do parâmetro ContextFilter.

Por predefinição, os registos devolvidos a partir do parâmetro ContextFilter incluem todos os registos relacionados, além dos registos que correspondem ao filtro. Especificar esta opção inclui apenas os registos que correspondem ao filtro e exclui quaisquer registos relacionados.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Level

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do nível a ser filtrado.

Os resultados incluem o nível especificado e as informações mais graves.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Message

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o texto da mensagem a ser filtrado.

O tipo deve ser um texto válido. Texto com espaços deve ser colocado entre aspas, por exemplo "Isso é um teste."

Há suporte para o uso de curingas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Overwrite

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

O tipo deve ter um dos seguintes valores:

  • $True
  • $False

O valor padrão é $False.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o caminho e o nome do arquivo no qual o arquivo de log mesclado deverá ser gravado. Caminhos relativos são compatíveis.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Process

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o nome do processo a ser filtrado.

Há suporte para o uso de curingas.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StartTime

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

O tipo deve ter um formato de Data/Hora específico da cultura do idioma administrativo, como, por exemplo, 2/16/2007 12:15:12 para Inglês-EUA.

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

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ThreadID

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a ID do thread a ser filtrado.

O tipo deve ser um inteiro válido de 0 a 4.294.967.295.

Propriedades do parâmetro

Tipo:

UInt32[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.