Start-SPAssignment

Lance un nouveau stockage d’affectations.

Syntax

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

Description

L’applet Start-SPAssignment de commande supprime correctement les objets utilisés avec les affectations de variables.

L’utilisation d’objets SPWeb, SPSite ou SPSiteAdminsitration nécessite généralement d’importants volumes de mémoire. L'utilisation de ces objets, ou de listes de ces objets, dans les scripts Windows PowerShell requiert dès lors une gestion adéquate de la mémoire. Par défaut, toutes les commandes Get éliminent ces objets immédiatement au terme du pipeline, mais vous pouvez utiliser SPAssignment pour affecter la liste des objets à une variable et éliminer les objets lorsqu'ils sont devenus inutiles. Vous pouvez également vous assurer que les objets restent tant que vous en avez besoin, même pour plusieurs itérations de commandes.

Il existe trois niveaux d’affectation :

-- Aucune affectation - L’objet n’est pas affecté à une variable et est supprimé après chaque itération de la commande.

-- Affectation simple - Tous les objets sont affectés au magasin d’affectations global. Pour cela, utilisez le paramètre Global. Lorsque vous utilisez ce niveau, tous les objets sont affectés à un stockage global et sont éliminés à l’appel de la commande Stop-SPAssignment.

-- Affectation avancée -- Les objets sont affectés à des magasins nommés à des fins d’élimination. Vous pouvez supprimer des objets à l’aide du paramètre Identity avec l’applet Stop-SPAssignment de commande.

Quel que soit le niveau d’affectation utilisé, tous les objets sont supprimés lorsque l’espace d’exécution Windows PowerShell est fermé.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

------------------EXEMPLE 1-----------------------

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

Cet exemple utilise l'affectation simple. Bien que celle-ci soit plus facile à utiliser, il est déconseillé d'exécuter des commandes qui itèrent plusieurs objets SPSite ou SPWeb avec ce type d'affectation. Veillez à exécuter Stop-SPAssignment avant d’essayer des itérations de plusieurs objets.

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

Paramètres

-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 vous utilisez ce paramètre, tous les objets sont affectés à la durée de vie du script et sont supprimés lorsque l’applet Stop-SPAssignment de commande est appelée.

Si vous n’utilisez pas ce paramètre, vous devez affecter la sortie de cette applet de commande à une variable, puis supprimer des objets à l’aide du paramètre Identity de l’applet Stop-SPAssignment de commande.

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