Start-SPAssignment

發行項
03/07/2017

適用版本： SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間： 2015-03-09

初始化新的工作分派儲存區。

Syntax

Start-SPAssignment [-AssignmentCollection <SPAssignmentCollection>] [-Global <SwitchParameter>]

詳細描述

Start-SPAssignment Cmdlet 會正確處置與變數工作分派一起使用的物件。

使用 SPWeb、SPSite 或 SPSiteAdminsitration 物件時，通常需要大量的記憶體。所以在 Windows PowerShell 指令碼中使用或列出這些物件時，需要正確管理記憶體。所有的 Get 命令都預設在管線完成後立即處置這些物件，但使用 SPAssignment 可將物件清單指派給變數，在不需要物件後再處置物件。即使各方面都歷經多次重複命令，您也可以確定只要有需要即可保留物件。

工作分派分三級：

-- No assignment -- 物件未指派給變數，且在每次重複命令後才予以處置。

-- Simple assignment -- 所有的物件都指派給全域工作分派儲存區。使用 Global 參數即可完成此作業。使用此等級時，所有的物件都會指派給全域工作分派儲存區，並於呼叫 Stop-SPAssignment Cmdlet 時加以處置。

-- Advanced assignment -- 物件被指派給具名的儲存區以待處置。您可使用 Identity 參數搭配 Stop-SPAssignment Cmdlet 處置物件。

注意

無論所用工作分派等級為何，當 PowerShell Runspace 關閉時，所有物件都會予以處置。

如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

參數	必要	輸入	描述
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
Global	選用	System.Management.Automation.SwitchParameter	若使用此參數，所有的物件都會指派給指令碼週期，並於呼叫 Stop-SPAssignment Cmdlet 時加以處置。若不使用此參數，即必須將此 Cmdlet 的輸出指派給變數，然後使用 Stop-SPAssignment Cmdlet 的 Identity 參數處置物件。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。

注意

使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。

Global

選用

System.Management.Automation.SwitchParameter

若使用此參數，所有的物件都會指派給指令碼週期，並於呼叫 Stop-SPAssignment Cmdlet 時加以處置。

若不使用此參數，即必須將此 Cmdlet 的輸出指派給變數，然後使用 Stop-SPAssignment Cmdlet 的 Identity 參數處置物件。

輸入類型

傳回類型

SPAssignmentCollection

錯誤

錯誤	描述

Exceptions

例外狀況	描述

Example

------------------範例 1-----------------------

Start-SPAssignment -global

$w = Get-SPWeb http://MyWeb

$w | Set-SPWeb -title "Accounting"

Stop-SPAssignment -global

此範例會使用簡易的工作分派。雖然簡易的工作分派較容易使用，但不建議在執行於多個 SPSite 或 SPWeb 物件中重複的命令時，啟用簡易的工作分派。嘗試任何一種多物件重複前，請先確定 Stop-SPAssignment 為執行中。

------------------範例 2-----------------------

$gc = Start-SPAssignment

$web = $gc | Get-SPWeb http://MyWeb

$web | Set-SPWeb -title "Accounting"

Stop-SPAssignment -Identity $gc

此範例會將 SPWeb 物件的標題設在多行中，並控制處置率。這是進階的範例。建議只有開發人員才使用。

共用方式為