Get-MailboxImportRequest
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-MailboxImportRequest pour afficher la status détaillée 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.
Syntaxe
Identity
Get-MailboxImportRequest
[[-Identity] <MailboxImportRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Filtering
Get-MailboxImportRequest
[-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 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 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-MailboxImportRequest -Identity "tony\Recovered"
Cet exemple retourne les informations par défaut concernant la status 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 le status 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 la status 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 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é à une demande d’importation par 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
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
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é.
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, Exchange Online
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
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: | MailboxImportRequestIdParameter |
| 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, Exchange Online
Ce paramètre est disponible 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, le type de paramètre est MailboxLocationIdParameter. La valeur Alias est le moyen le plus simple d’identifier la boîte aux lettres.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
Conseil : Dans Exchange 2016 CU6 ou version antérieure, le type de paramètre était MailboxOrMailUserIdParameter. Vous pouvez utiliser n’importe quelle valeur qui a identifié de manière unique la boîte aux lettres (y compris Alias).
Propriétés des paramètres
| Type: | MailboxLocationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
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, Exchange Online
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é.
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
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
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, 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 |
-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é.
CompletionInProgress et AutoSuspended ne s’appliquent pas aux demandes d’importation 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, 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
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.