Get-DistributionGroupMember

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-DistributionGroupMember para ver los miembros de los grupos de distribución y los grupos de seguridad habilitados para correo.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-DistributionGroupMember
   [-Identity] <DistributionGroupMemberIdParameter>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-IncludeSoftDeletedObjects]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Si su organización tiene varios dominios de Active Directory, es posible que tenga que ejecutar el cmdlet Set-ADServerSettings con el parámetro ViewEntireForest establecido en $true antes de ejecutar el cmdlet Get-DistributionGroupMember para ver todo el bosque. Para obtener más información, consulte el Ejemplo 2.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-DistributionGroupMember -Identity "Marketing USA"

En este ejemplo se devuelven los miembros del grupo de distribución existentes para el grupo de distribución denominado Marketing USA.

Ejemplo 2

Set-ADServerSettings -ViewEntireForest $true

Get-DistributionGroupMember -Identity "Marketing Worldwide"

En este ejemplo se establece el ámbito de la búsqueda en todo el bosque mediante la ejecución del cmdlet Set-ADServerSettings y, a continuación, el cmdlet Get-DistributionGroupMember busca en todo el bosque los miembros del grupo de distribución en el grupo de distribución Marketing Worldwide.

Parámetros

-Credential

El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para ejecutar este comando. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios.

Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea Get-Credential.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

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.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

El parámetro Identity especifica el grupo de distribución o el grupo de seguridad habilitado para correo. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:

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

Type:	DistributionGroupMemberIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

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

El modificador IgnoreDefaultScope indica al comando que ignore la configuración predeterminada del ámbito del destinatario para la sesión de Exchange PowerShell y que use todo el bosque como ámbito. No es necesario especificar un valor con este modificador.

Este cambio habilita el comando tenga acceso a objetos de Active Directory que no están actualmente disponibles en el ámbito predeterminado, pero también introduce las siguientes restricciones:

• No puede usar el parámetro DomainController. El comando usa un servidor de catálogo global adecuado de forma automática.
• Sólo puede usar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeSoftDeletedObjects

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

El modificador IncludeSoftDeletedGroups especifica si se deben incluir miembros de grupo eliminados temporalmente en los resultados. No es necesario especificar un valor con este modificador.

Los miembros del grupo eliminados temporalmente se eliminan Grupos de Microsoft 365 o buzones que todavía se pueden recuperar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ReadFromDomainController

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

El conmutador ReadFromDomainController especifica que la información se debe leer de un controlador de dominio en el dominio del usuario. No es necesario especificar un valor con este modificador.

El comando : Set-AdServerSettings -ViewEntireForest $true para incluir todos los objetos en el bosque, es necesario el modificador ReadFromDomainController. De lo contrario, el comando podría usar un catálogo global que contenga información obsoleta. Además, es posible que tenga que ejecutar varias iteraciones del comando con el modificador ReadFromDomainController para obtener la información.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.