Start-SPAssignment

Módulo:

sharepoint-server

Se aplica a:

SharePoint Server Subscription Edition

Inicia un nuevo almacén de asignaciones.

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

En este ejemplo se establece el título del objeto SPWeb en varias líneas y se controla la velocidad de eliminación. Este es un ejemplo avanzado. Solamente se recomienda su uso por parte de desarrolladores.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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