Partager via


Get-CalendarDiagnosticObjects

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez l’applet de commande Get-CalendarDiagnosticObjects pour collecter une plage de journaux de calendrier. Les journaux de diagnostic du calendrier suivent les données d’événements importants liés au calendrier pour chaque boîte aux lettres et peuvent être utilisés pour résoudre les problèmes de calendrier qui se produisent dans les boîtes aux lettres. Les journaux suivent tous les éléments de calendrier et les messages de réunion.

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-CalendarDiagnosticObjects
   [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
   [-AutoRequeryOnMeetingId <Boolean>]
   [-ConfigurationName <String>]
   [-CustomPropertyNames <String[]>]
   [-EndDate <ExDateTime>]
   [-EntryId <String>]
   [-EwsId <String>]
   [-ExactMatch <Boolean>]
   [-ItemClass <String[]>]
   [-ItemIds <String[]>]
   [-MaxResults <Int32>]
   [-MeetingId <String>]
   [-ODataId <String>]
   [-ResultSize <Unlimited>]
   [-ShouldBindToItem <Boolean>]
   [-ShouldDecodeEnums <Boolean>]
   [-ShouldFetchAttendeeCollection <Boolean>]
   [-ShouldFetchRecurrenceExceptions <Boolean>]
   [-StartDate <ExDateTime>]
   [-Subject <String>]
   [<CommonParameters>]

Description

Certaines des propriétés les plus intéressantes renvoyées dans les résultats sont les suivantes :

  • AppointmentState : 1 = Le rendez-vous est une réunion, 2 = Le rendez-vous a été reçu, 4 = Le rendez-vous a été annulé et 8 = le rendez-vous est un rendez-vous transféré.
  • CalendarLogTriggerAction : action effectuée sur l’élément (par exemple, Créer ou Mettre à jour).
  • ClientInfoString : entité qui a apporté la modification (par exemple, Client=OWA;<AdditionalDetails>, Client=WebServices;<AdditionalDetails>;, ou Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;).
  • MeetingRequestType : 1 = Le message de réunion est une demande de réunion, 65536 = Le message de réunion est une mise à jour complète d’une réunion existante, 131072 = Le message de réunion est une mise à jour d’information d’une réunion existante, 262144 = Le message de réunion est une mise à jour sans assistance, 524288 = La mise à jour est obsolète ou 1048576 = Le message de réunion est transféré à un délégué, et la copie est marquée comme informationnelle.
  • OriginalLastModifiedTime : utilisé comme champ de tri principal pour trier les événements.
  • ResponseType : 0 = L’organisateur n’a pas reçu de réponse, 1 = La copie de l’organisateur de la réunion, 2 = Provisoire, 3 = Accepter, 4 = Refuser ou 5 = Le participant n’a pas répondu.
  • ResponsibleUserName : valeur LegacyExchangeDN de l’utilisateur qui a apporté la modification (par exemple, /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant ou /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin).

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

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

Cet exemple récupère les journaux de diagnostic du calendrier dans la boîte aux lettres de Pedro Pizarro pour tous les éléments dont l’objet (« Subject ») correspond exactement à Team Meeting.

Exemple 2

$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoString

Il s’agit de la même chose que l’exemple précédent, mais les résultats sont désormais triés par heure de dernière modification d’origine.

Exemple 3

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49

Cet exemple récupère les journaux de diagnostic du calendrier pour la boîte aux lettres de Pedro Pizarro pour une réunion ayant l’ID d’objet global unique spécifié.

Exemple 4

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformation

Cet exemple retourne des informations de diagnostic pour les réunions avec l’objet Team Lunch dans la boîte aux lettres de Pedro Pizarro qui ont été modifiées au mois de juillet 2018, et exporte les résultats dans le fichier C:\Mes documents\Team Lunch Meeting.csv.

Paramètres

-AutoRequeryOnMeetingId

{{ Fill AutoRequeryOnMeetingId Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConfigurationName

{{ Fill ConfigurationName Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CustomPropertyNames

Le paramètre CustomPropertyNames renvoie la propriété personnalisée d’élément de calendrier spécifiée dans les résultats. Pour connaître les valeurs valides, consultez Valeurs du paramètre CustomPropertyNames dans Exchange Online PowerShell.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EndDate

Le paramètre EndDate spécifie la date de fin de la plage de dates pour la propriété OriginalLastModifiedTime (lors de la dernière modification de la réunion, pas de création).

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Type:ExDateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EntryId

Le paramètre EntryID filtre les résultats en fonction de la valeur de propriété EntryID spécifiée, ce qui correspond à la propriété MAPI PR_ENTRYID.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EwsId

{{ Fill EwsId Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExactMatch

Le paramètre ExactMatch spécifie si une correspondance exacte ou une correspondance partielle doit être utilisée pour les valeurs de texte spécifiées pour le paramètre Subject. Les valeurs valides sont les suivantes :

  • $true : la recherche d’objet utilise une correspondance exacte et recherche tous les éléments de calendrier dans la boîte aux lettres. Par exemple, si vous recherchez « budget », la recherche recherche les éléments qui ont « budget » n’importe où dans le sujet, mais pas « budgétisation ».
  • $false : la recherche d’objet utilise une correspondance partielle et recherche un maximum de 1 000 éléments de calendrier dans la boîte aux lettres. Par exemple, si vous recherchez « budget », la recherche recherche les éléments qui ont « budget » et « budgétisation » n’importe où dans le sujet. Il s’agit de la valeur par défaut.

Une recherche de correspondance partielle d’objet peut ne pas renvoyer tous les éléments de calendrier pertinents. Essayez d’utiliser une recherche de correspondance exacte d’objet pour obtenir des résultats plus précis.

Vous utilisez ce paramètre uniquement avec le paramètre Subject.

La valeur de ce paramètre est ignorée lorsque vous utilisez le paramètre MeetingId.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Le paramètre Identity spécifie la boîte aux lettres ou le groupe Microsoft 365 dont vous souhaitez afficher le calendrier. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique la boîte aux lettres ou le groupe Microsoft 365. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse e-mail
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Type:UnifiedGroupOrUserMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ItemClass

Le paramètre ItemClass filtre les résultats en fonction de la valeur de propriété MessageClass spécifiée de l’élément de calendrier (par exemple, IPM.Appointment). Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ItemIds

Le paramètre ItemIds filtre les résultats par ID d’élément. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MaxResults

{{ Fill MaxResults Description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MeetingId

Le paramètre MeetingId filtre les résultats en fonction de l’identificateur global unique de l’élément de calendrier. La valeur est la propriété CleanGlobalObjectId de l’élément de calendrier disponible dans la sortie de cette applet de commande, ou à l’aide d’autres outils d’examen MAPI. Un exemple de valeur est 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Cette valeur est constante pendant toute la durée de vie de l’élément de calendrier.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ODataId

{{ Fill ODataId Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

Ce paramètre détermine le nombre de résultats retournés par l’applet de commande. La valeur maximale est 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldBindToItem

Le paramètre ShouldBindToItem indique s’il est nécessaire de tronquer ou non des valeurs de propriétés volumineuses diffusées en continu (par exemple, AppointmentRecurrenceBlob). Les valeurs valides sont les suivantes :

  • $true : les valeurs des propriétés streamables volumineuses ne sont pas tronquées. La valeur complète est donc retournée.
  • $false : les valeurs des propriétés streamables volumineuses sont tronquées. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldDecodeEnums

{{ Fill ShouldDecodeEnums Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldFetchAttendeeCollection

{{ Fill ShouldFetchAttendeeCollection Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShouldFetchRecurrenceExceptions

Le paramètre ShouldFetchRecurrenceExceptions indique si des exceptions à des réunions périodiques doivent être incluses. Les valeurs valides sont les suivantes :

  • $true : incluez des exceptions aux réunions périodiques. Si vous utilisez cette valeur, vous devez également utiliser le paramètre ItemIds.
  • $false : n’incluez pas d’exceptions aux réunions périodiques. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

Le paramètre StartDate spécifie la date de début de la plage de dates de la propriété OriginalLastModifiedTime (lors de la dernière modification de la réunion, pas de création).

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Type:ExDateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Subject

Le paramètre Subject identifie les éléments de calendrier en fonction du texte spécifié dans le champ Subject. Les valeurs de texte que vous spécifiez ne respectent pas la casse. Si la valeur contient des espaces, placez-la entre guillemets. Vous pouvez décider d’utiliser ou non une correspondance exacte à l’aide du paramètre ExactMatch.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online