Update-PublicFolderMailbox
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
パブリック フォルダーの階層を更新するには、Update-PublicFolderMailbox コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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>]
説明
このコマンドレットは、階層シンクロナイザーおよびメールボックス アシスタントを手動で実行する場合にのみ使用してください。 これらは両方とも、組織のパブリック フォルダー メールボックスのそれぞれにおいて少なくとも 24 時間に 1 回実行されます。 階層シンクロナイザーは、ユーザーが Outlook または Exchange Web Services クライアントを介してセカンダリ メールボックスにログオンしている場合、15 分ごとに呼び出されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CreateAssociatedDumpster
適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online
CreateAssociatedDumpster スイッチは、フォルダーを同期する前に、関連付けられた削除済みアイテム収集機能を作成するかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSingleFolderSynchronizer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FolderId
適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online
FolderId パラメーターは、同期するパブリック フォルダーの GUID または名前を指定します。 また、最上位のパブリック フォルダー\パブリック フォルダー という形式を使用してパスを含めることもできます。
パラメーターのプロパティ
| 型: | PublicFolderIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSingleFolderSynchronizer
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceOnlineSync
適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online
ForceOnlineSync スイッチは、セカンダリ パブリック フォルダー メールボックスとプライマリ パブリック フォルダー メールボックスとの同期を強制するかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSynchronizer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FullSync
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
FullSync スイッチは、パブリック フォルダー メールボックスの完全同期を実行することを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSynchronizer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
Identity パラメーターは、更新するパブリック フォルダー メールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | MailboxIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-InvokeSynchronizer
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
InvokeSynchronizer スイッチは、セカンダリ階層パブリック フォルダー メールボックスでのみ使用でき、プライマリ パブリック フォルダー メールボックスから、指定したセカンダリ パブリック フォルダー メールボックスに対して階層の同期を実行します。 このスイッチで値を指定する必要はありません。
このスイッチは、トラブルシューティングの目的のためにのみ使用してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSingleFolderSynchronizer
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
InvokeSynchronizer
| 配置: | 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機能の詳細については、 このブログ投稿 を参照してください。
どちらのシナリオでも、削除またはLOST_AND_FOUNDに移動されたパブリック フォルダーは、Set-PublicFolder コマンドを使用して復元できます。
次の使用例は、"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
注: リコンサイルFolders スイッチは、修復またはトラブルシューティングの目的でのみ使用して、通常の同期によって検出されないパブリック フォルダー階層の違いを探す必要があります。 これらの検出されない違いは、データベースのフェールオーバーまたはディザスター リカバリーのシナリオで発生する可能性があります。 このスイッチは、InvokeSynchronizer スイッチと併用する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSynchronizer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SuppressStatus
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
SuppressStatus スイッチは、このコマンドレットの出力が抑制され、コマンドが Exchange 管理シェルからバックグラウンドで非同期的に実行されることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、InvokeSynchronizer スイッチでのみ使用できます。
このスイッチを使用しない場合、出力には最大 1 分間、3 秒ごとにステータス メッセージが表示されます。 分が経過するまで、他のコマンドに PowerShell ウィンドウを使用することはできません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InvokeSynchronizer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。