Merge-SPUsageLog
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 SPSERVER1Unisce 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