Get-PublicFolderMailboxMigrationRequest

  • Référence
Module:
ExchangePowerShell
S’applique à:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-PublicFolderMailboxMigrationRequest pour afficher l’état des travaux individuels dans les lots de migration de dossiers publics créés à l’aide de l’applet de commande New-MigrationBatch.

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-PublicFolderMailboxMigrationRequest
   [-BatchName <String>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Name <String>]
   [-RequestQueue <DatabaseIdParameter>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [<CommonParameters>]
Get-PublicFolderMailboxMigrationRequest
   [[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

L’applet de commande Get-PublicFolderMailboxMigrationRequest affiche les propriétés suivantes par défaut.

  • Nom : nom attribué par le système à un travail de migration de boîte aux lettres spécifique.
  • TargetMailbox : boîte aux lettres en cours de migration.
  • État : état actuel du travail.

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-PublicFolderMailboxMigrationRequest

Cet exemple retourne des informations sur toutes les demandes de migration.

Exemple 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

Dans Exchange local, cet exemple retourne toutes les demandes de migration dont la valeur de priorité est Élevée, Supérieure, Plus élevée ou Urgence.

Exemple 3

Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}

Cet exemple retourne des demandes de migration de boîte aux lettres de dossier public qui n’ont pas de boîte aux lettres cible.

Exemple 4

Get-PublicFolderMailboxMigrationRequest | group TargetMailbox |?{$_.Count -gt 1}

Cet exemple retourne des demandes de migration de dossiers publics en double (demandes créées pour la même boîte aux lettres cible). Si la commande ne retourne aucun résultat, il n’y a aucune demande de migration en double.

Paramètres

-BatchName

Le paramètre BatchName filtre les résultats en fonction de la valeur BatchName conviviale qui a été affectée lors de la création du travail batch. Le format de cette valeur est : MigrationService:<Batch name provided at batch creation>.

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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie la demande de migration de boîte aux lettres de dossier public que vous souhaitez afficher. La valeur utilise la syntaxe : \PublicFolderMailboxMigration<GUID> (par exemple, \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e).

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

  • BatchName
  • HighPriority
  • Nom
  • RequestQueue
  • Suspendre
  • Statut
Type:PublicFolderMailboxMigrationRequestIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

Le paramètre Name spécifie le nom de la demande de migration de boîte aux lettres de dossier public. Si le nom n’a pas été spécifié lors de la création, la valeur par défaut est PublicFolderMailboxMigration<GUID> (par exemple, PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8).

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

Type:RequestStatus
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, 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online