Get-MailboxRestoreRequest
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-MailboxRestoreRequest pour afficher les status détaillées 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.
Syntaxe
Identity
Get-MailboxRestoreRequest
[[-Identity] <MailboxRestoreRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Filtering
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 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-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"
Cet exemple retourne la status 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 MBD01
Dans Exchange Server 2010, cet exemple retourne les status 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 MBD01
Cet exemple retourne le status 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 $true
Cet exemple retourne toutes les demandes de restauration portant le nom RestoreToMBD01 où la demande de restauration est suspendue.
Paramètres
-BatchName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é.
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
Filtering
| 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
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HighPriority
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é.
Propriétés des paramètres
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Filtering
| 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 le paramètre Name.
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
Identity
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é.
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
Filtering
| 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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é.
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
Filtering
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | Unlimited |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SourceDatabase
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 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é.
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
Filtering
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Status
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Le paramètre Status filtre les résultats en fonction de status. 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é.
Propriétés des paramètres
| Type: | RequestStatus |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Filtering
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Suspend
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é.
Propriétés des paramètres
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Filtering
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetDatabase
Applicable : Exchange Server 2010
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é.
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
Filtering
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetMailbox
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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é.
Propriétés des paramètres
| Type: | MailboxOrMailUserIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Filtering
| Position: | Named |
| Obligatoire: | False |
| 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.