Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-06
Use the New-PublicFolder cmdlet to create a new public folder with the specified name.
Syntax
New-PublicFolder -Name <String> [-DomainController
<Fqdn>] [-Path <PublicFolderIdParameter>] [-Server
<ServerIdParameter>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
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. |
|
Name |
Required |
System.String |
The Name parameter specifies the name for the public folder. |
|
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. |
Detailed Description
To run the New-PublicFolder cmdlet, the account you use must be delegated the following:
- Exchange Organization Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
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.
 Copy Code |
|
|---|---|
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.