Set-User
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2011-01-12
Use el cmdlet Set-User para modificar los atributos de los usuarios en el servicio de directorio de Active Directory.
Sintaxis
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>]
Descripción detallada
El cmdlet Set-User modifica los atributos de un usuario existente de Active Directory.
Para ejecutar el cmdlet Set-User, debe usar una cuenta en la que se delegue lo siguiente:
Función Administrador de destinatarios de Exchange
Función Operador de cuenta de los contenedores de Active Directory correspondientes
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción | ||
|---|---|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
El parámetro Identity toma uno de los siguientes valores:
|
||
AllowUMCallsFromNonUsers |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags |
Este parámetro especifica si se va a excluir al usuario de las búsquedas de directorio. |
||
AssistantName |
Opcional |
System.String |
El parámetro AssistantName define el nombre del ayudante del usuario. |
||
City |
Opcional |
System.String |
El parámetro City define la ciudad del usuario. |
||
Company |
Opcional |
System.String |
El parámetro Company define la empresa del usuario. |
||
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
||
CountryOrRegion |
Opcional |
Microsoft.Exchange.Data.Directory.CountryInfo |
El parámetro CountryOrRegion define el país o región del usuario. |
||
CreateDTMFMap |
Opcional |
System.Boolean |
Este parámetro especifica un mapa de tono de marcado de frecuencia múltiple (DTMF) que se crea para el usuario. |
||
Department |
Opcional |
System.String |
El parámetro Department define el departamento del usuario. |
||
DisplayName |
Opcional |
System.String |
El parámetro DisplayName define el nombre para mostrar del usuario. |
||
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración Active Directory, incluya el parámetro DomainController del comando. |
||
Fax |
Opcional |
System.String |
El parámetro Fax define el número de fax del usuario. |
||
FirstName |
Opcional |
System.String |
El parámetro FirstName define el nombre del usuario. |
||
HomePhone |
Opcional |
System.String |
El parámetro HomePhone define el número de teléfono particular del usuario. |
||
IgnoreDefaultScope |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:
|
||
Initials |
Opcional |
System.String |
El parámetro Initials define las iniciales del usuario. |
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.User |
El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts en los que se debe pasar un objeto completo al comando. |
||
LastName |
Opcional |
System.String |
El parámetro LastName define los apellidos del usuario. |
||
Manager |
Opcional |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
El parámetro Manager define el administrador del usuario. |
||
MobilePhone |
Opcional |
System.String |
El parámetro MobilePhone define el número de teléfono móvil principal del usuario. |
||
Name |
Opcional |
System.String |
El parámetro Name define el nombre común del usuario. |
||
Notes |
Opcional |
System.String |
El parámetro Notes define información adicional sobre el usuario. |
||
Office |
Opcional |
System.String |
El parámetro Office define el número o nombre de la oficina física del usuario. |
||
OtherFax |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro OtherFax define otro número de fax del usuario. |
||
OtherHomePhone |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro OtherHomePhone define otro número de teléfono particular del usuario. |
||
OtherTelephone |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro OtherTelephone define otro número de teléfono del usuario. |
||
Pager |
Opcional |
System.String |
El parámetro Pager define el número de localizador del usuario. |
||
Phone |
Opcional |
System.String |
El parámetro Phone define el número de teléfono de la oficina del usuario. |
||
PhoneticDisplayName |
Opcional |
System.String |
El parámetro PhoneticDisplayName especifica la pronunciación fonética del parámetro DisplayName. La longitud máxima del valor de este parámetro es de 255 caracteres. Para obtener más información acerca del parámetro PhoneticDisplayName y el reconocimiento de voz, consulte Descripción de las búsquedas en los directorios de reconocimiento de voz automático. |
||
PostalCode |
Opcional |
System.String |
El parámetro PostalCode define el código postal del usuario. |
||
PostOfficeBox |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro PostOfficeBox define el número del apartado de correos del usuario. |
||
ResetPasswordOnNextLogon |
Opcional |
System.Boolean |
El parámetro ResetPasswordOnNextLogon especifica si la contraseña especificada en el parámetro Password se debe restablecer la próxima vez que el usuario inicie sesión. El valor predeterminado es $true. |
||
SamAccountName |
Opcional |
System.String |
El parámetro SamAccountName especifica el nombre de inicio de sesión utilizado para admitir los clientes y servidores que ejecutan versiones anteriores del sistema operativo, tales como Microsoft Windows NT 4.0, Windows 98, Windows 95 y Administrador de LAN. Este atributo debe contener menos de 20 caracteres. |
||
SimpleDisplayName |
Opcional |
System.String |
El parámetro SimpleDisplayName se utiliza para mostrar una descripción alternativa del objeto cuando se permite únicamente un juego limitado de caracteres. Este juego limitado de caracteres consta de los siguientes: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
StateOrProvince |
Opcional |
System.String |
El parámetro StateOrProvince define el estado o la provincia del usuario. |
||
StreetAddress |
Opcional |
System.String |
El parámetro StreetAddress define la dirección física del usuario. |
||
TelephoneAssistant |
Opcional |
System.String |
El parámetro TelephoneAssistant define el número de teléfono del ayudante del usuario. |
||
Title |
Opcional |
System.String |
El parámetro Title define el cargo del usuario. |
||
UMDialPlan |
Opcional |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Este parámetro especifica el id. de objeto de directorio para el plan de marcado. |
||
UMDtmfMap |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica si desea crear un mapa DTMF definido por el usuario para el usuario habilitado para mensajería unificada. |
||
UserPrincipalName |
Opcional |
System.String |
El parámetro UserPrincipalName define el nombre principal de usuario (UPN) del usuario. |
||
UseRusServer |
Opcional |
System.String |
El parámetro UseRusServer indica al comando que use el servidor de buzones especificado en el que se esté ejecutando el servicio Lista de direcciones para obtener y establecer los atributos del buzón y del usuario de Active Directory. El servicio Lista de direcciones es un componente del servicio Operador de sistema de Exchange. El servicio Lista de direcciones crea y mantiene valores de atributo específicos de Exchange en Active Directory. El servicio Lista de direcciones se puede usar para actualizar objetos de destinatario de un dominio mediante el uso de información específica, como la pertenencia a una lista de direcciones y direcciones de correo electrónico. |
||
WebPage |
Opcional |
System.String |
El parámetro WebPage define la página web del usuario. |
||
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
||
WindowsEmailAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro WindowsEmailAddress especifica la dirección de correo electrónico del destinatario. |
.gif "note")
Nota:Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplos
Descripción
En el siguiente ejemplo, el comando Set-User se usa para establecer el nombre para mostrar del usuario Ted Bremer.
Código
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"
Descripción
En el siguiente ejemplo, el comando Set-User se usa para quitar el valor -manager. Para ello, se debe especificar $null de la siguiente manera:
Código
Set-User -Identity Contoso\Ted -manager $null