Get-User
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-User para obtener todos los usuarios del bosque que coincidan con las condiciones especificadas.
Sintaxis
get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Descripción detallada
No se necesita ningún parámetro. Sin embargo, en un comando Get-User, no se puede usar más de uno de los parámetros siguientes: Identity, Filter o Anr.
Para ejecutar el cmdlet Get-User, la cuenta que use debe tener delegada la siguiente función:
- 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 la resolución de nombres ambiguos (ANR). |
Credential |
Opcional |
System.Management.Automation.PSCredential |
El parámetro Credential especifica la cuenta que se usa 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 especifica un grupo de atributos que limita los destinatarios que devuelve la consulta. 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.UserIdParameter |
El parámetro Identity toma uno de los valores siguientes:
|
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:
|
OrganizationalUnit |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro OrganizationalUnit sólo devuelve objetos de la unidad organizativa (OU) especificada. |
ReadFromDomainController |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro ReadFromDomainController especifica que la información de usuario se lee desde un controlador de dominio en el dominio del usuario. Si define el ámbito del destinatario para que incluya a todos los destinatarios del bosque y no usa este parámetro, es posible que la información de usuario se lea desde un catálogo global con información no actualizada. Si usa este parámetro, podrían ser posibles 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 destinatario que se devuelve. 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 hay varios tipos de buzón, cada tipo de buzón se identifica mediante 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 del tipo de destinatario disponibles para este parámetro son:
|
ResultSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. |
Sortby |
Opcional |
System.String |
El parámetro SortBy ordena clasifica por un solo atributo en orden ascendente. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
El primer ejemplo recupera la información acerca de sus usuarios del OU de marketing
El segundo ejemplo usa el parámetro Filter para recuperar información acerca de todos los usuarios que tengan la palabra "Administrador" al final de su cargo.
Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}
Es posible usar cualquier atributo de usuario de Active Directory para crear una cadena de filtro para el parámetro Filter del cmdlet Get-User. Para obtener más información acerca de los operadores de comparación que puede usar en la cadena de filtro, consulte Operadores comparativos.