Set-Contact

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-12

Utilice el cmdlet Set-Contact para modificar la configuración de un contacto existente.

Sintaxis

Set-Contact -Identity <ContactIdParameter> [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-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 <Contact>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descripción detallada

Puede usar el cmdlet Set-Contact para modificar la configuración de los objetos de contacto visibles en los equipos y usuarios de Active Directory. Si el contacto tiene habilitado el correo, use el cmdlet de Set-MailContact para modificar la configuración de correo electrónico del contacto que no esté disponible mediante el cmdlet Set-Contact.

Para ejecutar el cmdlet Set-Contact, la cuenta que use debe tener delegadas las siguientes funciones:

  • Función Administrador de destinatarios de Exchange

  • Función de operadores de cuentas para los contenedores Active Directory aplicables

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.ContactIdParameter

El parámetro Identity especifica el objeto que desea modificar. El parámetro Identity puede adoptar cualquiera de los siguientes valores para el objeto del contacto:

  • GUID

  • Nombre completo (DN)

  • Nombre canónico

  • Nombre

El parámetro Identity no se puede usar si se ha especificado el parámetro Instance.

AllowUMCallsFromNonUsers

Opcional

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Este parámetro especifica si se va a excluir el contacto en las búsquedas de directorio.

AssistantName

Opcional

System.String

Este parámetro AssistantName define el nombre del ayudante del contacto.

City

Opcional

System.String

El parámetro City define la ciudad del contacto.

Company

Opcional

System.String

El parámetro Company define la compañía del contacto.

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 la región o el país del contacto.

CreateDTMFMap

Opcional

System.Boolean

Este parámetro especifica un mapa de tono de marcado multifrecuencia (DTMF) que se crea para el contacto.

Department

Opcional

System.String

El parámetro Department define el departamento del contacto.

DisplayName

Opcional

System.String

Puede usar el parámetro DisplayName para especificar el nombre del contacto en la Consola de administración de Exchange y en la lista de direcciones global (GAL) de Exchange. DisplayName sólo tiene significado para los objetos habilitados para correo.

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 en el servicio de directorio de Active Directory, incluya el parámetro DomainController.

Fax

Opcional

System.String

El parámetro Fax define el número de fax del contacto.

FirstName

Opcional

System.String

El parámetro FirstName define el nombre dado del contacto.

HomePhone

Opcional

System.String

El parámetro HomePhone define el número de teléfono particular del contacto.

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 use 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 nombre del contacto.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.Contact

El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se usa principalmente en scripts en los que se debe pasar un objeto completo al comando.

El parámetro Instance no se puede usar si se ha especificado el parámetro Identity.

LastName

Opcional

System.String

El parámetro LastName define los apellidos del contacto.

Manager

Opcional

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

El parámetro Manager define el supervisor del contacto.

MobilePhone

Opcional

System.String

El parámetro MobilePhone define el número principal del teléfono móvil del contacto.

Name

Opcional

System.String

El parámetro Name especifica el nombre del contacto en Usuarios y equipos de Active Directory y, además, en el campo Nombre de grupo de la Consola de administración de Exchange si se ha habilitado el grupo para usar el correo.

El valor Name no puede superar los 64 caracteres.

Notes

Opcional

System.String

El parámetro Notes define la información adicional acerca del contacto.

Office

Opcional

System.String

El parámetro Office define el nombre o número de la oficina física del contacto.

OtherFax

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro OtherFax define el número de fax alternativo del contacto.

OtherHomePhone

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro OtherHomePhone define el número de teléfono particular alternativo del contacto.

OtherTelephone

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro OtherTelephone define el número de teléfono del trabajo alternativo del contacto.

Pager

Opcional

System.String

El parámetro Pager define el número de localizador del contacto.

Phone

Opcional

System.String

El parámetro Phone define el número de teléfono de la oficina del contacto.

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.

PostalCode

Opcional

System.String

El parámetro PostalCode define el código postal del contacto.

PostOfficeBox

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro PostOfficeBox define el número de apartado postal del contacto.

SimpleDisplayName

Opcional

System.String

El parámetro SimpleDisplayName se usa para mostrar una descripción alternativa del objeto cuando se permite únicamente un juego limitado de caracteres. Este conjunto de caracteres limitado consta de los siguientes caracteres:

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

SimpleDisplayName sólo tiene significado para los objetos habilitados para correo.

StateOrProvince

Opcional

System.String

El parámetro StateOrProvince define el estado o provincia del contacto.

StreetAddress

Opcional

System.String

El parámetro StreetAddress define la dirección física del contacto.

TelephoneAssistant

Opcional

System.String

El parámetro TelephoneAssistant define el número de teléfono del ayudante del contacto.

Title

Opcional

System.String

El parámetro Title define el puesto del contacto.

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 contacto habilitado para mensajería unificada.

UseRusServer

Opcional

System.String

noteNota:
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 el la página web del contacto.

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 contacto que está almacenada en Active Directory.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El siguiente ejemplo de código muestra cómo usar el comando Set-Contact para implementar los siguientes cambios en un contacto existente con el nombre Ted Bremer en el contenedor Usuarios del dominio de Active Directory con el nombre contoso.com:

  • Cambie el valor de ciudad a Caracas.

  • Cambie el valor de empresa a Contoso.

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"