Get-Group

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2010-04-27

使用 Get-Group cmdlet 可以查询现有的组。

语法

Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

详细说明

Get-Group cmdlet 返回 Microsoft Windows 中所有与指定筛选参数相匹配的现有组。

若要运行 Get-Group cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange 仅查看管理员角色

有关权限、角色委派以及管理 Microsoft 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.GroupIdParameter

通讯组的 Identity 参数采用以下形式之一:

  • GUID

  • 可分辨名称 (DN)

  • 用户主体名称 (UPN)

  • 旧版 Exchange DN

  • 域\帐户名

  • 别名

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置,并使用整个林作为作用域。这样,该命令可以访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数时将受到下列限制:

  • 不能使用 DomainController 参数。该命令将自动使用适合的全局编录服务器。

  • Identity 参数只能使用 DN。不接受其他形式的标识(例如别名和 GUID)。

  • 不能同时使用 OrganizationalUnitIdentity 参数。

  • 不能使用 Credential 参数。

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。

对于该命令,可用的收件人类型详细信息包括:

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数指定将要返回的成员的最大数目。

SortBy

可选

System.String

SortBy 属性用于对结果进行排序。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

以下代码是 Get-Group 命令的示例。在此示例中,Get-Group 命令在没有参数的情况下用来返回 Active Directory 中的所有组。

Get-Group