Topic Last Modified: 2013-01-16

Use the Get-PublicFolderMoveRequest cmdlet to view the detailed status of an ongoing public folder move that was initiated using the New-PublicFolderMoveRequest cmdlet.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax

Get-PublicFolderMoveRequest [-AccountPartition <AccountPartitionIdParameter>] [-Identity <PublicFolderMoveRequestIdParameter>] [-Organization <OrganizationIdParameter>] <COMMON PARAMETERS>
Get-PublicFolderMoveRequest [-AccountPartition <AccountPartitionIdParameter>] [-BatchName <String>] [-HighPriority <$true | $false>] [-Name <String>] [-Organization <OrganizationIdParameter>] [-RequestQueue <DatabaseIdParameter>] [-Status <None | Queued | InProgress | AutoSuspended | CompletionInProgress | Completed | CompletedWithWarning | Suspended | Failed>] [-Suspend <$true | $false>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-DomainController <Fqdn>] [-ResultSize <Unlimited>]

Examples

EXAMPLE 1

This example returns the status of an in-progress public folder move request with the identity \PublicFolderMove, which is the default name assigned to public folder moves.

Copy Code 
Get-PublicFolderMoveRequest -Identity \PublicFolderMove

EXAMPLE 2

This example returns the status of in-progress and queued requests that are on the source database MBD01.

Copy Code 
Get-PublicFolderMoveRequest -RequestQueue MBD01

Detailed Description

Public folder move requests are used to move public folders between public folder mailboxes. After the move request is complete, you need to update the hierarchy using the Update-PublicFolderMailbox cmdlet.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Public folders" entry in the Sharing and Collaboration Permissions topic.

Parameters

Parameter Required Type Description

AccountPartition

Optional

Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter

This parameter is reserved for internal Microsoft use.

BatchName

Optional

System.String

The BatchName parameter specifies the name that was given to a batch public folder move request.

You can't use this parameter in conjunction with the Identity parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

HighPriority

Optional

System.Boolean

The HighPriority parameter specifies that the cmdlet returns requests that were created with the HighPriority flag. The HighPriority flag indicates that the request should be processed before other lower priority requests in the queue.

You can't use this parameter in conjunction with the Identity parameter.

Identity

Optional

Microsoft.Exchange.Management.RecipientTasks.PublicFolderMoveRequestIdParameter

The Identity parameter specifies the identity of the public folder move request. The default identity assigned to public folder move requests is \PublicFolderMove.

This parameter can't be used in conjunction with the following parameters:

  • BatchName

  • HighPriority

  • Name

  • RequestQueue

  • Suspend

  • Status

Name

Optional

System.String

The Name parameter specifies the name of the public folder move request. If you didn't specify a name when creating the move request, PublicFolderMove will be the default name assigned to the request.

You can't use this parameter in conjunction with the Identity parameter.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

The Organization parameter is reserved for internal Microsoft use.

RequestQueue

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The RequestQueue parameter specifies the target mailbox database on which the public folder of the request resides. You can use one of the following values:

  • GUID of the database

  • Database name

You can't use this parameter in conjunction with the Identity parameter.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.

Status

Optional

Microsoft.Exchange.Data.Directory.Recipient.RequestStatus

The Status parameter specifies whether to return public folders that are in a specific status. This parameter accepts the following values:

  • None

  • Queued

  • InProgress

  • AutoSuspended

  • CompletionInProgress

  • Completed

  • CompletedWithWarning

  • Suspended

  • Failed

You can't use this parameter in conjunction with the Identity parameter.

Suspend

Optional

System.Boolean

The Suspend parameter specifies whether to return public folders with moves that have been suspended. This parameter accepts $true or $false.

You can't use this parameter in conjunction with the Identity parameter.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.