Start-SPAssignment

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

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

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 Subscription Edition

-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 Subscription Edition