Set-DistributionGroup (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
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>] [-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>] [-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>] [-WindowsEmailAddress <SmtpAddress>]
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <DistributionGroup>] [-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>] [-WindowsEmailAddress <SmtpAddress>]
Descripción detallada
Los grupos de distribución se utilizan para consolidar grupos de destinatarios en un punto único 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 ajustes.
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 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 usar 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 y los contactos habilitados para correo que pueden enviar mensajes de correo electrónico a este grupo de distribución. 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 mensajes de todos los usuarios del buzón y de todos los contactos habilitados para correo. |
AcceptMessagesOnlyFromDLMembers |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFromDLMembers especifica los grupos de distribución que 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 grupos de distribución. |
Alias |
Opcional |
System.String |
El parámetro Alias puede utilizarse para especificar el alias del objeto. El valor de Alias no puede contener espacios. |
CreateDTMFMap |
Opcional |
System.Boolean |
Este parámetro especifica un mapa Tono de marcación 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 del controlador de dominio que escribe este cambio de configuración para 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. |
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.MailboxOrMailUserIdParameter[] |
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. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
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. El parámetro Instance no se puede usar si se ha especificado el parámetro Identity. |
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 especificar un valor, califique al valor con una de las siguientes unidades:
Los valores no calificados 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 especificar un valor, califique al valor con una de las siguientes unidades:
Los valores no calificados 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 usa 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 caracteres ASCII del 26 al 126, ambos incluidos. |
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. |
WindowsEmailAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro WindowsEmailAddress especifica el valor del campo Correo electrónico del objeto de 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-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"