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 DB01Dans 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 CompletedCet exemple retourne l’état des demandes d’importation dans le lot ImportingDB1PSTs qui s’est terminé.
Exemple 4
Get-MailboxImportRequest -Name "Recovered" -Suspend $trueCet 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.