Get-User
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2010-04-27
使用 Get-User cmdlet 可以检索林中与指定条件相匹配的所有用户。
语法
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>]
详细说明
没有必需参数。但是,在 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 参数接受下列值之一:
|
||
IgnoreDefaultScope |
可选 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置,并使用整个林作为作用域。这样,该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制:
|
||
OrganizationalUnit |
可选 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit 参数只从指定的组织单位 (OU) 返回对象。 |
||
ReadFromDomainController |
可选 |
System.Management.Automation.SwitchParameter |
ReadFromDomainController 参数指定从用户域中的域控制器读取的用户信息。如果将收件人作用域设置为包括林中的所有收件人,且不使用此参数,则有可能从包含过期信息的全局编录中读取用户信息。如果使用此参数,则可能需要多次读取才能获取该信息。
|
||
RecipientTypeDetails |
可选 |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
RecipientTypeDetails 参数指定返回的收件人的类型。Microsoft Exchange Server 2007 中的收件人类型分为收件人类型和子类型。每个收件人类型包含所有子类型的所有常见属性。例如,类型 UserMailbox 代表 Active Directory 中具有关联邮箱的用户帐户。因为存在多种邮箱类型,所以每个邮箱类型都由 RecipientTypeDetails 参数标识。例如,会议室邮箱将 RecipientTypeDetails 设置为 ConferenceRoomMailbox,而用户邮箱将 RecipientTypeDetails 设置为 UserMailbox。 此参数的可用收件人类型详细内容包括:
|
||
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 参数构建筛选器字符串。有关可以在筛选器字符串中使用的比较运算符的详细信息,请参阅比较运算符。