Condividi tramite

Merge-SPLogFile

Modulo:
SharePointServer module

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

Sintassi

Default (impostazione predefinita). 

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

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AssignmentCollection

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Category

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ContextFilter

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Correlation

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica l'ID di correlazione in base a cui filtrare. Il tipo deve essere un GUID valido nel formato F0BB0790-4323-A153-096F-ABCDC80E24D4.

Proprietà dei parametri

Tipo:

Guid[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EndTime

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EventID

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExcludeNestedCorrelation

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Level

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Message

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Overwrite

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Process

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome del processo in base a cui filtrare.

L'utilizzo dei caratteri jolly è supportato.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StartTime

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ThreadID

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:

UInt32[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.