Creates a new public folder.
New-DRAPublicFolder -Name <String> [-Path <String>] [-Mailbox <String>] -Domain <String> [-DRARestServer <String>] [-DRARestPort <Int32>] [-IgnoreCertificateErrors <SwitchParameter>] [-Force <SwitchParameter>] [-Timeout <Int32>] [<CommonParameters>]
The New-DRAPublicFolder cmdlet creates a new public folder. The requesting user must have the Create Public Folder power.
Attribute / Description |
Parameters / Values |
||||
---|---|---|---|---|---|
Required |
Position |
Default Value |
Accept Pipeline input? |
Accept wildcard characters? |
|
Name <String> The Name parameter specifies the name for the public folder. |
true |
named |
|
true (ByPropertyName) |
false |
Path [<String>] The Path parameter specifies the location of the folder in the folder hierarchy. The following value types can be used: OnePointPath or DistinguishedName or TopLevelPublicFOlder\PublicFolder. For example, OnePoint://PF=PublicFolder,DC=MyDomain,DC=corp. |
false |
named |
|
true (ByPropertyName) |
false |
Mailbox [<String>] The Mailbox parameter specifies the identity of the public folder mailbox hierarchy. The following values can be used: GUID, Distinguished Name, Domain\Account, User principal name, LegacyExchangeDN, SMTP address or Alias. |
false |
named |
|
true (ByPropertyName) |
false |
Domain <String> The domain of the object in fqdn format. For example: mydomain.corp |
true |
named |
|
true (ByPropertyName) |
false |
DRARestServer [<String>] The name of the computer running the DRA Rest Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'. |
false |
named |
|
true (ByPropertyName) |
false |
DRARestPort [<Int32>] The port where the DRA REST Service listens for requests. If the parameter is not specified, the value defaults to 8755. |
false |
named |
8755 |
true (ByPropertyName) |
false |
IgnoreCertificateErrors [<SwitchParameter>] Allows the request to bypass any SSL certificate errors, such as the InvalidOperation error that occurs when the REST Service is bound to a self-signed certificate. |
false |
named |
|
false |
false |
Force [<SwitchParameter>] Suppresses any request for user input and supplies a 'yes' response. For example: -Force with a delete request will perform the delete without presenting the confirmation request to the user. |
false |
named |
|
false |
false |
Timeout [<Int32>] The number of seconds to wait before the request to the DRA REST server times out. To specify an infinite timeout, you can set this parameter to -1. |
false |
named |
100 seconds |
false |
false |
<CommonParameters> Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see About CommonParameters. |
|
|
|
|
|
NOTE:For more information, type "Get-Help New-DRAPublicFolder -detailed". For technical information, type "Get-Help New-DRAPublicFolder -full".
Example 19-9 1
PS C:\>New-DRAPublicFolder -Name "MyPublicFolder" -Path "OnePoint://PF=RootPF,DC=MyDomain,DC=corp" -Domain MyDomain.corp
This example will create a new public folder named MyPublicFolder inside RootPF public folder.
Example 19-10 2
PS C:\>New-DRAPublicFolder -Name "MyPublicFolder" -Mailbox MyMailbox -Domain MyDomain.corp
This example will create a new public folder named MyPublicFolder in the MyMailbox hierarchy public folder mailbox.