通过

Get-User (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2008-04-16

使用 Get-User cmdlet 可以检索林中与指定条件相匹配的所有用户。

语法

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

详细说明

没有必需参数。但是，在 Get-User 命令中只能使用下列某一个参数：Identity、Filter 或 Anr。

若要运行 Get-User cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 仅查看管理员角色

有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 类型 说明

Anr

可选

System.String

Anr 参数指示将使用不明确名称解析 (ANR) 来解析参数。

Credential

可选

System.Management.Automation.PSCredential

Credential 参数指定用于读取 Active Directory 目录服务的帐户。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定从 Active Directory 检索数据域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。

Filter

可选

System.String

Filter 参数指定一组对查询所返回的收件人进行限制的属性。

有关可筛选属性的详细信息，请参阅 -Filter 参数的可筛选属性。

Identity

可选

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Identity 参数接受下列值之一：

  • GUID

  • 可分辨名称 (DN)

  • 域\帐户

  • User principal name (UPN)

  • Legacy Exchange DN

  • 简单邮件传输协议 (SMTP) 地址

  • Alias

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数只从指定的组织单位 (OU) 返回对象。

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

ReadFromDomainController 参数指定从用户域中的域控制器读取的用户信息。如果将收件人作用域设置为包括林中的所有收件人，且不使用此参数，则有可能从包含过期信息的全局编录中读取用户信息。如果使用此参数，则可能需要多次读取才能获取该信息。

note注意：
默认情况下，收件人作用域被设置为驻留 Exchange 服务器的域。

RecipientTypeDetails

可选

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

RecipientTypeDetails 参数指定返回的收件人的类型。Microsoft Exchange Server 2007 的收件人类型分为收件人类型和子类型。每个收件人类型包含所有子类型的所有常见属性。例如，类型 UserMailbox 代表 Active Directory 中具有关联邮箱的用户帐户。因为存在多种邮箱类型，所以每个邮箱类型都由 RecipientTypeDetails 参数标识。例如，会议室邮箱将 RecipientTypeDetails 设置为 ConferenceRoomMailbox，而用户邮箱将 RecipientTypeDetails 设置为 UserMailbox。

此参数的可用收件人类型详细内容包括：

  • ConferenceRoomMailbox

  • DisabledUser

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailUser

  • User

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数设置要返回的最大结果数。

Sortby

可选

System.String

SortBy 参数根据单个属性以升序排序。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

第一个示例在营销 OU 中检索有关用户的信息。

第二个示例使用 Filter 参数来检索用户职务名称末尾包含单词 Manager 的用户。

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

可以使用任何 Active Directory 用户属性为 Get-User cmdlet 中的 Filter 参数构建筛选器字符串。有关可以在筛选器字符串中使用的比较运算符的详细信息，请参阅比较运算符。