Update-SPProfileSync
指定されたパラメーターに基づいて、ユーザープロファイル同期ジョブの構成をUpdatesします。
構文
Default (既定)
Update-SPProfileSync
[[-ExcludeWebApplications] <String>]
[[-SynchronizationTiming] <String>]
[[-SweepTiming] <String>]
[[-IgnoreIsActive] <Boolean>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Update-SPProfileSync コマンドレットは、指定されたパラメーターに基づいて、ユーザー プロファイル同期ジョブの構成を更新します。
例
例 1
Update-SPProfileSync -IgnoreIsActive:$false
この例では、ユーザー プロファイル同期ジョブを更新して、アクティビティに関係なくすべてのユーザーを同期するようにマークし、ユーザーの確認を求めません。
例 2
Update-SPProfileSync -SynchronizationTiming "every 15 minutes"
この例では、ユーザー プロファイル同期ジョブを更新して、ユーザーへの確認を表示せずに、15 分ごとに実行するようにマークします。
パラメーター
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExcludeWebApplications
同期プロセスで考慮事項から除外する Web アプリケーション URL のコンマ区切りのリスト。
指定された値によって、既存の値セットがすべて削除されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IgnoreIsActive
アクティブなプロファイルのみを同期するか、すべてのプロファイルを同期するかを指定します。 サイトに投稿するユーザーのユーザー プロファイルは、アクティブと見なされます。
適切な値は True か False です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SweepTiming
SynchronizationTiming パラメーターと同じタスクを実行します。 ただし、SweepTiming パラメーターは "スイープ" ジョブのスケジュールを設定します。 スイープ ジョブは SharePoint Foundation の変更ログによって駆動され、追加された新しいユーザーをキャプチャするための簡単な方法として使用されます。 たとえば、完全に同期されたサイトがあるが、そのサイトにユーザーが追加された場合などです。 スイープ ジョブにより、新しく追加されたユーザーのユーザー プロファイル プロパティがすばやくレプリケートされます。
既定値は 1 分ごとです。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SynchronizationTiming
メイン同期ジョブのスケジュールを設定します。 SPSchedule 形式のテキスト文字列を使用してスケジュールをメンションできます (たとえば、"15 分ごと" はジョブが 15 分ごとに実行されるようにスケジュールされていることを意味し、"毎日 09:00:00" は、ジョブが毎日午前 9 時に実行されるようにスケジュールされていることを意味します)。
既定値は 1 時間に 1 回です。
SPSchedule.FromString() 文字列メソッドを使用して、"毎 5 分" または "毎週 xxxxxxx" の文字列を渡すことができます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。