Set-PublicFolder

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Set-PublicFolder cmdlet 可以设置公用文件夹的属性。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Set-PublicFolder
   [-Identity] <PublicFolderIdParameter>
   [-AgeLimit <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-EformsLocaleId <CultureInfo>]
   [-Force]
   [-HiddenFromAddressListsEnabled <Boolean>]
   [-IssueWarningQuota <Unlimited>]
   [-LocalReplicaAgeLimit <EnhancedTimeSpan>]
   [-MailRecipientGuid <Guid>]
   [-MailEnabled <Boolean>]
   [-MaxItemSize <Unlimited>]
   [-Name <String>]
   [-OverrideContentMailbox <MailboxIdParameter>]
   [-Path <PublicFolderIdParameter>]
   [-PerUserReadStateEnabled <Boolean>]
   [-ProhibitPostQuota <Unlimited>]
   [-Replicas <DatabaseIdParameter[]>]
   [-ReplicationSchedule <Schedule>]
   [-RetainDeletedItemsFor <EnhancedTimeSpan>]
   [-Server <ServerIdParameter>]
   [-UseDatabaseAgeDefaults <Boolean>]
   [-UseDatabaseQuotaDefaults <Boolean>]
   [-UseDatabaseReplicationSchedule <Boolean>]
   [-UseDatabaseRetentionDefaults <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false

在 Exchange 2010 中,此示例更改公用文件夹,使其不使用数据库默认复制计划。

示例 2

Set-PublicFolder "\Customer Service Requests" -OverrideContentMailbox North_America

本示例将公用文件夹层次结构邮箱的内容位置更改为 North_America。

示例 3

Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"

在 Exchange 2010 中,此示例将文件夹设置为仅在周末复制。

参数

-AgeLimit

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

AgeLimit 参数指定文件夹的总期限。 达到期限限制的项目将从公用文件夹中删除。 超过期限限制后,将自动删除此公用文件夹的副本。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

类型:EnhancedTimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EformsLocaleId

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

EformsLocaleId 参数指定电子表单库的区域设置版本。 EformsLocaleId 参数的有效输入是在 CultureInfo 类中提供的 Microsoft .NET 类库类引用的“区域性名称”列中列出的字符串名称。

类型:CultureInfo
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

强制开关隐藏警告或确认消息。 不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HiddenFromAddressListsEnabled

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用。

HiddenFromAddressListsEnabled 参数指定是否从地址列表中隐藏公用文件夹。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Identity 参数指定要修改的公用文件夹的名称和路径。 有效值使用格式: \Level1\Level2\...\LevenN\PublicFolder。 例如,"\Customer Discussion""\Engineering\Customer Discussion"

类型:PublicFolderIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-IssueWarningQuota

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

IssueWarningQuota 参数指定公用文件夹大小,达到此大小时,会向公用文件夹所有者发出警告,告知该文件夹几乎已满。

默认值为 unlimited,这是 2 TB。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)
  • TB(兆兆字节)

TB(兆兆字节)

此参数的有效输入范围为 1 到 2TB。

类型:Unlimited
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LocalReplicaAgeLimit

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

LocalReplicaAgeLimit 参数指定已连接服务器上副本 (replica) 的期限限制(如果有副本 (replica) )。

类型:EnhancedTimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MailEnabled

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

MailEnabled 参数指定该公用文件夹已启用邮件。 为此,您可以使用值 $true。

您可以使用此参数来更正失去其启用邮件状态的启用邮件的公用文件夹。 如果您试图使用此参数来通过邮件启用从未启用过邮件的公用文件夹,则该命令将会失败。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MailRecipientGuid

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

MailRecipientGuid 参数指定公用文件夹的 MailRecipientGuid 值。 您可以使用此参数来更正失去其 MailRecipientGuid 值的启用邮件的公用文件夹。

为此参数指定的值必须与已启用邮件的现有公用文件夹的 MailRecipientGuid 值匹配。 否则,该命令将失败。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaxItemSize

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

MaxItemSize 参数指定投递邮件的最大大小。 大于 MaxItemSize 参数值的邮件将会被拒绝。 默认值为 unlimited,这是 2 GB。 有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)
  • TB(兆兆字节)

TB(兆兆字节)

此参数的有效输入范围为 1 到 2GB。

类型:Unlimited
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Name 参数指定公用文件夹的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-OverrideContentMailbox

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

OverrideContentMailbox 参数指定要将此公用文件夹的内容移动到的目标公用文件夹邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)
类型:MailboxIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Path 参数指定公用文件夹的路径,例如 \TopLevelPublicFolder\PublicFolder。

类型:PublicFolderIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PerUserReadStateEnabled

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

PerUserReadStateEnabled 参数指定是否要基于每个用户对已读数据和未读数据进行维护操作。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProhibitPostQuota

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ProhibitPostQuota 参数指定在通知用户公用文件夹已满时的公用文件夹大小。 用户无法向大于 ProhibitPostQuota 参数值的文件夹投递邮件。 默认值为 unlimited,这是 2 TB。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)
  • TB(兆兆字节)

TB(兆兆字节)

此参数的有效输入范围为 1 到 2TB。

类型:Unlimited
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Replicas

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

Replicas 参数指定用于复制此公用文件夹的公用文件夹数据库的列表。 可以使用任何能够唯一标识此数据库的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID

可以指定用逗号分隔的多个值。 如果值包含空格,请使用以下语法: "Value1","Value2",..."ValueN"

类型:DatabaseIdParameter[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReplicationSchedule

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

ReplicationSchedule 参数指定文件夹的复制计划。

此参数的语法为: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]

可使用以下天数值:

  • 当天的全名。
  • 当天的缩写名称。
  • 介于 0 到 6 的整数,其中 0 = 星期日。

可以输入 24 小时格式的时间,并省略 AM/PM 值。 如果以 12 小时格式输入时间,请在时间与 AM/PM 值之间添加一个空格。

可以混合和匹配日期/时间格式。

开始时间和结束时间必须至少间隔 15 分钟。 分钟数将四舍五入到 0、15、30 或 45。

下面是一些示例:

  • "Sun.11:30 PM-Mon.1:30 AM"
  • “6.22:00-6.22:15” (从周六晚上 10:00 运行到周六晚上 10:15.)
  • “星期日 1:15 AM-monday.23:00”
类型:Schedule
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RetainDeletedItemsFor

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

RetainDeletedItemsFor 参数指定已删除邮件的保留时间。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

类型:EnhancedTimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Server

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

服务器参数指定要运行此命令的Exchange服务器。 可以使用唯一标识该服务器的任何值。 例如:

  • 名称
  • FQDN
  • 可分辨名称 (DN)
  • Exchange 旧版 DN

Exchange 旧版 DN

类型:ServerIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseDatabaseAgeDefaults

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

UseDatabaseAgeDefaults 参数指定是否使用数据库期限限制。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseDatabaseQuotaDefaults

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

UseDatabaseQuotaDefaults 参数指定是否使用公共存储配额限制。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseDatabaseReplicationSchedule

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

UseDatabaseReplicationSchedule 参数指定是否使用公用文件夹复制计划。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseDatabaseRetentionDefaults

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用

UseDatabaseRetentionDefaults 参数指定是否使用数据库保留默认值。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。