New-PublicFolder cmdlet creates a new public folder.

This cmdlet supports risk-mitigation parameters.

Input parameters

#
Parameter
Type

Mandatory (R/O)

DescriptionRestrictions
1 Authentication Information (all parameters)  
2 DisplayName string R Name of the public folder in the list of CP

Max length is 256 symbols

Output parameters

When the new public folder is created, the object with the properties, described below returns. Properties with values are:

  • DisplayName
  • DistinguishedName
  • EmailAddress
  • EmailAddresses
  • GUID
  • HideFromAddressBook
  • Identity
  • OriginatingServer
#PropertyTypeDescriptionValid Values
PublicFolderInfo:
1 DisplayName string Name of the public folder in the list of Control Panel  
2 DistinguishedName string Unique name of the object in Active Directory  
3 EmailAddress string Primary Email address of the public folder  
4 EmailAddresses string[] List of Email addresses of the public folder  
5 GUID string Globally Unique Identifier (ObjectGuid)  
6 HideFromAddressBook bool This property specifies whether this public folder is visible in the address book
  • True - the public folder is not visible in the address book.

  • False - the public folder is visible in the address book. This is the default value.

7 Identity string A property, that is used for managing the public folder  
8 MemberOf string[]

Identifiers of the groups (as strings), which the public folder is included in

 
9 MemberOfGroups

ADObjectIDInfo[]

Identifiers of the groups, which the public folder is included in

 
10 OrganizationalUnit string Unit inside of the account. These units are used for separating access rights to different user's groups.
 
11 OriginatingServer string Address of the server (domain name), where  the  object  physically  exists  
12 PublicFolderPermissions PermissionInfo[] Specifies users' identities and the corresponding access rights to public folder  


Type PermissionInfo

#PropertyTypeDescription
1 AccessRights string The set of access rights to the public folder
2 User string Identity of user, who has access rights to the public folders

Examples of using New-PublicFolder cmdlet

New-PublicFolder -DisplayName "TestPublicFolder"