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: GUID Nombre distintivo (DN) Dominio\Cuenta Nombre principal de usuario (UPN) DN de Exchange heredado Dirección del Protocolo simple de transferencia de correo (SMTP) Alias
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: No puede usar el parámetro DomainController. El comando usará un servidor de catálogo global adecuado automáticamente. Sólo puede usar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.
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	Nota: Este parámetro sólo está disponible en Exchange 2007 SP2. 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.

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