Partager via


Get-MailboxImportRequest

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-MailboxImportRequest pour afficher l’état détaillé d’une demande d’importation en cours lancée à l’aide de l’applet de commande New-MailboxImportRequest.

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-MailboxImportRequest
   [[-Identity] <MailboxImportRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxImportRequest
   [-BatchName <String>]
   [-Database <DatabaseIdParameter>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Mailbox <MailboxOrMailUserIdParameter>]
   [-Name <String>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-RequestQueue <DatabaseIdParameter>]
   [<CommonParameters>]
Get-MailboxImportRequest
   [-BatchName <String>]
   [-Database <DatabaseIdParameter>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Mailbox <MailboxLocationIdParameter>]
   [-Name <String>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-RequestQueue <DatabaseIdParameter>]
   [<CommonParameters>]

Description

Les critères de recherche de l’applet de commande Get-MailboxImportRequest sont une instruction Boolean 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-MailboxImportRequest -Identity "tony\Recovered"

Cet exemple retourne les informations par défaut concernant l’état de la demande d’importation en cours avec l’identité tony\Recovered. Les informations renvoyées par défaut incluent le nom, la boîte aux lettres et l'état.

Exemple 2

Get-MailboxImportRequest -Status InProgress -Database DB01

Dans Exchange Server 2010, cet exemple retourne l’état des demandes d’importation en cours pour les boîtes aux lettres ou les archives qui résident sur la base de données DB01.

Exemple 3

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

Cet exemple retourne l’état des demandes d’importation dans le lot ImportingDB1PSTs qui s’est terminé.

Exemple 4

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

Cet exemple retourne toutes les demandes d’importation dont le nom est Récupéré où l’importation a été suspendue.

Paramètres

-BatchName

Le paramètre BatchName spécifie le nom donné à une demande d’importation par 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, Exchange Online

-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

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

Ce paramètre est disponible uniquement dans Exchange sur site.

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’importation. Par défaut, les demandes d’importation sont nommées <alias>\MailboxImportX (où X = 0-9). Si vous spécifiez un nom pour la demande d’importation, utilisez la syntaxe suivante : Alias\Name. Microsoft Exchange précède automatiquement la requête avec l’alias de la boîte aux lettres.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres suivants :

  • BatchName
  • Boîte aux lettres
  • Nom
  • Statut
  • Suspendre
  • HighPriority
Type:MailboxImportRequestIdParameter
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

-Mailbox

Ce paramètre est fonctionnel uniquement dans Exchange local.

Le paramètre Mailbox filtre les résultats en fonction de la boîte aux lettres de destination dans laquelle le contenu est importé.

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 spécifie que les demandes d’importation portant le nom spécifié sont retournées.

Utilisez ce paramètre pour rechercher le nom que vous avez fourni lors de la création de la demande d’importation. Si vous n’avez pas spécifié de nom lors de la création de la demande, le nom par défaut est MailboxImportX (où X = 0-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

-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’importation et ne retournent 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, 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

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.