Start-SPAssignment
初始化新的工作分派儲存區。
語法
Default (預設值)
Start-SPAssignment
[-AssignmentCollection <SPAssignmentCollection>]
[-Global]
[<CommonParameters>]
Description
Start-SPAssignment Cmdlet 會正確處置與變數指派一起使用的物件。
使用 SPWeb、SPSite 或 SPSiteAdminsitration 物件時，通常需要大量的記憶體。 因此，在 Windows PowerShell 指令碼中使用這些物件或這些物件的清單需要適當的記憶體管理。 所有的 Get 命令都預設在管線完成後立即處置這些物件，但使用 SPAssignment 可將物件清單指派給變數，在不需要物件後再處置物件。 即使命令經過多次重複執行，您也可以確定只要有需要即可保留物件。
工作分派分三級：
-- 無指派 -- 物件不會指派給變數，並在命令的每次反覆之後丟棄。
-- 簡單指派 -- 所有物件都會指派給全域指派存放區。 使用 Global 參數即可完成此作業。 使用此等級時，所有的物件都會指派給全域工作分派儲存區，並於呼叫 Stop-SPAssignment Cmdlet 時加以處置。
-- 進階指派 -- 物件會指派給具名的儲存進行處置。 您可以使用 Identity 參數搭配 Stop-SPAssignment Cmdlet 來處置物件。
無論使用的指派級別為何，當 Windows PowerShell 執行空間關閉時，所有物件都會被丟棄。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
Start-SPAssignment -global
$w = Get-SPWeb https://MyWeb
$w | Set-SPWeb -title "Accounting"
Stop-SPAssignment -global
此範例會使用簡易的工作分派。
雖然簡易的工作分派較容易使用，但不建議在啟用簡易工作分派時，執行會重複執行多個 SPSite 或 SPWeb 物件的命令。
在嘗試多個物件的任何反覆運算之前，請確定您已執行 Stop-SPAssignment 。
範例 2
$gc = Start-SPAssignment
$web = $gc | Get-SPWeb https://MyWeb
$web | Set-SPWeb -title "Accounting"
Stop-SPAssignment -SemiGlobal $gc
此範例會將 SPWeb 物件的標題設在多行中，並控制處置率。 這是進階的範例。 建議只有開發人員才使用。
參數
-AssignmentCollection
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Global
適用項目：SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
如果使用此參數，則會將所有物件指派給指令碼的存留期，並在呼叫 Cmdlet 時 Stop-SPAssignment 遭到丟棄。
如果不使用此參數，則必須將此 Cmdlet 的輸出指派給變數，然後使用 Cmdlet 的 Stop-SPAssignment Identity 參數來處置物件。
參數屬性
| 類型: | 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。