New-DistributionGroup

El parámetro Alias especifica el alias de Exchange (también llamado sobrenombre de correo) del recipiente. Este valor identifica al destinatario como un objeto habilitado para correo y no debe confundirse con tener varias direcciones de correo electrónico para el mismo destinatario (lo que se conoce como direcciones proxy). Un destinatario solo puede tener un valor de Alias. La longitud máxima es de 64 caracteres.

El valor alias puede contener letras, números y los caracteres siguientes:

• !, #, %, *, +, -, /, =, ?, ^, _y ~.
• $, &, ', ', {, }y | deben tener escape (por ejemplo -Alias what`'snew) o todo el valor entre comillas simples (por ejemplo, -Alias 'what'snew'). El & carácter no se admite en el valor alias para la sincronización de Azure AD Connect.
• Los puntos (.) deben estar rodeados de otros caracteres válidos (por ejemplo, help.desk).
• Caracteres Unicode de U+00A1 a U+00FF.

Cuando se crea un destinatario sin especificar una dirección de correo electrónico, el valor Alias que especifique se usará para generar la dirección de correo electrónico principal (alias@domain). Los caracteres Unicode admitidos se asignan a los caracteres de texto US-ASCII que mejor concuerden. Por ejemplo, U+00F6 (ö) se cambia a oe en la dirección de correo electrónico principal.

Si no usa el parámetro Alias cuando crea un destinatario, se utiliza el valor de un parámetro obligatorio diferente para el valor de la propiedad Alias:

• Destinatarios con cuentas de usuario (por ejemplo, buzones de usuario y usuarios de correo): se usa la parte izquierda del parámetro MicrosoftOnlineServicesID o UserPrincipalName. Por ejemplo, helpdesk@contoso.onmicrosoft.com da como resultado el valor helpdeskde la propiedad Alias .
• Destinatarios sin cuentas de usuario (por ejemplo, buzones de sala, contactos de correo y grupos de distribución): se usa el valor del parámetro Name. Los espacios se quitan y los caracteres no compatibles se convierten en signos de interrogación (?).

Si modifica el valor de Alias de un destinatario existente, la dirección de correo electrónico principal se actualiza automáticamente, pero solo en entornos locales donde el destinatario está sujeto a directivas de direcciones de correo electrónico (la propiedad EmailAddressPolicyEnabled es True para el destinatario).

El parámetro Alias nunca genera ni actualiza la dirección de correo electrónico principal de un contacto de correo o de un usuario de correo.

Este parámetro solo está disponible en Exchange local.

El parámetro ArbitrationMailbox especifica el buzón de arbitraje que se usa para administrar el proceso de moderación de este destinatario. Se puede usar cualquier valor que identifique al buzón de arbitraje de manera exclusiva. Por ejemplo:

• Nombre
• Alias
• Nombre distintivo (DN)
• Nombre completo (DN)
• Dominio\Nombre de usuario
• Dirección de correo electrónico
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro BccBlocked especifica si los miembros del grupo no reciben mensajes si el grupo se usa en la línea CCO. Los valores admitidos son:

• $true: Si el grupo se usa en la línea CCO, los miembros del grupo no reciben el mensaje y el remitente recibe un informe de no entrega (también conocido como NDR o mensaje de rebote). No se bloquean otros destinatarios del mensaje. Si un remitente externo usa el grupo en la línea CCO, los miembros del grupo no se bloquean. En el caso de los grupos anidados, el mensaje solo se bloquea para los miembros del grupo de nivel superior.
• $false: no hay restricciones para usar el grupo en la línea de mensajes CCO. Este es el valor predeterminado.

El parámetro ByPassNestedModerationEnabled especifica cómo tratar la aprobación del mensaje cuando un grupo moderado contiene como miembros otros grupos moderados. Los valores admitidos son:

• $true: una vez que un moderador aprueba un mensaje enviado al grupo, el mensaje se aprueba automáticamente para todos los demás grupos moderados que son miembros del grupo.
• $false: una vez que un moderador aprueba un mensaje enviado al grupo, es necesaria una aprobación independiente para cada grupo moderado que sea miembro del grupo. Este es el valor predeterminado.

Este parámetro solo lo pueden usar los administradores de inquilinos y la organización de nivel superior.

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

• Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
• La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

El modificador CopyOwnerToMember especifica si los propietarios del grupo especificados por el parámetro ManagedBy también son miembros del grupo. No es necesario especificar un valor con este modificador.

Este parámetro solo está disponible en el servicio basado en la nube.

{{ Fill Description Description }}

El parámetro DisplayName especifica el nombre para mostrar del grupo. El nombre para mostrar es visible en el Centro de administración de Exchange y las listas de direcciones. La longitud máxima es de 256 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").

Si no usa el parámetro DisplayName, se emplea el valor del parámetro Name para el nombre para mostrar.

Si se aplica una directiva de nomenclatura de grupos en su organización, los usuarios deben seguir las restricciones de nomenclatura especificadas por el parámetro DistributionGroupNameBlockedWordList en el cmdlet Set-OrganizationConfig. Para omitir este requisito, use el modificador IgnoreNamingPolicy.

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Este parámetro solo está disponible en el servicio basado en la nube.

El modificador HiddenGroupMembershipEnabled especifica si se ocultan los miembros del grupo de distribución a los miembros del grupo y los usuarios que no son miembros de este. No es necesario especificar un valor con este modificador.

Puede usar esta opción para ayudar a cumplir los reglamentos que exigen ocultar la pertenencia a grupos a miembros o usuarios externos (por ejemplo, un grupo de distribución que represente a los alumnos inscritos en una clase).

Nota: No se puede cambiar esta configuración después de crear el grupo. Si crea el grupo con pertenencia oculta, no puede editar el grupo más adelante para mostrar la pertenencia al grupo ni viceversa.

El modificador IgnoreNamingPolicy especifica si se evita que este grupo se vea afectado por la directiva de nomenclatura de grupos de la organización. No es necesario especificar un valor con este modificador.

La directiva de nomenclatura de grupo está definida por los parámetros DistributionGroupNamingPolicy y DistributionGroupNameBlockedWordList en el cmdlet Set-OrganizationConfig.

El parámetro ManagedBy especifica un propietario para el grupo. Los grupos deben tener al menos un propietario. Si no usa este parámetro para especificar el propietario al crear el grupo, el propietario será la cuenta de usuario que creó el grupo. El propietario del grupo puede:

• Modificar las propiedades del grupo
• Agregar o quitar miembros del grupo
• Eliminar el grupo
• Aprobar las solicitudes para abandonar el grupo o unirse a él (si está disponible)
• Aprobar las solicitudes para abandonar el grupo o unirse a él (si está disponible)

El propietario que especifique para este parámetro debe ser un buzón, un usuario de correo o un grupo de seguridad habilitado para correo (una entidad de seguridad habilitada para correo que pueda tener permisos asignados). Puede usar cualquier valor que identifique de forma exclusiva al propietario. Por ejemplo:

• Nombre
• Alias
• Nombre distintivo (DN)
• Nombre completo (DN)
• Dominio\Nombre de usuario
• Dirección de correo electrónico
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Para especificar varios propietarios, use la sintaxis siguiente: Owner1,Owner2,...OwnerN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Owner1","Owner2",..."OwnerN".

Los propietarios que especifique con este parámetro no se agregan automáticamente como miembros del grupo. Use el modificador CopyOwnerToMember o agregue manualmente los propietarios como miembros.

Nota: La administración de grupos en Outlook no funciona cuando el propietario es un grupo de seguridad habilitado para correo. Para administrar el grupo en Outlook, el propietario debe ser un buzón de correo o un usuario de correo.

El parámetro MemberDepartRestriction especifica las restricciones que coloca en las solicitudes para abandonar el grupo. Los valores admitidos son:

• Open: los miembros pueden abandonar el grupo sin aprobación de uno de los propietarios del grupo. Este es el valor predeterminado para los grupos de distribución universal. No puede usar este valor en grupos de seguridad universal.
• Open: los miembros no pueden abandonar el grupo sin aprobación de uno de los propietarios del grupo. Este es el valor predeterminado para los grupos de distribución universal. No puede usar este valor en grupos de seguridad universal.

El parámetro MemberJoinRestriction especifica las restricciones que coloca en las solicitudes para unirse al grupo. Los valores admitidos son:

• Open : los usuarios pueden agregarse a sí mismos al grupo sin aprobación de un propietario del grupo. No puede usar este valor en grupos de seguridad universal.
• Closed: los usuarios no pueden agregarse a sí mismos al grupo y las solicitudes para unirse al grupo se rechazan de forma automática. La pertenencia a los grupos está controlada por los propietarios del grupo. Este es el valor predeterminado en grupos de seguridad universal y grupos de distribución universal.
• ApprovalRequired: los usuarios pueden solicitar unirse al grupo. Los propietarios de los grupos controlan la pertenencia a los grupos. Aunque puede usar este valor en grupos de seguridad universal, las solicitudes de los usuarios para unirse al grupo no se envían a los propietarios del grupo, por lo que esta configuración solo se aplica en grupos de distribución universales.

El parámetro Members especifica los destinatarios (objetos habilitados para correo) que son miembros del grupo. Puede usar cualquier valor que identifique de forma exclusiva el destinatario. Por ejemplo:

• Nombre
• Alias
• Nombre distintivo (DN)
• Nombre distintivo (DN)
• DN canónico
• GUID

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Después de crear el grupo, use el cmdlet Get-DistributionGroupMember para ver los miembros del grupo y los cmdlets Add-DistributionGroupMember, Remove-DistributionGroupMember y Update-DistributionGroupMember para administrar la pertenencia a grupos.

Aunque no es necesario, tampoco es mala idea agregar únicamente entidades de seguridad (por ejemplo, buzones de correo y usuarios de correo con cuentas de usuario u otros grupos de seguridad de correo) a los grupos de seguridad habilitados para correo. Si se asignan permisos a un grupo de seguridad habilitado para correo, los miembros que no sean entidades de seguridad (por ejemplo, contactos de correo o grupos de distribución) no tendrán permisos.

El parámetro ModeratedBy especifica uno o varios moderadores para este grupo. Un moderador aprueba los mensajes enviados al grupo antes de que se entreguen los mensajes. El moderador debe ser un buzón, un usuario de correo o un contacto de correo de su organización. Puede usar cualquier valor que identifique al moderador de manera exclusiva. Por ejemplo:

• Nombre
• Alias
• Nombre distintivo (DN)
• Nombre distintivo (DN)
• DN canónico
• GUID

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para los grupos de seguridad habilitados para correo, debe usar este parámetro para especificar al menos un moderador al establecer el parámetro ModerationEnabled en el valor $true.

Para los grupos de distribución, si establece el parámetro ModerationEnabled en el valor $true, pero no usa este parámetro para especificar moderadores, los propietarios del grupo especificados por el parámetro ManagedBy son responsables de aprobar mensajes enviados al grupo.

El parámetro ModerationEnabled especifica si la moderación está habilitada para este destinatario. Los valores válidos son:

• $true: la moderación está habilitada para este destinatario. El moderador aprueba los mensajes enviados al destinatario antes de que se entreguen.
• $false: la moderación no está habilitada para este destinatario. Los mensajes enviados al destinatario se entregan sin la aprobación de un moderador. Este es el valor predeterminado.

Use el parámetro ModeratedBy para especificar los moderadores.

El parámetro Name especifica el nombre único del grupo. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Este valor también se usa para la propiedad DisplayName si no emplea el parámetro DisplayName.

El parámetro Notes especifica información adicional sobre el objeto. Si el valor contiene espacios, escriba el valor entre comillas (").

El parámetro OrganizationalUnit especifica la ubicación en Active Directory donde se crea el grupo.

La entrada válida para este parámetro es una unidad organizativa (UO) o dominio que devuelve el cmdlet Get-OrganizationalUnit. Puede usar cualquier valor que identifique la OU o el dominio de forma exclusiva. Por ejemplo:

• Nombre
• Nombre
• Nombre completo (DN)
• GUID

El parámetro PrimarySmtpAddress especifica la dirección de correo electrónico de devolución principal que se usa para el destinatario.

El parámetro RequireSenderAuthenticationEnabled especifica si sólo se deben aceptar mensajes de remitentes autenticados (internos). Los valores admitidos son:

• $true: solo se aceptan mensajes de remitentes autenticados (internos). Los mensajes de los remitentes no autenticados (externos) se rechazan.
• $false: se aceptan los mensajes de remitentes autenticados (internos) y no autenticados (externos).

El valor predeterminado es $true.

El parámetro RoomList especifica que todos los miembros del grupo de distribución sean buzones de correo de sala. No es necesario especificar un valor con este modificador.

Puede crear un grupo de distribución para un edificio de oficinas de su organización y agregar todas las salas de ese edificio al grupo de distribución. Los grupos de distribución de lista de salas se usan para generar una lista de ubicaciones del edificio para solicitudes de reunión en Outlook 2010 o posterior. Las listas de salas permiten a un usuario seleccionar un edificio y obtener la información de disponibilidad de todas las salas de ese edificio sin tener que agregar cada una individualmente.

Este parámetro solo está disponible en Exchange local.

El parámetro SamAccountName (también conocido como cuenta de usuario o nombre de grupo en versiones anteriores a Windows 2000) especifica un identificador de objeto que es compatible con versiones anteriores de sistemas operativos de cliente y servidor de Microsoft Windows. El valor puede contener letras, números, espacios, puntos (.) y los caracteres siguientes: !, #, $, %, ^, &-, _, {, }y ~. El último carácter no puede ser un punto. Se permiten caracteres Unicode, pero los caracteres acentuados pueden generar conflictos (por ejemplo, o y ö coinciden). La longitud máxima es de 20 caracteres.

El parámetro SendModerationNotifications especifica cuándo se envían mensajes de notificación de moderación. Los valores admitidos son:

• Always: enviar una notificación a todos los remitentes si sus mensajes no se aprueban. Este es el valor predeterminado.
• Internal: enviar una notificación a los remitentes de su organización si sus mensajes no se aprueban.
• Never: no enviar ninguna notificación si no se aprueba el mensaje.

Este parámetro solo es pertinente si la moderación está habilitada (el parámetro ModerationEnabled tiene el valor $true).

El parámetro Type especifica el tipo de grupo que desea crear. Los valores admitidos son:

• Distribución: un grupo de distribución. Estos grupos no pueden tener permisos asignados. Este es el valor predeterminado.
• Seguridad: un grupo de seguridad habilitado para correo. Estos grupos pueden tener permisos asignados.

El ámbito del grupo es siempre universal.

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.