Get-CalendarDiagnosticLog

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre Credential spécifie le nom d’utilisateur et le mot de passe utilisés pour exécuter cette commande. En règle générale, vous utilisez ce paramètre dans des scripts ou lorsque vous avez besoin de fournir différentes informations d’identification qui ont les autorisations requises.

Une valeur pour ce paramètre nécessite l’applet de commande Get-Credential. Pour interrompre la commande et recevoir une invite à entrer les informations d’identification, utilisez la valeur (Get-Credential). Sinon, avant d’exécuter cette commande, stockez les informations d’identification dans une variable (par exemple, $cred = Get-Credential), puis utilisez le nom de cette variable name ($cred) pour ce paramètre. Pour plus d’informations, voir Get-Credential.

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Le paramètre EndDate indique la fin de la plage de dates définies.

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".

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

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.

Le paramètre Identity indique la boîte aux lettres qui contient les éléments de calendrier. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. 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)

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.

Vous pouvez utiliser ce paramètre uniquement avec le paramètre MeetingID.

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.

Le commutateur Latest indique si les données du journal de calendrier doivent être renvoyées uniquement pour l’élément de calendrier le plus récent. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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. L’utilisation de cette applet de commande est désormais limitée au serveur local.

Ce paramètre est fonctionnel uniquement dans Exchange 2010 et Exchange 2013.

Le paramètre LogLocation spécifie l’emplacement vers lequel exporter les éléments de calendrier dans les fichiers .msg. Vous pouvez spécifier un chemin d’accès local ou un chemin UNC (\\Server\Share). Si la valeur contient des espaces, placez-la entre guillemets (").

À l’emplacement que vous spécifiez, un sous-dossier est automatiquement créé pour la boîte aux lettres spécifiée qui contient les éléments de calendrier exporté. Par exemple, si vous spécifiez la valeur « C:\My Documents\Calendar Export » pour exporter des éléments de calendrier à partir de la boîte aux lettres de Shannon Steele, les fichiers .msg sont en fait stockés dans C:\My Documents\Calendar Export\ssteele@contoso.com.

Dans les organisations Exchange locales, vous pouvez utiliser l’applet de commande Get-CalendarDiagnosticAnalysis pour analyser les fichiers .msg exportés.

Remarque : les commandes qui utilisent ce paramètre peuvent échouer si l’élément de calendrier n’a pas de titre. Si vous recevez des erreurs lorsque vous utilisez ce paramètre, réexécutez la commande et remplacez ce paramètre par une redirection vers un fichier (| Set-Content -Path « C:\My Documents\Calendar Export ») ou remplacez la sortie par une variable PowerShell.

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.

Pour trouver cette valeur, il est plus simple de rechercher d’abord l’élément de calendrier à l’aide des paramètres Subject, StartDate et EndDate. Une fois que vous avez trouvé l’élément de calendrier souhaité, vous pouvez utiliser sa valeur CleanGlobalObjectId pour le paramètre MeetingID dans les commandes ultérieures.

N’utilisez pas ce paramètre avec le paramètre Subject, car la valeur du paramètre MeetingID est prioritaire.

Ce paramètre est disponible uniquement dans Exchange sur site.

Le commutateur ReadFromDomainController spécifie quelles informations doivent être lues à partir d’un contrôleur de domaine dans le domaine de l’utilisateur. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

La commande : Set-AdServerSettings -ViewEntireForest $true pour inclure tous les objets dans la forêt, nécessite le commutateur ReadFromDomainController. Sinon, la commande peut utiliser un catalogue global qui contient des informations obsolètes. En outre, vous devrez peut-être exécuter plusieurs itérations de la commande avec le commutateur ReadFromDomainController pour obtenir les informations.

Par défaut, l’étendue du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

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

Le paramètre StartDate indique le début de la plage de dates définies.

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".

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.

N’utilisez pas ce paramètre avec le paramètre MeetingID, car la valeur du paramètre MeetingID est prioritaire.