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 Cmdlets 的線上文件。

範例

------------------範例 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

This example sets the title of the SPWeb object in multiple lines and controls the rate of disposal. This is an advanced example. Only developers are advised to use it.

參數

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition