Get-PublicFolderMailboxMigrationRequest

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et réglages peuvent être exclusifs à l’un ou l’autre environnement.

Utilisez l’applet de commande Get-PublicFolderMailboxMigrationRequest pour afficher le status de tâches individuelles 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.

Syntaxe

Filtering

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

Identity

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 à une tâche de migration de boîte aux lettres spécifique.
  • TargetMailbox : boîte aux lettres en cours de migration.
  • Statut : le status actuel de la tâche.

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

Cet exemple renvoie 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 priorité est Élevée, Supérieure, Supérieure ou Urgente.

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 renvoie 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 renvoie aucun résultat, il n’y a pas de demandes de migration en double.

Paramètres

-BatchName

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

Le paramètre BatchName filtre les résultats en fonction de la valeur conviviale BatchName qui a été affectée lors de la création du traitement par lots. 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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Filtering
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 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 du paramètre

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 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 attribué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 Renvoie les demandes créées avec la valeur de priorité élevée, supérieure, supérieure ou urgente.
  • $false Renvoie les demandes créées avec la valeur de priorité Normal, Faible, Inférieur ou Faible.

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

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

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 suivante : \PublicFolderMailboxMigration<GUID> (par exemple, \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e).

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

  • Nom du lot
  • HighPriority
  • Nom
  • File d’attente de demande
  • Suspendre
  • Statut

Attention : La valeur $null ou une valeur inexistante pour le paramètre Identity renvoie 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 du paramètre

Type:PublicFolderMailboxMigrationRequestIdParameter
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

-Name

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

Le paramètre Nom 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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Filtering
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 demande 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 du paramètre

Type:DatabaseIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Filtering
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 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 du paramètre

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

Le paramètre Status filtre les résultats en fonction de leur status. Vous pouvez utiliser les valeurs suivantes :

  • Suspension automatique
  • Terminé
  • CompletedWithWarning
  • AchèvementEn cours
  • Échec
  • En cours
  • En file d’attente
  • Nouvelle tentative
  • Suspendu
  • Synchronisé

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.

Propriétés du paramètre

Type:RequestStatus
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

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

Le paramètre Suspend spécifie s’il faut renvoyer 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 du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Filtering
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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.