Update-PublicFolderMailbox

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

使用 Update-PublicFolderMailbox cmdlet 更新公用文件夹的层次结构。

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

语法

Update-PublicFolderMailbox
      [-Identity] <MailboxIdParameter>
      [-ForceOnlineSync]
      [-FullSync]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-InvokeSynchronizer]
      [-ReconcileFolders]
      [-SuppressStatus]
      [-WhatIf]
      [<CommonParameters>]

Update-PublicFolderMailbox
      [-Identity] <MailboxIdParameter>
      -FolderId <PublicFolderIdParameter>
      -InvokeSynchronizer
      [-CreateAssociatedDumpster]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-WhatIf]
      [<CommonParameters>]

说明

仅当要手动调用层次结构同步器和邮箱助理时才需要使用此 cmdlet。对于组织中的每个公用文件夹邮箱，每 24 小时至少调用一次这两者。如果任何用户通过 Outlook 或 Exchange Web Services 客户端登录到辅助邮箱，则每 15 分钟调用一次层次结构同步器。

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

示例

示例 1

Update-PublicFolderMailbox -Identity PF_marketing

此示例更新公用文件夹邮箱PF_marketing上的公用文件夹层次结构。

示例 2

Get-Mailbox -PublicFolder | Update-PublicFolderMailbox

此示例更新所有公用文件夹邮箱。

参数

-Confirm

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

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

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

-CreateAssociatedDumpster

CreateAssociatedDumpster 开关指定是否在同步文件夹之前创建关联的转储程序。不必为此开关指定值。

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

-DomainController

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

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

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

-FolderId

FolderId 参数指定要同步的公用文件夹的 GUID 或名称。还可以包含使用\顶级公用文件夹\公用文件夹格式的路径。

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

-ForceOnlineSync

ForceOnlineSync 开关指定是否强制辅助公用文件夹邮箱与主公用文件夹邮箱同步。不必为此开关指定值。

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

-FullSync

FullSync 开关指定要执行公用文件夹邮箱的完全同步。不必为此开关指定值。

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

-Identity

Identity 参数指定要更新的公用文件夹邮箱。可以使用能够唯一标识邮箱的任意值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
域\用户名
电子邮件地址
GUID
LegacyExchangeDN
SamAccountName
用户 ID 或用户主体名称 (UPN)

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

-InvokeSynchronizer

InvokeSynchronizer 开关只能用于辅助层次结构公用文件夹邮箱，并触发从主公用文件夹邮箱到指定辅助公用文件夹邮箱的层次结构同步。不必为此开关指定值。

此开关应该仅用于疑难解答目的。

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

-ReconcileFolders

ReconcileFolders 开关指定是否要仔细查找主公用文件夹邮箱和辅助公用文件夹邮箱之间的文件夹层次结构差异。将重新创建主公用文件夹邮箱（不是辅助公用文件夹邮箱）中存在的文件夹。不必为此开关指定值。

在本地 Exchange 中，将删除存在于辅助公用文件夹邮箱中而不是主文件夹中的文件夹。

在 Exchange Online中，存在于辅助公用文件夹邮箱中而不是主文件夹中的文件夹将移动到 \NON_IPM_SUBTREE\LOST_AND_FOUND。有关LOST_AND_FOUND功能的更多详细信息，请参阅此博客文章。

在这两种情况下，可以使用 Set-PublicFolder 命令还原已删除或移动到LOST_AND_FOUND的公用文件夹。

本示例将名为“Marketing”的公用文件夹从 LOST_AND_FOUND 还原到名为 \South 的文件夹

Get-PublicFolder \NON_IPM_SUBTREE\LOST_AND_FOUND\5773ba6a-9926-4d64-97db-63a2bdd94a5b\"Pesky Pole" | Set-PublicFolder -Path "\South"

本示例将名为“Documents”的公用文件夹从LOST_AND_FOUND还原到名为 \Engineering 的文件夹

Set-PublicFolder -Identity \NON_IPM_SUBTREE\DUMPSTER_ROOT\DUMPSTER_EXTEND\RESERVED_1\RESERVED_1\9f32c468-4bc2-42aa-b979-16a057394b2f\Documents -Path \Engineering

注意：应仅将 ReconcileFolders 开关用于修复或故障排除目的，以查找常规同步未检测到的公用文件夹层次结构中的差异。这些未检测到的差异可能发生在数据库故障转移或灾难恢复方案中。此开关必须与 InvokeSynchronizer 开关一起使用。

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

-SuppressStatus

SuppressStatus 开关指定阻止此 cmdlet 的输出，并指定命令在 Exchange 命令行管理程序的后台异步运行。不必为此开关指定值。

只能将此开关与 InvokeSynchronizer 开关一起使用。

如果不使用此开关，输出将每隔 3 秒显示一次状态消息，最长为 1 分钟。在分钟过去之前，不能将 PowerShell 窗口用于其他命令。

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

-WhatIf

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

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

输入

Input types

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

输出

Output types

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