New-PublicFolder

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the New-PublicFolder cmdlet to create a new public folder with the specified name.

Syntax

New-PublicFolder -Name <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Path <PublicFolderIdParameter>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Detailed Description

To run the New-PublicFolder cmdlet, the account you use must be delegated the following:

  • Exchange Public Folder Administrator role and local Administrators group for the target server

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Name

Required

System.String

The Name parameter specifies the name for the public folder.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the domain controller to use to write this configuration change to Active Directory. Use the fully qualified domain name (FQDN) of the domain controller that you want to use.

Path

Optional

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

The Path parameter specifies the location of the folder in the folder hierarchy, for example, \Legal\Cases.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the server on which to create the public folder.

If a server is not specified, the command checks if the local server is a Microsoft Exchange Server 2007 mailbox server with a public folder store. If it is, the public folder is created locally. If it is not, Exchange finds the closest (by site cost) Exchange 2007 mailbox server with a public folder store on which to create the public folder.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter.

Input Types

Return Types

Errors

Error Description

  

Exceptions

Exceptions Description

  

Example

The following code gives examples of how to use the New-PublicFolder command:

  • Example one creates a new public folder named MyPublicFolder in the root of the public folder tree on the local server of the next closest mailbox server with a public folder store.

  • Example two creates a new public folder named MyPublicFolder under the existing folders \Legal\Cases. The path to the new folder will be \Legal\Cases\MyPublicFolder on Server2.

New-PublicFolder -Name MyPublicFolder 
New-PublicFolder -Name MyPublicFolder -Path \Legal\Cases -Server Server2

The Server parameter supports the ability to accept a pipeline for its argument and strong type. This enables bulk management.