Merge-SPUsageLog
Retorna registros dos arquivos de log de uso.
Sintaxe
Default (Padrão)
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.
Este cmdlet requer que a Comunicação Remota do PowerShell esteja ativada.
Exemplos
Exemplo 1
Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1
Intercala o Registo de utilização das "Tarefas de Temporizador" da Definição de Utilização do servidor especificado e as saídas para a consola do PowerShell.
Parâmetros
-AssignmentCollection
Aplicável: 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 |
-DiagnosticLogPath
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Especifica o arquivo para o qual as informações de diagnóstico serão gravadas. Um caminho relativo é suportado.
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 |
-EndTime
Aplicável: 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 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.
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 |
-Identity
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Especifica o nome do arquivo de log.
Propriedades do parâmetro
| Tipo: | SPUsageDefinitionPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OverWrite
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Substitui o arquivo de log de diagnóstico se ele já existir no caminho especificado.
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 |
-Partial
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Não usado.
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 |
-Servers
Aplicável: SharePoint Server 2016, SharePoint Server 2019
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.
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 2016, SharePoint Server 2019
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.
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 |
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.
Entradas
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind
Microsoft.SharePoint.PowerShell.SPAssignmentCollection