Get-Group (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
Use el cmdlet Get-Group para consultar los grupos existentes.
Sintaxis
Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Descripción detallada
El cmdlet Get-Group devuelve todos los grupos existentes en Microsoft Windows que coinciden con los parámetros de filtrado especificados.
Para ejecutar el cmdlet Get-Group, la cuenta que use debe tener delegada la siguiente función:
- Función Administrador de Exchange con permisos de sólo vista
Para obtener más información sobre los permisos, la delegación de funciones 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 especifica la cuenta a usar para leer el servicio de directorio de Active Directory. Es especialmente útil cuando se especifica el catálogo global. La contraseña debe solicitarse de una manera segura. |
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 especifica el filtro a usar 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.GroupIdParameter |
El parámetro Identity del grupo de distribución adopta una de las siguientes formas:
|
OrganizationalUnit |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro OrganizationalUnit limita los resultados a un contenedor de unidad organizativa (OU) específica. |
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 destinatario 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:
|
ResultSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro ResultSize especifica el máximo número de miembros que serán devueltos. |
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-Group. En este ejemplo, el comando Get-Group se usa sin parámetros para devolver todos los grupos en Active Directory.
Get-Group