Set-SPUser
Configure les propriétés d’un utilisateur existant.
Syntax
Set-SPUser
[-Identity] <SPUserPipeBind>
[-AddPermissionLevel <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-ClearPermissions]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-IsSiteCollectionAdmin]
[-PassThru]
[-RemovePermissionLevel <String[]>]
[-SyncFromAD]
[-Web <SPWebPipeBind>]
[-WhatIf]
[<CommonParameters>]
Description
L’applet Set-SPUser
de commande configure les propriétés d’un utilisateur existant.
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-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"
Cet exemple montre comment définir un utilisateur (Contoso\jdoe) comme contributeur sur https://intranet.contoso.com.
------------------EXEMPLE 2-----------------------
Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromAD
Cela met à jour la liste d’informations utilisateur de l’utilisateur « contoso\jdoe » avec les valeurs actuelles displayName
et mail
d’attribut du compte Active Directory de l’utilisateur.
Paramètres
-AddPermissionLevel
Spécifie le niveau d’autorisation à ajouter à l’utilisateur.
La valeur doit être l’une des options suivantes :
--Contribuer
Peut afficher, ajouter, mettre à jour et supprimer des éléments de liste et des documents.
--Conception
Peut afficher, ajouter, mettre à jour, supprimer, approuver et personnaliser des documents.
--Contrôle total
Dispose d’un contrôle total sur tous les documents.
--Accès limité
Peut afficher des listes, des bibliothèques de documents, des éléments de liste, des dossiers ou des documents spécifiques lorsque des autorisations sont accordées.
--Lire
Peut afficher des pages et des éléments de liste et télécharger des documents.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-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 |
-ClearPermissions
Supprime toutes les autorisations accordées à l’utilisateur. S’il existe des valeurs Effacer et Ajouter, les autorisations sont d’abord effacées, puis de nouvelles autorisations sont ajoutées.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Confirm
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-DisplayName
Spécifie le nouveau nom complet de l’utilisateur.
Le type doit correspondre à un nom valide.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
Spécifie la nouvelle adresse de messagerie de l’utilisateur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Group
Ajoute l’utilisateur à un groupe existant dans le site donné.
Type: | SPGroupPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Identity
Spécifie le GUID, le nom de connexion ou l’objet SPUser de l’utilisateur à retourner.
Le type doit être un GUID d’un utilisateur existant au format 1234-5678-9876-0987.
Type: | SPUserPipeBind |
Aliases: | UserAlias |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-IsSiteCollectionAdmin
Spécifie si l’utilisateur est défini comme administrateur de collection de sites.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-PassThru
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é.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-RemovePermissionLevel
Supprime le niveau d’autorisation de l’utilisateur.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-SyncFromAD
S’il est fourni, indique que les informations utilisateur doivent être synchronisées à partir du magasin d’annuaires. Ce commutateur récupère uniquement la displayName
valeur et mail
à partir du magasin d’annuaires. Il prend en charge Active Directory (classique ou Authentification Windows), l’authentification basée sur les formulaires et SAML. Les fournisseurs FBA et SAML doivent prendre en charge la résolution à partir de leur magasin d’annuaires pour que ce commutateur fonctionne. Le commutateur prend uniquement en charge les objets Utilisateur SharePoint.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Web
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 https://server_name, ou GUID, au format 1234-5678-9807.
Type: | SPWebPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Affiche un message qui explique l’effet de la commande au lieu de l’exécuter.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |