Update-SPProfileSync
匯報 根據指定的參數設定使用者配置檔同步處理作業。
語法
Default (預設值)
Update-SPProfileSync
[[-ExcludeWebApplications] <String>]
[[-SynchronizationTiming] <String>]
[[-SweepTiming] <String>]
[[-IgnoreIsActive] <Boolean>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-SPProfileSync Cmdlet 會根據指定的參數，更新 User Profile Synchronization 作業的設定。
範例
範例 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：00」表示作業排定每天上午9點執行) 。
預設值為每小時一次。
您可以使用 SPSchedule.FromString () 字串方法來傳入字串「每 5 分鐘」或「每周 xxxxxxx」。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
參數屬性
| 類型: | 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。