Set-SPUser
S’applique à :
Configure les propriétés d’un utilisateur existant.
Set-SPUser [-Identity] <SPUserPipeBind> [-AddPermissionLevel <String[]>] [-AssignmentCollection <SPAssignmentCollection>] [-ClearPermissions <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Email <String>] [-Group <SPGroupPipeBind>] [-IsSiteCollectionAdmin <SwitchParameter>] [-PassThru <SwitchParameter>] [-RemovePermissionLevel <String[]>] [-SyncFromAD <SwitchParameter>] [-Web <SPWebPipeBind>] [-WhatIf [<SwitchParameter>]]
Paramètres
| Paramètre | Requis | Type | Description | ||
|---|---|---|---|---|---|
| Identity | Requis | Microsoft.SharePoint.PowerShell.SPUserPipeBind | Spécifie le GUID, le nom de connexion ou l’objet SPUser de l’utilisateur à renvoyer. Le type doit être le GUID d’un utilisateur existant, au format 1234-5678-9876-0987. | ||
| AddPermissionLevel | Facultatif | System.String[] | Spécifie le niveau d’autorisation à ajouter à l’utilisateur. La valeur doit être l’une des options suivantes : --Contribution Peut consulter, ajouter, mettre à jour et supprimer des éléments de liste et des documents. --Création Peut consulter, ajouter, mettre à jour, supprimer, approuver et personnaliser des documents. Contrôle total Possède un contrôle total sur tous les documents. --Accès limité Peut consulter des listes, bibliothèques de documents, éléments de liste, dossiers ou documents spécifiques lorsque les autorisations correspondantes sont accordées. --Lecture Peut consulter des pages et des éléments de liste, ainsi que télécharger des documents. | ||
| AssignmentCollection | Facultatif | Microsoft.SharePoint.PowerShell.SPAssignmentCollection | 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.
| ||
| ClearPermissions | Facultatif | System.Management.Automation.SwitchParameter | Supprime toutes les autorisations accordées à l’utilisateur. Si les valeurs Clear et Add existent, les autorisations sont d’abord annulées, puis les nouvelles autorisations sont ajoutées. | ||
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters | ||
| DisplayName | Facultatif | System.String | Spécifie le nouveau nom complet de l’utilisateur. Le type doit correspondre à un nom valide. | ||
| | Facultatif | System.String | Spécifie la nouvelle adresse de messagerie de l’utilisateur. | ||
| Group | Facultatif | Microsoft.SharePoint.PowerShell.SPGroupPipeBind | Ajoute l’utilisateur à un groupe existant dans le site donné. | ||
| IsSiteCollectionAdmin | Facultatif | Aucune | Spécifie si l’utilisateur est défini comme administrateur de collection de sites. | ||
| PassThru | Facultatif | Aucune | S’il n’est pas fourni, indique que cette applet de commande n’a aucune sortie. S’il est fourni, ce paramètre indique que l’objet SPUser de cet utilisateur doit être renvoyé. | ||
| RemovePermissionLevel | Facultatif | System.String[] | Supprime le niveau d’autorisation de l’utilisateur. | ||
| SyncFromAD | Facultatif | System.Management.Automation.SwitchParameter | S’il est fourni, indique que les informations utilisateur doivent être synchronisées à partir du magasin d’annuaires. | ||
| Web | Facultatif | Microsoft.SharePoint.PowerShell.SPWebPipeBind | Spécifie le nom de l’URL ou du GUID à utiliser en tant qu’étendue. Ce paramètre n’est pas nécessaire si l’objet SPUser est fourni en tant qu’identité. La valeur doit être une URL authentique, au format http://nom_serveur, ou un GUID, au format 1234-5678-9807. | ||
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters |
Description détaillée
L’applet de commande Set-SPUser configure les propriétés d’un utilisateur existant.
Types d’entrée
Types retournés
------------------EXEMPLE-----------------------
Set-SPUser -Identity ‘Contoso\jdow’ –Web http:// test –AddPermissionLevel "Contributor"
Cet exemple définit un utilisateur (Contoso\jdow) comme collaborateur sur http://test.

Remarque :