Get-MailboxImportRequestStatistics

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-MailboxImportRequestStatistics permet d'afficher des informations détaillées sur les demandes d'importation.

Cette applet de commande est disponible uniquement dans le rôle Importation d’exportation de boîte aux lettres et, par défaut, le rôle n’est attribué à aucun groupe de rôles. Pour utiliser cette cmdlet, vous devez ajouter le rôle d’importation et d’exportation de boîte aux lettres à un groupe de rôles (par exemple, au groupe de rôles Gestion de l’organisation). Pour plus d'informations, consultez la section relative à l'Ajouter un rôle à un groupe de rôles.

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-MailboxImportRequestStatistics
   [-Identity] <MailboxImportRequestIdParameter>
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-ReportOnly]
   [<CommonParameters>]
Get-MailboxImportRequestStatistics
   [-Identity] <MailboxImportRequestIdParameter>
   [-DiagnosticInfo <String>]
   [-IncludeReport]
   [-IncludeSkippedItems]
   [-ReportOnly]
   [<CommonParameters>]
Get-MailboxImportRequestStatistics
   -MRSInstance <Fqdn>
   [-DomainController <Fqdn>]
   [-RequestGuid <Guid>]
   [<CommonParameters>]
Get-MailboxImportRequestStatistics
   -RequestQueue <DatabaseIdParameter>
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-ReportOnly]
   [-RequestGuid <Guid>]
   [<CommonParameters>]

Description

Vous pouvez rediriger la cmdlet Get-MailboxImportRequestStatistics à partir de la cmdlet Get-MailboxImportRequest.

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-MailboxImportRequestStatistics -Identity Tony\MailboxImport1

Cet exemple renvoie les données statistiques par défaut pour la deuxième demande d'importation de Tony Smith. Le type d’informations retournées par défaut inclut le nom, la boîte aux lettres et l’état.

Exemple 2

Get-MailboxImportRequestStatistics -Identity Tony\MailboxImport1 | Export-CSV \\SERVER01\ImportRequest_Reports\Tony_Importstats.csv

Cet exemple renvoie des données statistiques détaillées sur la deuxième demande d'importation pour la boîte aux lettres de Tony Smith et exporte le rapport dans un fichier .csv.

Exemple 3

Get-MailboxImportRequestStatistics -Identity Tony\LegalHold -IncludeReport | Format-List

Cet exemple renvoie des informations supplémentaires sur la demande d'importation pour la boîte aux lettres de Tony Smith. Pour cela, il utilise le paramètre IncludeReport et oriente les résultats vers la commande Format-List.

Exemple 4

Get-MailboxImportRequestStatistics -MRSInstance CAS01.contoso.com

Dans Exchange Server 2010, cet exemple retourne des statistiques par défaut pour une demande d’importation qui a été traitée par l’instance de MRS en cours d’exécution sur le serveur CAS01.

Exemple 5

Get-MailboxImportRequest -Status Failed | Get-MailboxImportRequestStatistics -IncludeReport | Format-List > AllImportReports.txt

Cet exemple renvoie des informations supplémentaires pour toutes les demandes d'importation affichant un état Failed. Il utilise pour cela le paramètre IncludeReport, puis enregistre les informations dans le fichier texte AllImportReports.txt.

Paramètres

-Diagnostic

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

Le commutateur Diagnostic indique si des informations extrêmement détaillées doivent être renvoyées dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

En règle générale, vous utilisez ce commutateur uniquement à la demande du Support technique et Service clientèle Microsoft pour résoudre les problèmes.

Type:SwitchParameter
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

-DiagnosticArgument

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

Le paramètre DiagnosticArgument modifie les résultats qui sont renvoyés à l’aide du commutateur Diagnostic. En règle générale, vous utilisez le commutateur Diagnostic et le paramètre DiagnosticArgument uniquement à la demande du Support technique et Service clientèle Microsoft pour résoudre les problèmes.

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

-DiagnosticInfo

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

En règle générale, vous utilisez le paramètre DiagnosticInfo uniquement à la demande de Microsoft Service clientèle et support technique pour résoudre les problèmes.

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

-DomainController

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie l’identité de la demande d’importation. Par défaut, les demandes d’importation sont nommées <alias>\MailboxImportX (où X = 0-9). Si vous avez spécifié un nom lors de la création de la demande d’importation, utilisez la syntaxe suivante : Alias\Name.

Remarque : Dans Exchange Online, l’alias d’une boîte aux lettres supprimée de manière réversible peut correspondre à l’alias d’une boîte aux lettres active. Pour garantir l’unicité, utilisez la valeur RequestGuid de la sortie de l’applet de commande Get-MailboxImportRequest pour la valeur de ce paramètre.

Type:MailboxImportRequestIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeReport

Le commutateur IncludeReport spécifie s’il faut renvoyer des détails supplémentaires pouvant servir à la résolution des problèmes. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSkippedItems

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

{{ Fill IncludeSkippedItems Description }}

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

-MRSInstance

Ce paramètre n'est disponible que dans Exchange Server 2010.

Le paramètre MRSInstance spécifie le nom de domaine complet (FQDN) du serveur d’accès au client sur lequel réside le service de réplication de boîte aux lettres Exchange Microsoft (MRS). Lorsque vous utilisez ce paramètre, tous les enregistrements sont renvoyés pour cette instance du service de réplication de boîtes aux lettres.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres Identity ou RequestQueue.

Type:Fqdn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ReportOnly

Le commutateur ReportOnly retourne les résultats sous la forme d’un tableau d’entrées de rapport (chaînes encodées). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-RequestGuid

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

Le paramètre RequestGuid (avec le paramètre RequestQueue) spécifie l’identificateur unique de la demande d’importation. Pour rechercher le GUID de la demande d'importation, utilisez la cmdlet Get-MailboxImportRequest.

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RequestQueue

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

Ce paramètre est destiné au débogage uniquement.

Le paramètre RequestQueue identifie la requête en fonction de la base de données de boîtes aux lettres dans laquelle la demande est exécutée. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.