Merge-SPLogFile
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" -OverwriteQuesto 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 SearchQuesto 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 HighQuesto 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |