Set-DistributionGroup
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-10-20
Utilice el cmdlet Set-DistributionGroup para modificar la configuración de un grupo de distribución existente.
Sintaxis
Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Descripción detallada
Los grupos de distribución se utilizan para consolidar grupos de destinatarios en un único punto de contacto para los mensajes de correo electrónico. Los grupos de distribución no pueden usarse para asignar permisos a los recursos de red en el servicio de directorio de Active Directory. Puede usar el cmdlet Set-DistributionGroup para sobrescribir la configuración existente o agregar nuevos parámetros.
Para ejecutar el cmdlet Set-DistributionGroup, la cuenta utilizada debe tener delegado lo siguiente:
- Función Administrador de destinatarios de Exchange
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción | ||
|---|---|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter |
El parámetro Identity especifica el objeto que desea modificar. El parámetro Identity puede tomar cualquiera de los valores siguientes para el grupo de distribución:
El parámetro Identity no se puede utilizar si se ha especificado el parámetro Instance. |
||
AcceptMessagesOnlyFrom |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFrom especifica los usuarios del buzón, los usuarios de correo y los contactos de correo que pueden enviar mensajes de correo electrónico a este grupo de distribución. También puede especificar Microsoft Exchange como destinatario válido para este parámetro. Si configura un grupo de distribución para que sólo acepte mensajes del destinatario de Microsoft Exchange, sólo recibirá mensajes generados por el sistema. El parámetro AcceptMessagesOnlyFrom puede utilizar cualquiera de los valores siguientes para los remitentes válidos:
De forma predeterminada, el valor de este parámetro está en blanco. Esto permite que el grupo de distribución acepte los mensajes de todos los remitentes. |
||
AcceptMessagesOnlyFromDLMembers |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFromDLMembers especifica los grupos de distribución cuyos miembros pueden enviar mensajes de correo electrónico a este grupo de distribución. Puede utilizar uno de los siguientes valores para los grupos de distribución permitidos:
De forma predeterminada, el valor de este parámetro está en blanco. Esto permite que el grupo de distribución acepte los mensajes de todos los remitentes. |
||
Alias |
Opcional |
System.String |
El parámetro Alias puede utilizarse para especificar el alias del objeto. El valor de Alias no puede contener espacios. |
||
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. |
||
CreateDTMFMap |
Opcional |
System.Boolean |
Este parámetro especifica un mapa de tono de marcado multifrecuencia (DTMF) que se crea para el grupo de distribución. |
||
CustomAttribute1 |
Opcional |
System.String |
El parámetro CustomAttribute1 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute10 |
Opcional |
System.String |
El parámetro CustomAttribute10 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute11 |
Opcional |
System.String |
El parámetro CustomAttribute11 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute12 |
Opcional |
System.String |
El parámetro CustomAttribute12 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute13 |
Opcional |
System.String |
El parámetro CustomAttribute13 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute14 |
Opcional |
System.String |
El parámetro CustomAttribute14 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute15 |
Opcional |
System.String |
El parámetro CustomAttribute15 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute2 |
Opcional |
System.String |
El parámetro CustomAttribute2 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute3 |
Opcional |
System.String |
El parámetro CustomAttribute3 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute4 |
Opcional |
System.String |
El parámetro CustomAttribute4 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute5 |
Opcional |
System.String |
El parámetro CustomAttribute5 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute6 |
Opcional |
System.String |
El parámetro CustomAttribute6 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute7 |
Opcional |
System.String |
El parámetro CustomAttribute7 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute8 |
Opcional |
System.String |
El parámetro CustomAttribute8 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
CustomAttribute9 |
Opcional |
System.String |
El parámetro CustomAttribute9 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
||
DisplayName |
Opcional |
System.String |
El parámetro DisplayName puede utilizarse para especificar el nombre del grupo de distribución en la Consola de administración de Exchange y en la lista global de direcciones (GAL) de Exchange. |
||
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. |
||
EmailAddresses |
Opcional |
Microsoft.Exchange.Data.ProxyAddressCollection |
El parámetro EmailAddresses puede utilizarse para especificar el alias del correo electrónico del grupo de distribución. Pueden utilizarse todos los tipos válidos de dirección de correo electrónico de Microsoft Exchange Server 2007. Puede especificar distintos valores para el parámetro EmailAddresses como una lista delimitada por comas. Importante Exchange 2007 no valida que el formato de las direcciones personalizadas sea correcto. Asegúrese de que la dirección personalizada que especifique cumpla los requisitos de formato para ese tipo de dirección. Puesto que las direcciones X.400 se consideran direcciones personalizadas en Exchange 2007, tampoco se validan. Por lo tanto, debe escribir la sintaxis correcta al especificar una dirección X.400. |
||
EmailAddressPolicyEnabled |
Opcional |
System.Boolean |
El parámetro EmailAddressPolicyEnabled puede utilizarse para controlar la aplicación de directivas de direcciones de correo electrónico a este grupo de distribución. Los valores válidos son $true o $false. El valor predeterminado es $true. De forma predeterminada, todas las directivas de direcciones de correo electrónico aplicables se aplican a este grupo de distribución. |
||
ExpansionServer |
Opcional |
System.String |
El parámetro ExpansionServer especifica el servidor de Exchange que se utilizará para expandir el grupo de distribución. Especifique el servidor de expansión como un valor de DN de Exchange heredado. El comportamiento predeterminado va a utilizar el equipo de Exchange Server 2003 más cercano o el servidor de Exchange 2007 más cercano con la función del servidor Transporte de concentradores instalada. |
||
GrantSendOnBehalfTo |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
El parámetro GrantSendOnBehalfTo especifica un usuario del buzón que puede enviar en nombre de este grupo de distribución. El parámetro GrantSendOnBehalfTo puede utilizar cualquiera de los valores siguientes:
De forma predeterminada, el valor de GrantSendOnBehalfTo está en blanco. Esto significa que ningún otro usuario del buzón tiene permiso para enviar en nombre de este grupo de distribución. |
||
HiddenFromAddressListsEnabled |
Opcional |
System.Boolean |
El parámetro HiddenFromAddressListsEnabled puede utilizarse para ocultar el grupo de distribución de cualquier lista de direcciones de Exchange. Los valores válidos son $true o $false. El valor predeterminado es $false. |
||
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:
|
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts en los que se debe pasar un objeto completo al comando. El parámetro Instance no se puede utilizar si se ha especificado el parámetro Identity. |
||
ManagedBy |
Opcional |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
El parámetro ManagedBy especifica el nombre del usuario del buzón, grupo habilitado para correo o contacto habilitado para correo que aparece en la ficha Administrado por del objeto Active Directory. Puede utilizar los siguientes valores para este parámetro:
|
||
MaxReceiveSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro MaxReceiveSize se puede utilizar para establecer el tamaño máximo permitido de los mensajes de correo electrónico que se puede enviar a este grupo de distribución. Al escribir un valor, otorgue al valor una de las siguientes unidades:
Los valores no certificados se tratan como bytes. Los valores válidos van de 0 a 2147482624 bytes. De forma predeterminada, el parámetro MaxReceiveSize se establece en |
||
MaxSendSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro MaxSendSize se puede utilizar para especificar el tamaño máximo permitido de los mensajes de correo electrónico que se puede enviar desde este grupo de distribución. Al escribir un valor, otorgue al valor una de las siguientes unidades:
Los valores no certificados se tratan como bytes. Los valores válidos van de 0 a 2147482624 bytes. De forma predeterminada, el parámetro MaxSendSize se establece en |
||
Name |
Opcional |
System.String |
El parámetro Name especifica el nombre del grupo de distribución. El parámetro Nombre especifica el nombre del grupo de distribución de usuarios y equipos de Active Directory y también en el campo Nombre de grupo de la Consola de administración de Exchange. |
||
PrimarySmtpAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro PrimarySmtpAddress especifica la dirección principal de correo electrónico SMTP de devolución para el grupo de distribución. Este parámetro sólo tiene sentido si el grupo de distribución tiene varias direcciones de correo electrónico SMTP. |
||
RejectMessagesFrom |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro RejectMessagesFrom especifica los usuarios del buzón y los contactos habilitados para correo que no tienen permiso para enviar mensajes de correo electrónico a este grupo de distribución. Puede utilizar uno de los siguientes valores para los remitentes no permitidos:
De forma predeterminada, el valor de este parámetro está en blanco. Esto permite que el grupo de distribución acepte mensajes de todos los usuarios del buzón y de todos los contactos habilitados para correo. |
||
RejectMessagesFromDLMembers |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro RejectMessagesFromDLMembers especifica los grupos de distribución que no pueden enviar mensajes de correo electrónico al grupo de distribución. Puede utilizar uno de los siguientes valores para los grupos de distribución no permitidos:
De forma predeterminada, el valor de este parámetro está en blanco. Esto permite que el grupo de distribución acepte los mensajes de todos los grupos de distribución. |
||
ReportToManagerEnabled |
Opcional |
System.Boolean |
El parámetro ReportToManagerEnabled permite que se envíen informes de entrega al administrador de grupos de distribución. Los valores válidos son $true o $false. El valor predeterminado es $false |
||
ReportToOriginatorEnabled |
Opcional |
System.Boolean |
El parámetro ReportToOriginatorEnabled permite que los informes de entrega se envíen a los remitentes de los mensajes de correo electrónico que se envían a este grupo de distribución. Los valores válidos son $true o $false. El valor predeterminado es $true. |
||
RequireSenderAuthenticationEnabled |
Opcional |
System.Boolean |
El parámetro RequireSenderAuthenticationEnabled requiere la entrega de mensajes de correo electrónico de remitentes autenticados. Si el valor es $true, sólo se aceptan los mensajes de remitentes autenticados. Los valores válidos son $true o $false. El valor predeterminado es $true. |
||
SamAccountName |
Opcional |
System.String |
El parámetro SamAccountName especifica el nombre de los clientes del objeto que estén ejecutando sistemas operativos más antiguos. El parámetro SamAccountName se muestra en Active Directory y en la Consola de administración de Exchange en el campo Nombre de grupo (anterior a Windows 2000). |
||
SendOofMessageToOriginatorEnabled |
Opcional |
System.Boolean |
El parámetro SendOofMessageToOriginatorEnabled permite que los mensajes de fuera de la oficina se entreguen a los destinatarios de los mensajes de correo que se envían a este grupo de distribución. Los valores válidos son |
||
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 de caracteres limitado consta de los siguientes caracteres: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
UMDtmfMap |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica si desea crear un mapa DTMF definido por el usuario para el grupo de distribución 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. |
||
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 el valor del campo Correo electrónico del objeto de 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-DistributionGroup para cambiar el nombre para mostrar de un grupo de distribución existente denominado Accounting to Accounting Group.
Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"