Start-SPAssignment

Inicia un nuevo almacén de asignación.

Syntax

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

Description

El Start-SPAssignment cmdlet elimina correctamente los objetos usados con asignaciones de variables.

A menudo se requieren grandes cantidades de memoria cuando se usan objetos SPWeb, SPSite o SPSiteAdminsitration. Por lo tanto, para usar estos objetos o listas de estos objetos en scripts de Windows PowerShell, se necesita una administración adecuada de la memoria. De forma predeterminada, todos los comandos Get eliminan estos objetos de inmediato tras finalizar la canalización, aunque con SPAssignment, puede asignar la lista de objetos a una variable y eliminar los objetos cuando no sean necesarios. También puede asegurarse de que los objetos permanezcan siempre que los necesite, incluso en varias iteraciones de comandos.

Hay tres niveles de asignación:

-- Sin asignación-- El objeto no se asigna a una variable y se elimina después de cada iteración del comando.

-- Asignación simple: todos los objetos se asignan al almacén de asignaciones global. Esto se hace con el parámetro Global. Cuando se usa este nivel, todos los objetos se asignan a un almacén global y se eliminan cuando se llama al cmdlet Stop-SPAssignment.

-- Asignación avanzada-- Los objetos se asignan a almacenes con nombre para su eliminación. Puede eliminar objetos mediante el parámetro Identity con el Stop-SPAssignment cmdlet .

Independientemente del nivel de asignación usado, todos los objetos se eliminan cuando se cierra el espacio de ejecución de Windows PowerShell.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

------------------EJEMPLO 1-----------------------

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

En este ejemplo se usa una asignación simple. Aunque es más sencillo usar una asignación simple, no es una buena idea ejecutar comandos con iteración en varios objetos SPSite o SPWeb cuando la asignación simple esté habilitada. Asegúrese de ejecutar Stop-SPAssignment antes de intentar cualquier iteración de varios objetos.

------------------EJEMPLO 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.

Parámetros

- 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

Si usa este parámetro, todos los objetos se asignan a la duración del script y se eliminan cuando se llama al Stop-SPAssignment cmdlet.

Si no usa este parámetro, debe asignar la salida de este cmdlet a una variable y, a continuación, eliminar objetos mediante el parámetro Identity del Stop-SPAssignment cmdlet.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition