Merge-SPUsageLog

  • Référence
Module:
SharePointServer
S’applique à:
SharePoint Server 2016, SharePoint Server 2019

Renvoie les enregistrements à partir de fichiers journaux d'utilisation.

Syntax

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

Description

L'applet de commande Merge-SPUsageLog renvoie les enregistrements des fichiers journaux d'utilisation de chaque serveur de la batterie de serveurs qui répondent aux critères et écrit les résultats sur le pipeline.

La commande regroupe, filtre et agrège des journaux en fonction des critères spécifiés par l'utilisateur. Nous vous recommandons de filtrer à l'aide des paramètres StartTime et EndTime pour optimiser les performances de l'applet de commande.

Vous devez spécifier au moins un type d'utilisation. Pour plus d'informations sur les types d'utilisation valides, consultez Get-SPUsageDefinition.

Cette applet de commande nécessite l’activation de la communication à distance PowerShell.

Exemples

Exemple 1

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

Fusionne le journal d’utilisation de la définition d’utilisation « Travaux du minuteur » du serveur spécifié et les sorties dans la console PowerShell.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

Spécifie le fichier sur lequel écrire les informations de diagnostic. Un chemin d'accès relatif est pris en charge.

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

Spécifie l'heure de fin des entrées du journal renvoyées.

Le type doit être un format date/heure valide propre à la culture de la langue d'administration. Par exemple 2/16/2007 12:15:12 pour Anglais-US.

La valeur par défaut est l'heure actuelle.

Si vous voulez spécifier l'heure UTC, vous devez ajouter un « Z » à la fin du paramètre. Par exemple, « 2016-06-15 03:29:18.199 Z ». Si vous ne spécifiez pas de « Z », l'heure de l'ordinateur local sera affichée à la place de l'heure 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

Spécifie le nom du fichier journal d’utilisation.

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

Remplace le fichier journal de diagnostic s’il existe déjà sous le chemin d’accès spécifié.

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 utilisé.

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’adresse ou les adresses de serveur sur lesquelles filtrer.

Pour obtenir la liste d’adresses valides dans la batterie de serveurs, utilisez Get-SPServer | Sélectionner une adresse.

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

Spécifie l'heure de début des entrées du journal renvoyées.

Le type doit être un format date/heure valide propre à la culture de la langue d'administration. Par exemple « 2/16/2007 12:15:12 » pour Anglais-US.

La valeur par défaut est une heure avant l'heure actuelle sur l'ordinateur local.

Si vous voulez spécifier l'heure UTC, vous devez ajouter un « Z » à la fin du paramètre. Par exemple, « 2016-06-15 03:29:18.199 Z ». Si vous ne spécifiez pas de « Z », l'heure de l'ordinateur local sera affichée à la place de l'heure 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

Entrées

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Sorties

System.Object