Get-DynamicDistributionGroup
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-04-27
Utilice el cmdlet Get-DynamicDistributionGroup para recuperar la configuración de un grupo de distribución dinámica existente.
Sintaxis
Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-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 Microsoft Exchange) para enviar mensajes de correo electrónico a un conjunto de usuarios. Utilice el cmdlet Get-DynamicDistributionGroup para recuperar la configuración de un grupo de distribución dinámica existente en el servicio de directorio de Active Directory.
Para ejecutar el cmdlet Get-DynamicDistributionGroup, debe usar una cuenta en la que se delegue lo siguiente:
- Función Administrador de Exchange con permiso de vista
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 |
---|---|---|---|
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 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.DynamicGroupIdParameter |
El parámetro Identity del grupo de distribución adopta una de las siguientes formas:
|
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:
|
ManagedBy |
Opcional |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
El parámetro ManagedBy indica el DN 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. |
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-DynamicDistributionGroup. En este ejemplo, el comando Get-DynamicDistributionGroup recupera el grupo de distribución dinámico Marketing y canaliza el objeto hacia el comando Format-List para mostrar la información acerca del grupo de distribución dinámico.
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List