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

-Global