Partager via


Get-MailboxRestoreRequestStatistics

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

Utilisez l’applet de commande Get-MailboxRestoreRequestStatistics pour afficher des informations détaillées sur les demandes de restauration.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

IdentityOnPremises

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [<CommonParameters>]

IdentityCloud

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-IncludeReport]
    [-IncludeSkippedItems]
    [-DiagnosticInfo <String>]
    [-ReportOnly]
    [<CommonParameters>]

MigrationMRSInstance

Get-MailboxRestoreRequestStatistics
    -MRSInstance <Fqdn>
    [-DomainController <Fqdn>]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

MigrationRequestQueue

Get-MailboxRestoreRequestStatistics
    -RequestQueue <DatabaseIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

Description

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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-MailboxRestoreRequestStatistics -Identity "Tony\MailboxRestore1"

Cet exemple retourne les statistiques par défaut pour la demande de restauration avec l’identité Tony\MailboxRestore1. Le type d’informations retournées par défaut inclut le nom, la boîte aux lettres, la status et le pourcentage d’achèvement.

Exemple 2

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore | Export-CSV \\SERVER01\RestoreRequest_Reports\Tony_Restorestats.csv

Cet exemple retourne les statistiques de la boîte aux lettres de Tony Smith et exporte le rapport vers un fichier CSV.

Exemple 3

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore -IncludeReport | Format-List

Cet exemple retourne des informations supplémentaires sur la demande de restauration de la boîte aux lettres de Tony Smith à l’aide du paramètre IncludeReport et en canalisant les résultats vers la commande Format-List.

Exemple 4

Get-MailboxRestoreRequestStatistics -MRSInstance CAS01.contoso.com

Dans Exchange Server 2010 et 2013, cet exemple retourne des statistiques par défaut pour une demande de restauration en cours de traitement par le instance de MRS s’exécutant sur le serveur CAS01. Cette commande retourne uniquement des informations pour les demandes de restauration en cours de traitement par un instance de MRS. Si le serveur d’accès au client a fini de traiter toutes les demandes de restauration, aucune information n’est renvoyée. Cette commande est destinée au débogage uniquement et ne doit être exécutée que si le personnel du support technique le demande.

Exemple 5

Get-MailboxRestoreRequest -Status Failed | Get-MailboxRestoreRequestStatistics -IncludeReport | Format-List > C:\Reports\AllRestoreReports.txt

Cet exemple retourne des informations supplémentaires pour toutes les demandes de restauration dont le status est Failed à l’aide du paramètre IncludeReport, puis enregistre les informations dans le fichier texte C:\Reports\AllRestoreReports.txt.

Paramètres

-Diagnostic

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DiagnosticArgument

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DiagnosticInfo

Applicable : Exchange Online

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 du service clientèle et du support technique Microsoft pour résoudre les problèmes.

Propriétés des paramètres

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityCloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DomainController

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriétés des paramètres

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationMRSInstance
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Le paramètre Identity spécifie l’identité de la demande de restauration. Le paramètre Identity se compose de l’alias de la boîte aux lettres à restaurer et du nom qui a été spécifié lors de la création de la demande de restauration. L’identité de la demande de restauration utilise la syntaxe suivante : Alias\Name.

Si vous n’avez pas spécifié de nom pour la demande de restauration lors de sa création, Exchange a généré automatiquement le nom par défaut MailboxRestore. Exchange génère jusqu’à 10 noms, en commençant par MailboxRestore, puis MailboxRestoreX (où X = 1-9).

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

Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.

Propriétés des paramètres

Type:MailboxRestoreRequestIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
IdentityCloud
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IncludeReport

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
IdentityCloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludeSkippedItems

Applicable : Exchange Online

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

{{ Fill IncludeSkippedItems Description }}

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityCloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MRSInstance

Applicable : Exchange Server 2010

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 le service de réplication de boîtes aux lettres Microsoft Exchange (MRS) réside. 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.

Propriétés des paramètres

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MigrationMRSInstance
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ReportOnly

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriétés des paramètres

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IdentityOnPremises
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
IdentityCloud
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RequestGuid

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Le paramètre RequestGuid spécifie l’identificateur unique pour la demande de restauration. Pour localiser le GUID, utilisez la cmdlet Get-MailboxRestoreRequest.

Propriétés des paramètres

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MigrationMRSInstance
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MigrationRequestQueue
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RequestQueue

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriétés des paramètres

Type:DatabaseIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MigrationRequestQueue
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.