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: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。