Get-CalendarDiagnosticAnalysis
Bien que cette applet de commande soit disponible dans Exchange local et dans le service cloud, elle fonctionne uniquement dans Exchange local.
Utilisez la cmdlet Get-CalendarDiagnosticAnalysis pour résoudre les problèmes de fiabilité en lien avec le calendrier. Vous pouvez utiliser cette cmdlet pour analyser les données de l’élément de calendrier enregistré dans les journaux de diagnostic de calendrier. Utilisez la cmdlet Get-CalendarDiagnosticLog pour transmettre les données d’élément de calendrier à cette cmdlet.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Get-CalendarDiagnosticAnalysis
-CalendarLogs <CalendarLog[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Get-CalendarDiagnosticAnalysis
-LogLocation <String[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Description
Les propriétés suivantes de l’élément de calendrier sont renvoyées dans la sortie par défaut de la cmdlet (lorsque le paramètre DetailLevel est défini sur Basic) :
- Heure du journal local
- ItemId
- NormalizedSubject
- StartTime
- EndTime
- CalendarLogTriggerAction
- ClientInfoString
- OriginalLastModifiedTime
- ClientIntent
- CleanGlobalObjectId
- ItemClass
- ParentDisplay
- Durée
- AppointmentRecurring
- SentRepresentingEmailAddress
- SenderEmailAddress
- SentRepresentingDisplayName
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F
Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"
Cet exemple obtient l’élément de calendrier spécifié à partir de la boîte aux lettres d’Oscar Evans, stocke l’élément sous forme de variable et écrit l’analyse avancée de l’élément dans un fichier CSV.
Pour l’analyse de base de l’élément, n’incluez pas le paramètre DetailLevel, ou utilisez la valeur Basic au lieu de Advanced.
Exemple 2
Get-CalendarDiagnosticAnalysis -LogLocation "C:\My Documents\Exported Calendar Logs\jkozma@contoso.com" -DetailLevel Advanced -OutputAs HTML | Set-Content -Path "C:\My Documents\Jasen Kozma Analysis.html"
Dans Exchange 2013, cet exemple analyse les éléments de calendrier précédemment exportés à partir de la boîte aux lettres de Jasen Kozma à l’aide de l’applet de commande Get-CalendarDiagnosticLog avec le paramètre LogLocation et écrit l’analyse avancée des éléments dans un fichier HTML.
Remarque : le paramètre LogLocation est disponible uniquement dans Exchange 2013. Pour spécifier l’emplacement des éléments de calendrier exportés dans Exchange 2016 ou Exchange 2019, consultez l’exemple 3.
Pour l’analyse de base des éléments, n’incluez pas le paramètre DetailLevel, ou utilisez la valeur Basic à la place de Advanced.
Exemple 3
$calitems = Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Budget Meeting"
ForEach($item in $calitems){$i++; Get-CalendarDiagnosticAnalysis -CalendarLogs $item -OutputAs HTML | Set-Content -Path ("\\FileServer01\Data\Jasen Kozma Analysis{0}.html" -f $i)}
Cet exemple analyse les éléments de calendrier qui ont été exportés à partir de la boîte aux lettres de Jasen Kozma à l’aide de l’applet de commande Get-CalendarDiagnosticLog et écrit l’analyse avancée de chaque élément dans un fichier HTML à l’aide d’un chemin UNC.
Pour l’analyse de base des éléments, n’incluez pas le paramètre DetailLevel, ou utilisez la valeur Basic à la place de Advanced.
Paramètres
-CalendarLogs
Le paramètre CalendarLogs spécifie l’élément de calendrier à analyser. Vous identifiez l’élément de calendrier en stockant la sortie de l’applet de commande Get-CalendarDiagnosticLog dans une variable et en utilisant cette variable pour la valeur de ce paramètre.
Par exemple, pour analyser la réunion avec l’objet « Réunion budgétaire de novembre » dans la boîte aux lettres de Shannon Steele, exécutez la commande $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch
, puis utilisez la valeur $Budget
de ce paramètre.
La valeur que vous utilisez pour ce paramètre doit identifier un seul élément. Pour identifier plusieurs éléments, consultez l’exemple 3.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre LogLocation.
Type: | CalendarLog[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DetailLevel
Le paramètre DetailLevel indique le niveau de détail à afficher dans la sortie d’analyse. Les valeurs valides sont les suivantes :
- Basic : valeur par défaut. Les propriétés d’élément de calendrier renvoyées sont répertoriées dans la description détaillée.
- Advanced : 37 propriétés d’élément de calendrier supplémentaires sont renvoyées. Vous devez utiliser cette valeur uniquement pour les informations de débogage détaillées.
Type: | AnalysisDetailLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-GlobalObjectId
Le paramètre GlobalObjectId indique l’identité de l’élément de calendrier à analyser. Dans Exchange 2013, vous pouvez utiliser ce paramètre avec le paramètre LogLocation pour spécifier l’élément de calendrier si l’emplacement contient plusieurs fichiers .msg exportés.
La propriété GlobalObjectId de la réunion utilise le même format que la propriété CleanGlobalObjectId (par exemple, 040000008200E00074C5B7101A82E00800000009421DCCD5046CD010000000000000000010000000010B0349F6B17454685E17D9F9512E71F) et la valeur des deux propriétés est probablement la même. Toutefois, la valeur de GlobalObjectId peut ne pas être identique pour toutes les instances de la même réunion dans plusieurs calendriers (par exemple, différents participants invités à différentes instances de la même réunion périodique).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LogLocation
Remarque : Ce paramètre a été supprimé d’Exchange 2016 et Exchange 2019 par la Mises à jour cumulative H1 2022, car il accepte les valeurs de chemin UNC. Pour spécifier les éléments de calendrier à analyser, utilisez le paramètre CalendarLogs.
Ce paramètre est fonctionnel uniquement dans Exchange 2013.
Le paramètre LogLocation spécifie l’emplacement des éléments de calendrier exportés à analyser. Vous pouvez spécifier un chemin d’accès local ou un chemin UNC (\\Server\Share\User
). Si la valeur contient des espaces, placez-la entre guillemets (").
Vous exportez les éléments de calendrier vers des fichiers .msg à l’aide de l’applet de commande Get-CalendarDiagnosticLog avec le paramètre LogLocation. Si le chemin d’accès contient plusieurs fichiers .msg, tous ces fichiers sont analysés lorsque vous exécutez Get-CalendarDiagnosticAnalysis.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre CalendarLogs.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Online |
-OutputAs
Le paramètre OutputAs indique le format de sortie de la commande. Les valeurs valides sont les suivantes :
- CSV (valeur par défaut)
- HTML
- XML
Type: | OutputType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.