Start-SPAssignment

Module:

sharepoint-server

S’applique à:

SharePoint Server Subscription Edition

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 des 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 de Stop-SPAssignment 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 de tenter d’effectuer 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

Cet exemple montre comment définir le titre de l’objet SPWeb sur plusieurs lignes et contrôler le taux de destruction. Il s’agit d’un exemple avancé. Seuls les développeurs sont invités à l’utiliser.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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 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 les objets à l’aide du paramètre Identity de l’applet Stop-SPAssignment de commande.

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