Update-SPProfileSync
根據指定的參數匯報使用者設定檔同步作業的組態。
語法
Default (預設值)
Update-SPProfileSync
[[-ExcludeWebApplications] <String>]
[[-SynchronizationTiming] <String>]
[[-SweepTiming] <String>]
[[-IgnoreIsActive] <Boolean>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-SPProfileSync Cmdlet 會根據指定的參數更新使用者設定檔同步作業的設定。
範例
範例 1
Update-SPProfileSync -IgnoreIsActive:$false
本範例會更新 [使用者設定檔同步處理] 工作，標記為同步處理所有使用者，而不論其活動為何，且不會提示使用者確認。
範例 2
Update-SPProfileSync -SynchronizationTiming "every 15 minutes"
本範例會更新 [使用者設定檔同步處理] 工作，標記為每 15 分鐘執行一次，而不會提示使用者確認。
參數
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcludeWebApplications
在同步處理程序中要排除的 Web 應用程式 URL 逗號分隔清單。
指定的值會刪除任何現有的值集。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IgnoreIsActive
指定是只同步處理使用中的設定檔，還是同步處理所有設定檔。 為網站做出貢獻的使用者的使用者設定檔被視為作用中。
有效值為 True 或 False 。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SweepTiming
執行與 SynchronizationTiming 參數相同的工作。 不過，SweepTiming 參數會設定「掃描」工作的排程。 清理工作由 SharePoint Foundation 變更記錄驅動，並用來做為擷取新增使用者的輕量型方式。 例如，您可能有一個完全同步處理的網站，但隨後將使用者新增至網站。 清理作業可確保新增的增量使用者可快速取得複製使用者設定檔屬性。
預設值為每 1 分鐘一次。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SynchronizationTiming
設定主要同步處理工作的排程。 您可以使用 SPSchedule 格式的文字字串提及排程 (例如，「每 15 分鐘」表示工作排定為每 15 分鐘執行一次，「每天 09：00：00」表示工作排定在每天上午 9 點執行) 。
預設值為每小時一次。
您可以使用 SPSchedule.FromString () 字串方法來傳入字串，“every 5 minutes” 或 “weekly xxxxxxx”。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。