Get-DistributionGroup

  • Artículo

 

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

Última modificación del tema: 2010-04-27

Use el cmdlet Get-DistributionGroup para buscar grupos de distribución existentes.

Sintaxis

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descripción detallada

Puede usar los grupos de distribución para crear listas de distribución de correo electrónico y grupos de seguridad para asignar permisos a recursos compartidos. Los grupos de distribución se pueden usar únicamente con aplicaciones de correo electrónico (como Exchange) para enviar mensajes de correo electrónico a un conjunto de usuarios. Puede usar el cmdlet Get-DistributionGroup para consultar grupos de distribución existentes.

Para ejecutar el cmdlet Get-DistributionGroup, la cuenta que use debe tener delegado lo siguiente:

  • Función Administrador de Exchange con permiso de vista

Para obtener más información sobre los permisos, funciones de delegación y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

ANR

Opcional

System.String

El parámetro ANR indica que el argumento se resolverá mediante una resolución de nombres ambigua (ANR).

Credential

Opcional

System.Management.Automation.PSCredential

El parámetro Credential indica el dominio y el nombre de usuario de la cuenta usada para leer el servicio de directorio de Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos de Active Directory, incluya el parámetro DomainController en el comando.

Filter

Opcional

System.String

El parámetro Filter indica el filtro OPath usado para filtrar destinatarios.

Para obtener más información acerca de las propiedades filtrables, consulte Propiedades a las que se puede aplicar un filtro para el parámetro de filtrado.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

El parámetro Identity del grupo de distribución adopta una de las siguientes formas:

  • GUID

  • Nombre distintivo (DN)

  • LegacyExchangeDN

  • Dominio\Nombre de cuenta

  • Alias

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.

  • No puede usar los parámetros OrganizationalUnit e Identity juntos.

  • No puede usar el parámetro Credential.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

El parámetro ManagedBy indica el nombre distintivo del usuario o contacto que administra el grupo.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

El parámetro OrganizationalUnit limita los resultados a un contenedor de unidad organizativa (OU) específico.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

El parámetro ReadFromDomainController indica que la información del usuario se lee desde un controlador de dominio en el dominio del usuario. Si ha establecido en el ámbito de destinatario que se incluyan todos los destinatarios del bosque y no usa este parámetro, es posible que la información del usuario se lea desde un catálogo global con información no actualizada. Si usa este parámetro, es posible que se necesiten varias lecturas para obtener la información.

Nota

De forma predeterminada, el ámbito del destinatario se establece en el dominio que hospeda los servidores de Exchange.

RecipientTypeDetails

Opcional

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

El parámetro RecipientTypeDetails especifica el tipo de destinatarios devueltos. Los tipos de destinatarios de Microsoft Exchange Server 2007 se dividen en tipos y subtipos de destinatarios. Cada tipo de destinatario contiene todas las propiedades comunes de todos los subtipos. Por ejemplo, el tipo UserMailbox representa una cuenta de usuario de Active Directory con un buzón asociado. Dado que existen varios tipos de buzones, cada uno se identifica con el parámetro RecipientTypeDetails. Por ejemplo, un buzón de una sala de conferencias tiene el parámetro RecipientTypeDetails establecido en ConferenceRoomMailbox, mientras que un buzón de usuario tendrá RecipientTypeDetails establecido en UserMailbox.

Los detalles de los tipos de destinatarios disponibles para este comando son:

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro ResultSize indica el número máximo que se devolverá de objetos de destinatario.

SortBy

Opcional

System.String

El atributo SortBy se usa para ordenar los resultados.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

  

Excepciones

Excepciones Descripción

  

Ejemplo

El siguiente código es un ejemplo del comando Get-DistributionGroup. En este ejemplo, el comando Get-DistributionGroup recupera el grupo Distribution Group1 y canaliza el objeto hacia el comando Format-List para mostrar la información acerca del grupo de distribución.

Get-DistributionGroup -Identity "Distribution Group1" | Format-List