Partager via

Get-MailboxExportRequest

Module:
Exchange PowerShell

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.

Syntaxe

Identity 

Get-MailboxExportRequest
    [[-Identity] <MailboxExportRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

MailboxFiltering 

Get-MailboxExportRequest
    [-Mailbox <MailboxOrMailUserIdParameter>]
    [-BatchName <String>]
    [-Database <DatabaseIdParameter>]
    [-DomainController <Fqdn>]
    [-HighPriority <Boolean>]
    [-Name <String>]
    [-ResultSize <Unlimited>]
    [-Status <RequestStatus>]
    [-Suspend <Boolean>]
    [-RequestQueue <DatabaseIdParameter>]
    [<CommonParameters>]

MailboxLocationFiltering 

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 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-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 le status 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 retourne toutes les demandes d’exportation portant le nom DB01toPST où l’exportation est suspendue.

Paramètres

-BatchName

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

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

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

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

-Database

Applicable : Exchange Server 2010

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

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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

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

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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

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

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:MailboxExportRequestIdParameter
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

-Mailbox

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

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 manière 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é.

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

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

-Name

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

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

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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

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

-Status

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

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

CompletionInProgress et AutoSuspended ne s’appliquent pas aux demandes d’exportation et ne retournent aucune information.

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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

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

MailboxFiltering
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
MailboxLocationFiltering
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.