Set-User (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
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> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]
set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-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 utilizar una cuenta en la que se delegue lo siguiente:
Función Administrador de destinatarios de Exchange
Función de operador de cuentas para los contenedores 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:
|
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. |
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 multifrecuencia (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. |
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 donde hay que 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. |
Notas |
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 del parámetro DisplayName. La longitud máxima de este valor de parámetro es de 255 caracteres. Para obtener más información acerca del parámetro PhoneticDisplayName, vea Descripción de las búsquedas en los directorios de reconocimiento de voz automático (en inglés). |
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 conjunto consta de los caracteres ASCII del 26 al 126, ambos incluidos. |
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. |
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 de llamadas. |
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. |
WebPage |
Opcional |
System.String |
El parámetro WebPage define la página web del usuario. |
WindowsEmailAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro WindowsEmailAddress especifica la dirección de correo electrónico del destinatario. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
En el siguiente ejemplo, el comando Set-User se usa para establecer el nombre para mostrar del usuario Ted Bremer.
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"