Update-PublicFolderMailbox
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Update-PublicFolderMailbox cmdlet 更新公用文件夹的层次结构。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
InvokeSynchronizer
Update-PublicFolderMailbox
[-Identity] <MailboxIdParameter>
[-ForceOnlineSync]
[-FullSync]
[-Confirm]
[-DomainController <Fqdn>]
[-InvokeSynchronizer]
[-ReconcileFolders]
[-SuppressStatus]
[-WhatIf]
[<CommonParameters>]
InvokeSingleFolderSynchronizer
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
适用：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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CreateAssociatedDumpster
适用：Exchange Server 2016、Exchange Server 2019、Exchange Online
CreateAssociatedDumpster 开关指定是否在同步文件夹之前创建关联的转储程序。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSingleFolderSynchronizer
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FolderId
适用：Exchange Server 2016、Exchange Server 2019、Exchange Online
FolderId 参数指定要同步的公用文件夹的 GUID 或名称。 还可以包含使用\顶级公用文件夹\公用文件夹格式的路径。
参数属性
| 类型: | PublicFolderIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSingleFolderSynchronizer
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ForceOnlineSync
适用：Exchange Server 2016、Exchange Server 2019、Exchange Online
ForceOnlineSync 开关指定是否强制辅助公用文件夹邮箱与主公用文件夹邮箱同步。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSynchronizer
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FullSync
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
FullSync 开关指定要执行公用文件夹邮箱的完全同步。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSynchronizer
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
Identity 参数指定要更新的公用文件夹邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InvokeSynchronizer
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
InvokeSynchronizer 开关只能用于辅助层次结构公用文件夹邮箱，并触发从主公用文件夹邮箱到指定辅助公用文件夹邮箱的层次结构同步。 不必为此开关指定值。
此开关应该仅用于疑难解答目的。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSingleFolderSynchronizer
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
InvokeSynchronizer
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ReconcileFolders
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSynchronizer
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SuppressStatus
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
SuppressStatus 开关指定禁止显示此 cmdlet 的输出，并且命令在 Exchange 命令行管理程序中以异步方式在后台运行。 不必为此开关指定值。
只能将此开关与 InvokeSynchronizer 开关一起使用。
如果不使用此开关，则输出每隔 3 秒显示一次状态消息，最长为 1 分钟。 在分钟过去之前，不能将 PowerShell 窗口用于其他命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InvokeSynchronizer
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。