Get-Group (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-05

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

语法

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>]

详细说明

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)

  • User principal name (UPN)

  • 旧版 Exchange DN

  • 域\帐户名

  • 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。

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

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

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

SortBy

可选

System.String

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

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

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

Get-Group