Commands › Exchange Online

New-ManagedFolder

Exchange Online ExchangeOnlineManagement New-*

Create a managed folder object for messaging records management (MRM). This command doesn't accept pipelined input.

Quick start script

# New-ManagedFolder — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-ManagedFolder
$before | Format-List

# 3. Make the change (dry run first)
New-ManagedFolder -Name <String> -DefaultFolderType <DefaultManagedFolderType> -FolderName <String> -WhatIf
New-ManagedFolder -Name <String> -DefaultFolderType <DefaultManagedFolderType> -FolderName <String>

# 4. Verify and diff
$after = Get-ManagedFolder
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

ManagedDefaultFolder

New-ManagedFolder [-Name] <String> -DefaultFolderType <DefaultManagedFolderType>
 [-BaseFolderOnly <Boolean>]
 [-Comment <String>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-LocalizedComment <MultiValuedProperty>]
 [-MustDisplayCommentEnabled <Boolean>]
 [-WhatIf]
 [<CommonParameters>]

ManagedCustomFolder

New-ManagedFolder [-Name] <String> -FolderName <String>
 [-LocalizedFolderName <MultiValuedProperty>]
 [-StorageQuota <Unlimited>]
 [-BaseFolderOnly <Boolean>]
 [-Comment <String>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-LocalizedComment <MultiValuedProperty>]
 [-MustDisplayCommentEnabled <Boolean>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (12)

ParameterTypeRequiredWhat it controls
-Name String yes The Name parameter specifies a unique name for the managed folder object in Active Directory. The name can have up to 65 characters. Whereas the FolderName parameter specifies the folder name as displayed to users in...
-DefaultFolderType DefaultManagedFolderType yes The DefaultFolderType parameter specifies the type of default folder to create, such as Inbox or Deleted Items.
-FolderName String yes The FolderName parameter specifies the folder name as it appears in users' mailboxes. The folder name can have up to 255 characters. You can't set the FolderName parameter for managed default folders, such as Inbox.
-BaseFolderOnly Boolean The BaseFolderOnly parameter specifies whether the managed content settings should be applied only to the managed folder or to the folder and all its subfolders.
-Comment String The Comment parameter specifies the default administrator comment to be displayed with the folder in Microsoft Office Outlook 2007 and Microsoft Office Outlook Web App. The comment can have up to 255 characters,...
-Confirm SwitchParameter The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController Fqdn The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-LocalizedComment MultiValuedProperty The LocalizedComment parameter specifies localized administrator comments and their languages. When the language setting of Outlook 2007 matches one of the locales specified in this parameter, the corresponding...
-LocalizedFolderName MultiValuedProperty The LocalizedFolderName parameter specifies the localized folder names and their languages. When the language setting of Outlook 2007 matches one of the locales specified in this parameter, the corresponding...
-MustDisplayCommentEnabled Boolean The MustDisplayCommentEnabled parameter specifies whether to set a flag used by Outlook 2007 to prevent users from minimizing a folder comment (that's visible in Outlook 2007 and Outlook Web App). If the...
-StorageQuota Unlimited The StorageQuota parameter specifies the storage size limit for the mailbox folder. When the folder size exceeds this limit, no additional items might be added. Storage size limits can be specified in kilobytes (KB)...
-WhatIf SwitchParameter The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.