Get-MailboxExportRequest
La cmdlet est disponible uniquement dans Exchange en local.
La cmdlet Get-MailboxExportRequest permet d’afficher l’état détaillé d’une demande d’exportation en cours qui a été lancée à l’aide de la cmdlet New-MailboxExportRequest.
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-MailboxExportRequest
[[-Identity] <MailboxExportRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Get-MailboxExportRequest
[-Mailbox <MailboxOrMailUserIdParameter>]
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>]
Get-MailboxExportRequest
[-Mailbox <MailboxLocationIdParameter>]
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>]
Description
Les critères de recherche pour la cmdlet Get-MailboxExportRequest correspondent à une instruction booléenne And. Si vous utilisez plusieurs paramètres, cela limite votre recherche et réduit vos résultats.
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-MailboxExportRequest -Identity "tony\DB01toPST"
Cet exemple renvoie l’état de la demande d’exportation en cours avec l’identité tony\DB01toPST.
Exemple 2
Get-MailboxExportRequest -Status InProgress -Database DB01
Dans Exchange Server 2010, cet exemple retourne l’état des demandes d’exportation en cours pour les boîtes aux lettres ou les archives qui résident sur la base de données DB01.
Exemple 3
Get-MailboxExportRequest -BatchName "Attachment_CompanyReport" -Status Completed
Cet exemple renvoie l’état des demandes d’exportation dans le lot Attachment_CompanyReport qui a été finalisé.
Exemple 4
Get-MailboxExportRequest -Name "DB01toPST" -Suspend $true
Cet exemple renvoie toutes les demandes d’exportation qui portent le nom DB01toPST et pour lesquelles l’exportation a été suspendue.
Paramètres
-BatchName
Le paramètre BatchName spécifie le nom attribué à une demande d’exportation de lot.
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 |
-Database
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre Database spécifie la base de données dans laquelle réside la boîte aux lettres ou l’archive de l’utilisateur. 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 |
-DomainController
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 |
-Identity
Le paramètre Identity spécifie l’identité de la demande d’exportation. Par défaut, les demandes d’exportation sont nommées <alias>\MailboxExportX
(où X = 0-9). Si vous avez spécifié un nom pour la demande d’exportation lors de la création de la demande à l’aide de l’applet de commande New-MailboxExportRequest, utilisez la syntaxe suivante : Alias\Name
. Exchange précède automatiquement la requête avec l’alias de la boîte aux lettres.
Ce paramètre ne peut pas être utilisé avec les paramètre suivants :
- BatchName
- Boîte aux lettres
- Nom
- Statut
- Suspendre
- HighPriority
Type: | MailboxExportRequestIdParameter |
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 |
-Mailbox
Le paramètre Mailbox filtre les résultats en fonction de la boîte aux lettres source à partir de laquelle le contenu est exporté.
Dans Exchange 2016 CU7 ou version ultérieure, ce paramètre est de type MailboxLocationIdParameter. Par conséquent, la valeur la plus simple que vous pouvez utiliser pour identifier la boîte aux lettres est la valeur Alias.
Dans Exchange 2016 CU6 ou version antérieure, ce paramètre est de type MailboxOrMailUserIdParameter. Vous pouvez donc utiliser n’importe quelle valeur qui identifie la boîte aux lettres de façon unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
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 |
-Name
Le paramètre Name précise que les demandes d’exportation dont le nom est précisé sont renvoyées.
Utilisez ce paramètre pour rechercher le nom que vous avez attribué au moment de créer la demande d’exportation.
Si vous n’avez précisé aucun nom à ce moment-là, le nom par défaut est MailboxExportX (où X est une valeur comprise entre 0 et 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 |
-RequestQueue
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 |
-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é.
CompletionInProgress et AutoSuspended ne s’appliquent pas aux demandes d’exportation et ne renverront aucune information.
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 |
-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 |
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.