Merge-SPLogFile

  • Riferimento
Modulo:
sharepoint-server
Si applica a:
SharePoint Server Subscription Edition

Combina le voci del registro di traccia di tutti i computer della farm in un singolo file di registro nel computer locale.

Sintassi

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>]

Descrizione

Il cmdlet Merge-SPLogFile restituisce i record dei file di registro di traccia ULS (Unified Logging Service) di ogni server della farm corrispondenti ai criteri specificati, quindi scrive i risultati in un nuovo file di registro nel computer locale. Se non vengono restituiti risultati, viene scritto un avviso nella finestra della console di Windows PowerShell.

È consigliabile applicare un filtro mediante i parametri StartTime ed EndTime per ottimizzare le prestazioni del cmdlet. Alcuni parametri di filtro, come Process, Area, Category, EventID e Message, supportano i caratteri jolly.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

--------------ESEMPIO 1-----------------

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

Questo esempio consente di unire i dati dei registri dell'ultima ora da tutti i computer della farm senza applicare filtri.

--------------ESEMPIO 2-----------------

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

Questo esempio consente di unire i dati dei registri dell'ultima ora dall'area Search.

--------------ESEMPIO 3-----------------

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

Questo esempio consente di unire i dati dei registri dell'ultima ora dalle aree SharePoint Foundation e Web Analytics Services.

--------------ESEMPIO 4-----------------

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

Questo esempio consente di unire i dati dei registri di livello High o superiore.

--------------ESEMPIO 5-----------------

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

Questo esempio consente di unire i dati dei registri per gli eventi in un particolare intervallo di tempo specifico della lingua per gli Stati Uniti.

--------------ESEMPIO 6-----------------

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

Questo esempio consente di unire i dati dei registri per gli eventi con permission changed nel testo del messaggio.

--------------ESEMPIO 7-----------------

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

Questo esempio consente di unire i dati dei registri per tutti i processi timer della ricerca.

--------------ESEMPIO 8-----------------

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

In questo esempio viene illustrato come unire i dati dei registri per tutti i nomi utente in formato contoso\joeuser o Contoso/joeuser.

Parametri

-Area

Specifica il nome dell'area in base a cui filtrare.

Il tipo deve essere un nome valido, ad esempio SharePoint Foundation.

L'utilizzo dei caratteri jolly è supportato.

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

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-Category

Specifica l'ID di categoria in base a cui filtrare.

Il tipo deve essere un nome di categoria valido, ad esempio categoria1.

L'utilizzo dei caratteri jolly è supportato.

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

-ContextFilter

Specifica un filtro per individuare le voci di traccia in un particolare contesto nel formato chiave=valore, ad esempio user=contoso\luca.

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

-Correlation

Specifica l'ID di correlazione in base a cui filtrare. Il tipo deve essere un GUID valido nel 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

Specifica l'ora di fine delle voci di registro da restituire.

Il tipo deve essere un valore in formato DateTime valido specifico della lingua di amministrazione, ad esempio 16/02/2007 12.15.12 per l'italiano.

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

-EventID

Specifica l'ID evento in base a cui filtrare. L'utilizzo dei caratteri jolly è supportato.

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

-ExcludeNestedCorrelation

Esclude i valori di correlazione annidati nei risultati. Questo parametro viene utilizzato solo quando si filtrano i risultati mediante il parametro ContextFilter.

Per impostazione predefinita, i record restituiti dal parametro ContextFilter includono tutti i record correlati oltre ai record corrispondenti al filtro. Se si specifica questa opzione verranno inclusi solo i record corrispondenti al filtro, escludendo eventuali record correlati.

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

-Level

Specifica il nome del livello in base a cui filtrare.

I risultati includono le voci del livello specificato e tutte le voci con un livello di gravità superiore.

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

-Message

Specifica il testo del messaggio in base a cui filtrare.

Il tipo deve essere un testo valido. Le stringhe di testo con spazi devono essere racchiuse tra virgolette, ad esempio "Questa è una prova".

L'utilizzo dei caratteri jolly è supportato.

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

-Overwrite

Sovrascrive il file di registro se esiste già nel percorso specificato.

Il tipo deve essere uno dei valori seguenti:

  • $True
  • $False

Il valore predefinito è $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

Specifica il percorso e il nome del file in cui scrivere il file di registro unito. Sono supportati percorsi relativi.

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

-Process

Specifica il nome del processo in base a cui filtrare.

L'utilizzo dei caratteri jolly è supportato.

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

-StartTime

Specifica l'ora di inizio delle voci di registro da restituire.

Il tipo deve essere un valore in formato DateTime valido specifico della lingua di amministrazione, ad esempio 16/02/2007 12.15.12 per l'italiano.

Il valore predefinito è un'ora prima dell'orario corrente nel computer locale.

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

-ThreadID

Specifica l'ID del thread in base a cui filtrare.

Il tipo deve essere un numero intero valido compreso tra 0 e 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