Get-MailboxRestoreRequest
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
Utilisez l’applet de commande Get-MailboxRestoreRequest pour afficher l’état détaillé d’une demande de restauration en cours lancée à l’aide de l’applet de commande New-MailboxRestoreRequest.
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-MailboxRestoreRequest
[[-Identity] <MailboxRestoreRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-MailboxRestoreRequest
[-BatchName <String>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-SourceDatabase <DatabaseIdParameter>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-TargetDatabase <DatabaseIdParameter>]
[-TargetMailbox <MailboxOrMailUserIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Description
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-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"Cet exemple retourne l’état de la demande de restauration en cours et en file d’attente avec l’identité ayla\MailboxRestore, où Ayla est le prénom de l’utilisateur.
Exemple 2
Get-MailboxRestoreRequest -TargetDatabase MBD01Dans Exchange Server 2010, cet exemple retourne l’état des demandes de restauration en cours et mises en file d’attente qui sont restaurées dans la base de données cible MBD01.
Exemple 3
Get-MailboxRestoreRequest -RequestQueue MBD01Cet exemple retourne l’état des demandes de restauration en cours et en file d’attente qui sont restaurées dans la base de données de boîtes aux lettres MBD01.
Exemple 4
Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $trueCet exemple retourne toutes les demandes de restauration portant le nom RestoreToMBD01 où la demande de restauration a été suspendue.
Paramètres
-BatchName
Le paramètre BatchName spécifie le nom donné à un lot de demandes de restauration.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
| Type: | String |
| 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 |
-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 |
-HighPriority
Le paramètre HighPriority filtre les résultats en fonction de la valeur Priority qui a été affecté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 Retourne les requêtes qui ont été créées avec la valeur de priorité High, Higher, Highest ou Emergency.
- $false Retourne les requêtes qui ont été créées avec la valeur de priorité Normal, Faible, Inférieur ou Inférieur.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
| Type: | Boolean |
| 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 |
-Identity
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 le paramètre Name.
| Type: | MailboxRestoreRequestIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Le paramètre Name spécifie que toute demande de restauration qui porte le nom spécifié est retournée.
Utilisez ce paramètre pour effectuer une recherche sur le nom que vous avez fourni lors de la création de la demande de restauration.
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 le paramètre Identité.
| Type: | String |
| 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 |
-RequestQueue
Ce paramètre est disponible uniquement dans Exchange sur site.
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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
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.
| Type: | Unlimited |
| 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 |
-SourceDatabase
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre SourceDatabase spécifie que l’applet de commande doit retourner uniquement 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 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Status
Le paramètre Status filtre les résultats en fonction de l’état. Vous pouvez utiliser les valeurs suivantes :
- AutoSuspended
- Terminé
- CompletedWithWarning
- CompletionInProgress
- Échec
- InProgress
- En file d’attente
- Réessayer
- Suspendu
- Synchronisé
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
| Type: | RequestStatus |
| 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 |
-Suspend
Le paramètre Suspend spécifie s’il faut retourner les demandes qui ont été suspendues. L’entrée valide pour ce paramètre est $true ou $false.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
| Type: | Boolean |
| 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 |
-TargetDatabase
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre TargetDatabase spécifie que l’applet de commande doit uniquement retourner les demandes de restauration pour les boîtes aux lettres qui résident sur la base de données cible. 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-TargetMailbox
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)
- DN Exchange hérité
- Adresse SMTP
- Alias
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
| Type: | MailboxOrMailUserIdParameter |
| 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 |
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.