Applies to: Exchange Server 2013

Topic Last Modified: 2013-01-14

The New-SyncMailPublicFolder cmdlet is used by the Import-MailPublicFoldersForMigration.ps1 script to create mail-enabled public folder recipient objects in Microsoft Office 365 prior to starting a public folder migration. This cmdlet should only be used if directed by support personnel or by documentation.

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax

New-SyncMailPublicFolder -Alias <String> -EntryId <String> -Name <String> [-EmailAddresses <ProxyAddress[]>] [-ExternalEmailAddress <SmtpAddress>] [-HiddenFromAddressListsEnabled <SwitchParameter>] [-WindowsEmailAddress <SmtpAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Examples

EXAMPLE 1

This cmdlet is only used by the Import-MailPublicFoldersForMigration.ps1 script. Don't run this cmdlet in the Shell.

Copy Code
New-SyncMailPublicFolder

Detailed Description

This cmdlet is only used by the Import-MailPublicFoldersForMigration.ps1 script. Don't run this cmdlet in the Exchange Management Shell.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Public folders, mail-enabled" entry in the Sharing and Collaboration Permissions topic.

Parameters

Parameter Required Type Description

Alias

Required

System.String

The Alias parameter specifies the email alias of the public folder that you're creating.

The alias can be a combination of characters separated by a period with no intervening spaces. Don't use special characters in the alias.

EntryId

Required

System.String

This parameter is reserved for internal Microsoft use.

Name

Required

System.String

The Name parameter specifies the common name (CN) of the mail-enabled public folder.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch 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 switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

EmailAddresses

Optional

Microsoft.Exchange.Data.ProxyAddress[]

The EmailAddresses parameter specifies the email alias of the mail-enabled public folder. All valid Exchange email address types may be used. You can specify multiple values for the EmailAddresses parameter as a comma-delimited list.

ExternalEmailAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

The ExternalEmailAddress parameter specifies an email address outside the organization.

HiddenFromAddressListsEnabled

Optional

System.Management.Automation.SwitchParameter

The HiddenFromAddressListsEnabled parameter specifies whether the public folder appears in the address list. The two possible values for this parameter are $true or $false. The default value is $false.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

The Organization parameter is reserved for internal Microsoft use.

OverrideRecipientQuotas

Optional

System.Management.Automation.SwitchParameter

This parameter is reserved for internal Microsoft use.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, 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 switch.

WindowsEmailAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

The WindowsEmailAddress parameter specifies an email address in the format EmailAddress@contoso.com.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.