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:
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:
|
||
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 |
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. |
.gif "note")
Nota: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"