Merge-SPUsageLog

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2016, SharePoint Server 2019

Restituisce record dai file di log sull'utilizzo.

Sintassi

Merge-SPUsageLog
     [-Identity] <SPUsageDefinitionPipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-DiagnosticLogPath <String>]
     [-EndTime <DateTime>]
     [-OverWrite]
     [-Partial]
     [-Servers <String[]>]
     [-StartTime <DateTime>]
     [<CommonParameters>]

Descrizione

Il cmdlet Merge-SPUsageLog restituisce record dai file di log sull'utilizzo in ogni server della farm che corrisponde ai criteri impostati e scrive i risultati nella pipeline.

Il comando consente di raccogliere, filtrare e aggregare base di log in base a criteri specificati dall'utente. È opportuno definire un filtro usando i parametri StartTime e EndTime al fine di ottimizzare le prestazioni del cmdlet.

È necessario specificare almeno un tipo di utilizzo. Per informazioni sui tipi di utilizzo validi, vedere Get-SPUsageDefinition.

Questo cmdlet richiede l'abilitazione della comunicazione remota di PowerShell.

Esempio

Esempio 1

Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1

Unisce il log utilizzo per la definizione di utilizzo 'Processi timer' dal server specificato e gli output alla console di PowerShell.

Parametri

-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 2016, SharePoint Server 2019

-DiagnosticLogPath

Consente di specificare il file nel quale scrivere le informazioni di diagnostica. È supportato un percorso relativo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Il valore predefinito è l'ora corrente.

Per specificare l'ora UTC, è necessario aggiungere una lettera "Z" alla fine del parametro. Ad esempio, "2016-06-15 03:29:18.199 Z". Se non viene specificata la lettera "Z", viene visualizzata l'ora del computer locale invece di quella UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Identity

Consente di specificare il nome del file di log sull'utilizzo.

Type:SPUsageDefinitionPipeBind
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-OverWrite

Sovrascrive il file di log di diagnostica, se esiste già nel percorso specificato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Partial

Non utilizzata.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Servers

L'indirizzo del server oppure gli indirizzi ai quali applicare il filtro.

Per ottenere un elenco di indirizzi validi per la farm, utilizzare Get-SPServer | Select Address.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Per specificare l'ora UTC, è necessario aggiungere una lettera "Z" alla fine del parametro. Ad esempio, "2016-06-15 03:29:18.199 Z". Se non viene specificata la lettera "Z", viene visualizzata l'ora del computer locale invece di quella UTC.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

Input

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft. SharePoint.PowerShell.SPAssignmentCollection

Output

System.Object