Partager via

Get-PublicFolderMailboxMigrationRequest

Module:
Exchange PowerShell

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-PublicFolderMailboxMigrationRequest pour afficher les status de 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.

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 à un travail de migration de boîte aux lettres spécifique.
  • TargetMailbox : boîte aux lettres en cours de migration.
  • État : status actuelle du travail.

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 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 qui ont une valeur de priorité É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

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 BatchName conviviale qui a été affectée lors de la création du travail de 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 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

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

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 : \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

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

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

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

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

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

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

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