Start-SPAssignment

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

Start-SPAssignment コマンドレットは、変数の割り当てで使用されるオブジェクトを適切に破棄します。

一般に、SPWeb オブジェクト、SPSite オブジェクト、または SPSiteAdminsitration オブジェクトの使用時には大量のメモリが必要になります。 そのため、Windows PowerShellスクリプトでこれらのオブジェクトまたはこれらのオブジェクトのリストを使用するには、適切なメモリ管理が必要です。 既定では、すべての Get コマンドはパイプラインの終了直後にこれらのオブジェクトを破棄しますが、SPAssignment を使用すると、オブジェクトのリストを変数に割り当て、オブジェクトが不必要になった時点で破棄できます。 コマンドを繰り返し使用する場合でも、必要な間はオブジェクトを保持できます。

割り当てには、次の 3 つのレベルがあります。

-- 割り当てなし -- オブジェクトは変数に割り当てられず、コマンドの繰り返しごとに破棄されます。

-- 単純な割り当て -- すべてのオブジェクトがグローバル割り当てストアに割り当てられます。 この操作を実行するには、Global パラメーターを使用します。 このレベルを使用した場合、すべてのオブジェクトはグローバル ストアに割り当てられ、Stop-SPAssignment コマンドレットが呼び出されたときに破棄されます。

-- 高度な割り当て -- オブジェクトは、破棄のために名前付きストアに割り当てられます。 オブジェクトを破棄するには、 Stop-SPAssignment コマンドレットで Identity パラメーターを使用します。

使用される割り当てレベルに関係なく、Windows PowerShell実行領域が閉じられたときに、すべてのオブジェクトが破棄されます。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

Start-SPAssignment -global
$w = Get-SPWeb https://MyWeb
$w | Set-SPWeb -title "Accounting"
Stop-SPAssignment -global

この例では、単純な割り当てを使用します。 単純な割り当ての使い方は簡単ですが、単純な割り当てを有効にして複数の SPSite オブジェクトや SPWeb オブジェクト間で繰り返し処理を行うコマンドを実行することはお勧めしません。 複数のオブジェクトの繰り返しを試みる前に、 Stop-SPAssignment を実行してください。

$gc = Start-SPAssignment
$web = $gc | Get-SPWeb https://MyWeb
$web | Set-SPWeb -title "Accounting"
Stop-SPAssignment -SemiGlobal $gc

この例では、 SPWeb オブジェクトのタイトルを複数の行に設定し、破棄の頻度を制御しています。 これは高度な例です。 この使用法は開発者向けです。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。