共用方式為


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