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
AgeLimit 参数指定文件夹的总期限。 超过期限限制后,将自动删除此公用文件夹的副本。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EformsLocaleId
EformsLocaleId 参数指定电子表单库的区域设置版本。 EformsLocaleId 参数的有效输入是在 CultureInfo 类中提供的 Microsoft .NET 类库类引用的“区域性名称”列中列出的字符串名称。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Force
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-HiddenFromAddressListsEnabled
此参数仅在 2010 Exchange Server可用。
HiddenFromAddressListsEnabled 参数指定是否从地址列表中隐藏公用文件夹。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Identity
Identity 参数指定要修改的公用文件夹的名称和路径。 有效值使用格式: \Level1\Level2\...\LevenN\PublicFolder
。 例如,"\Customer Discussion"
或 "\Engineering\Customer Discussion"
。
Type: | PublicFolderIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IssueWarningQuota
IssueWarningQuota 参数指定公用文件夹大小,达到此大小时,会向公用文件夹所有者发出警告,告知该文件夹几乎已满。
默认值为 unlimited,这是 2 TB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的有效输入范围为 1 到 2TB。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LocalReplicaAgeLimit
此参数仅在 Exchange Server 2010 中可用
LocalReplicaAgeLimit 参数指定已连接服务器上副本的年龄限制(如果副本上有副本)。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MailEnabled
MailEnabled 参数指定该公用文件夹已启用邮件。 为此,您可以使用值 $true。
您可以使用此参数来更正失去其启用邮件状态的启用邮件的公用文件夹。 如果您试图使用此参数来通过邮件启用从未启用过邮件的公用文件夹,则该命令将会失败。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MailRecipientGuid
MailRecipientGuid 参数指定公用文件夹的 MailRecipientGuid 值。 您可以使用此参数来更正失去其 MailRecipientGuid 值的启用邮件的公用文件夹。
为此参数指定的值必须与已启用邮件的现有公用文件夹的 MailRecipientGuid 值匹配。 否则,该命令将失败。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MaxItemSize
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)
TB(兆兆字节)
此参数的有效输入范围为 1 到 2GB。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Name 参数指定公用文件夹的名称。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OverrideContentMailbox
此参数只在本地 Exchange 中可用。
OverrideContentMailbox 参数指定要将此公用文件夹的内容移动到的目标公用文件夹邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Path
Path 参数指定公用文件夹的路径,例如 \TopLevelPublicFolder\PublicFolder。
Type: | PublicFolderIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PerUserReadStateEnabled
PerUserReadStateEnabled 参数指定是否要基于每个用户对已读数据和未读数据进行维护操作。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ProhibitPostQuota
ProhibitPostQuota 参数指定在通知用户公用文件夹已满时的公用文件夹大小。 用户无法向大于 ProhibitPostQuota 参数值的文件夹投递邮件。 默认值为 unlimited,这是 2 TB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的有效输入范围为 1 到 2TB。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Replicas
此参数仅在 Exchange Server 2010 中可用
Replicas 参数指定用于复制此公用文件夹的公用文件夹数据库的列表。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
可以指定用逗号分隔的多个值。 如果值包含空格,请使用以下语法: "Value1","Value2",..."ValueN"
。
Type: | DatabaseIdParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ReplicationSchedule
此参数仅在 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”
Type: | Schedule |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RetainDeletedItemsFor
RetainDeletedItemsFor 参数指定已删除邮件的保留时间。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Server
此参数仅在 Exchange Server 2010 中可用
服务器参数指定要运行此命令的Exchange服务器。 可以使用唯一标识该服务器的任何值。 例如:
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
Exchange 旧版 DN
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-UseDatabaseAgeDefaults
此参数仅在 Exchange Server 2010 中可用
UseDatabaseAgeDefaults 参数指定是否使用数据库期限限制。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-UseDatabaseQuotaDefaults
此参数仅在 Exchange Server 2010 中可用
UseDatabaseQuotaDefaults 参数指定是否使用公共存储配额限制。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-UseDatabaseReplicationSchedule
此参数仅在 Exchange Server 2010 中可用
UseDatabaseReplicationSchedule 参数指定是否使用公用文件夹复制计划。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-UseDatabaseRetentionDefaults
此参数仅在 Exchange Server 2010 中可用
UseDatabaseRetentionDefaults 参数指定是否使用数据库保留默认值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。