Get-MailboxRestoreRequest

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-07-14

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

La cmdlet Get-MailboxRestoreRequest permet d’afficher l’état détaillé d’une demande de restauration en cours qui a été initiée à l’aide de la cmdlet New-MailboxRestoreRequest.

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

Get-MailboxRestoreRequest [-Identity <MailboxRestoreRequestIdParameter>] <COMMON PARAMETERS>

Get-MailboxRestoreRequest [-BatchName <String>] [-HighPriority <$true | $false>] [-Name <String>] [-RequestQueue <DatabaseIdParameter>] [-SourceDatabase <DatabaseIdParameter>] [-Status <None | Queued | InProgress | AutoSuspended | CompletionInProgress | Synced | Completed | CompletedWithWarning | Suspended | Failed>] [-Suspend <$true | $false>] [-TargetMailbox <MailboxOrMailUserIdParameter>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-DomainController <Fqdn>] [-ResultSize <Unlimited>]

Cet exemple renvoie l’état des demandes de restauration en cours et en file d’attente dont l’identité est ayla\MailboxRestore.

Get-MailboxRestoreRequest -Identity "ayla\MailboxRestore"

Cet exemple renvoie l’état des demandes de restauration en cours et en file d’attente qui sont restaurées vers la base de données de boîtes aux lettres MBD01.

Get-MailboxRestoreRequest -RequestQueue MBD01

Cet exemple renvoie toutes les demandes de restauration qui portent le nom RestoreToMBD01 et pour lesquelles la demande de restauration a été suspendue.

Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $true

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Entrée « Demande de restauration de boîte aux lettres » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

BatchName

Facultatif

System.String

Le paramètre BatchName spécifie le nom attribué à un lot de demandes de restauration.

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

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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.

HighPriority

Facultatif

System.Boolean

Le paramètre HighPriority filtre les résultats en fonction de la valeur Priority attribuée lors de la création de la demande. L’entrée valide pour ce paramètre est $true ou $false. Voici comment ces valeurs filtrent les résultats :

  • $true Renvoie les demandes créées avant la valeur PriorityHigh, Higher, Highest ou Emergency.

  • $false Renvoie les demandes créées avec la valeur PriorityNormal, Low, Lower ou Lowest.

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

Identity

Facultatif

Microsoft.Exchange.MailboxReplicationService.MailboxRestoreRequestIdParameter

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>\<nom>.

Si vous n’avez pas spécifié de nom pour la demande de restauration au moment de sa création, Exchange a automatiquement généré le nom par défaut MailboxRestore. Exchange génère un maximum de dix noms, en commençant par MailboxRestore, puis MailboxRestoreX (où X est une valeur comprise entre 1 et 9).

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

Name

Facultatif

System.String

Le paramètre Name spécifie que toute demande de restauration dont le nom est indiqué doit être renvoyée.

Utilisez ce paramètre pour rechercher le nom que vous avez attribué au moment de créer la demande de restauration.

Si vous n’avez pas spécifié de nom pour la demande de restauration au moment de sa création, Exchange a automatiquement généré le nom par défaut MailboxRestore. Exchange génère un maximum de dix noms, en commençant par MailboxRestore, puis MailboxRestoreX (où X est une valeur comprise entre 1 et 9).

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

RequestQueue

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre RequestQueue identifie la demande 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 :

  • Base de données GUID

  • Nom de la base de données

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

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

SourceDatabase

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre SourceDatabase indique que la cmdlet doit uniquement renvoyer les demandes de restauration pour les boîtes aux lettres restaurées à partir de la base de données source spécifiée. Vous pouvez utiliser les valeurs suivantes :

  • GUID de la base de données

  • Nom de la base de données

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

Status

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.RequestStatus

Le paramètre Status filtre les résultats en fonction de l’état. Vous pouvez utiliser les valeurs suivantes :

  • AutoSuspended

  • Completed

  • CompletedWithWarning

  • CompletionInProgress

  • Failed

  • InProgress

  • None

  • Queued

  • Suspended

  • Synced

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

Suspend

Facultatif

System.Boolean

Le paramètre Suspend indique si les demandes suspendues doivent être renvoyées. L’entrée valide pour ce paramètre est $true ou $false.

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

TargetMailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter

Le paramètre TargetMailbox spécifie l’identité de la boîte aux lettres cible. Vous pouvez utiliser les valeurs suivantes :

  • GUID

  • Nom unique (DN)

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • Nom unique Exchange hérité

  • Adresse SMTP

  • Alias

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

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.

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.

 
Afficher: