Set-User

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2011-01-12

La cmdlet Set-User permet de modifier des attributs utilisateur dans le service d’annuaire Active Directory.

Syntaxe

set-User -Identity <UserIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-User [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <User>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Description détaillée

La cmdlet Set-User modifie les attributs d’un utilisateur existant dans Active Directory.

Pour exécuter la cmdlet Set-User, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Le paramètre Identity prend l'une des valeurs suivantes :

  • GUID

  • Nom unique

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • Nom unique Exchange hérité

  • Adresse SMTP (Simple Mail Transfer Protocol)

  • Alias

AllowUMCallsFromNonUsers

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Ce paramètre spécifie d'exclure l'utilisateur des recherches dans l'annuaire.

AssistantName

Facultatif

System.String

Le paramètre AssistantName définit le nom de l’assistant de l'utilisateur.

City

Facultatif

System.String

Le paramètre City définit la ville de l’utilisateur.

Company

Facultatif

System.String

Le paramètre Company définit la société de l’utilisateur.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

CountryOrRegion

Facultatif

Microsoft.Exchange.Data.Directory.CountryInfo

Le paramètre CountryOrRegion définit le pays ou la région de l’utilisateur.

CreateDTMFMap

Facultatif

System.Boolean

Ce paramètre indique qu’une carte DTMF (multifréquence bi-tonalité) peut être créée pour l’utilisateur.

Department

Facultatif

System.String

Le paramètre Department définit le département de l’utilisateur.

DisplayName

Facultatif

System.String

Le paramètre DisplayName définit le nom complet de l’utilisateur.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

Fax

Facultatif

System.String

Le paramètre Fax définit le numéro de télécopie de l’utilisateur.

FirstName

Facultatif

System.String

Le paramètre FirstName définit le prénom de l’utilisateur.

HomePhone

Facultatif

System.String

Le paramètre HomePhone définit le numéro de téléphone personnel de l’utilisateur.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

Initials

Facultatif

System.String

Le paramètre Initials définit les initiales de l’utilisateur.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.Management.User

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

LastName

Facultatif

System.String

Le paramètre LastName définit le nom de famille de l’utilisateur.

Manager

Facultatif

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Le paramètre Manager définit le responsable de l’utilisateur.

MobilePhone

Facultatif

System.String

Le paramètre MobilePhone définit le numéro de téléphone mobile principal de l’utilisateur.

Name

Facultatif

System.String

Le paramètre Name spécifie le nom commun de l'utilisateur.

Notes

Facultatif

System.String

Le paramètre Notes définit des informations supplémentaires sur l’utilisateur.

Office

Facultatif

System.String

Ce paramètre Office définit le nom ou le numéro professionnel physique de l’utilisateur.

OtherFax

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre OtherFax définit l'autre numéro de télécopie de l’utilisateur.

OtherHomePhone

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre OtherHomePhone définit l'autre numéro de téléphone personnel de l’utilisateur.

OtherTelephone

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre OtherTelephone définit l'autre numéro de téléphone professionnel de l’utilisateur.

Pager

Facultatif

System.String

Le paramètre Pager définit le numéro de récepteur de radiomessagerie de l’utilisateur.

Phone

Facultatif

System.String

Le paramètre Phone définit le numéro de téléphone professionnel de l’utilisateur.

PhoneticDisplayName

Facultatif

System.String

Le paramètre PhoneticDisplayName spécifie une prononciation phonétique pour le paramètre DisplayName.

La longueur maximale de cette valeur de paramètre est de 255 caractères. Pour plus d'informations sur le paramètre PhoneticDisplayName et la reconnaissance vocale, consultez la rubrique Présentation des recherches dans l'annuaire de reconnaissance vocale automatique.

PostalCode

Facultatif

System.String

Le paramètre PostalCode définit le code postal de l’utilisateur.

PostOfficeBox

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre PostOfficeBox définit le numéro de boîte postale de l’utilisateur.

ResetPasswordOnNextLogon

Facultatif

System.Boolean

Le paramètre ResetPasswordOnNextLogon spécifie si le mot de passe spécifié dans le paramètre Password doit être redéfini lors de la prochaine ouverture de session de l'utilisateur. La valeur par défaut est $true.

SamAccountName

Facultatif

System.String

Le paramètre SamAccountName spécifie le nom de connexion utilisé pour prendre en charge des clients et des serveurs exécutant des versions plus anciennes du système d'exploitation, telles que Microsoft Windows NT 4.0, Windows 98, Windows 95 et LAN Manager. Cet attribut doit comporter moins de 20 caractères

SimpleDisplayName

Facultatif

System.String

Le paramètre SimpleDisplayName permet d'afficher une autre description de l'objet lorsque seul un jeu de caractères limité est autorisé. Le jeu de caractères limité comprend les caractères suivants :

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

StateOrProvince

Facultatif

System.String

Le paramètre StateOrProvince définit l'état ou la province de l’utilisateur.

StreetAddress

Facultatif

System.String

Le paramètre StreetAddress définit l'adresse physique de l’utilisateur.

TelephoneAssistant

Facultatif

System.String

Le paramètre TelephoneAssistant définit le numéro de téléphone de l'assistant de l'utilisateur.

Title

Facultatif

System.String

Le paramètre Title définit le titre de l’utilisateur.

UMDialPlan

Facultatif

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Ce paramètre spécifie l'identificateur d'objet Annuaire pour le plan de commutation des appels.

UMDtmfMap

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre indique si vous voulez créer une carte DTMF définie par l'utilisateur pour l’utilisateur à extension messagerie unifiée.

UserPrincipalName

Facultatif

System.String

Le paramètre UserPrincipalName définit le nom d'utilisateur principal (UPN) de l’utilisateur.

UseRusServer

Facultatif

System.String

 > [!Note] > Ce paramètre n'est disponible que dans Exchange 2007 SP2.

Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory.

Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie.

WebPage

Facultatif

System.String

Le paramètre WebPage définit la page Web de l’utilisateur.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

WindowsEmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre WindowsEmailAddress spécifie l'adresse de messagerie du destinataire.

Types d'entrées

Types de retours

Erreurs

Erreur Description

  

 

Exceptions

Exceptions Description

  

 

Exemples

Description

Dans l'exemple suivant, la commande Set-User est utilisée pour définir le nom complet de l'utilisateur Ted Bremer.

Code

Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"

Description

Dans l'exemple suivant, la commande Set-User permet de supprimer la valeur -manager. Pour ce faire, vous devez spécifier $null comme suit :

Code

Set-User -Identity Contoso\Ted -manager $null