Start-SPAssignment
初始化新的工作分派儲存區。
Syntax
Start-SPAssignment
[-AssignmentCollection <SPAssignmentCollection>]
[-Global]
[<CommonParameters>]Description
Cmdlet Start-SPAssignment 會正確處置搭配變數指派使用的物件。
使用 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
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。
如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Global
如果您使用此參數，則會將所有物件指派給腳本的存留期，並在呼叫 Cmdlet 時 Stop-SPAssignment 處置。
如果您未使用此參數，則必須將此 Cmdlet 的輸出指派給變數，然後使用 Cmdlet 的 Stop-SPAssignment Identity 參數來處置物件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |