Merge-SPLogFile
Combina as entradas de log de rastreamento de todos os computadores do farm em um único arquivo de log no computador local.
Syntax
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 nenhum resultado for retornado, um aviso será gravado na janela Windows PowerShell console.
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" -OverwriteEste 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 SearchEste 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 HighEste 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
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 |
-Category
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ContextFilter
Especifica um filtro para entradas de rastreamento em um determinado contexto no formato key=value, por exemplo, user=contoso\joeuser.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Correlation
Especifica a ID de correlação a ser filtrada. O tipo deve ser um GUID válido, no formato F0BB0790-4323-A153-096F-ABCDC80E24D4.
| Type: | Guid[] |
| 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 específico da cultura do idioma administrativo, como, por exemplo, 2/16/2007 12:15:12 para Inglês-EUA.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-EventID
Especifica a ID de Evento a ser filtrada. Há suporte para o uso de curingas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ExcludeNestedCorrelation
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 padrão, os registros retornados do parâmetro ContextFilter incluem todos os registros relacionados, além dos registros que correspondem ao filtro. Especificar essa opção inclui apenas os registros que correspondem ao filtro e exclui todos os registros relacionados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Level
Especifica o nome do nível a ser filtrado.
Os resultados incluem o nível especificado e as informações mais graves.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Message
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Overwrite
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
Especifica o caminho e o nome do arquivo no qual o arquivo de log mesclado deverá ser gravado. Caminhos relativos são compatíveis.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Process
Especifica o nome do processo a ser filtrado.
Há suporte para o uso de curingas.
| 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 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ThreadID
Especifica a ID do thread a ser filtrado.
O tipo deve ser um inteiro válido de 0 a 4.294.967.295.
| Type: | UInt32[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |