Get-DistributionGroup

  • 项目

 

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

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

使用 Get-DistributionGroup cmdlet 可以查询现有通讯组。

语法

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

详细说明

可以使用通讯组创建电子邮件通讯组列表，还可以使用安全组分配共享资源的权限。通讯组只能与电子邮件应用程序（例如，Exchange）一起使用才能将电子邮件发送给用户集合。您可以使用 Get-DistributionGroup cmdlet 查询现有通讯组。

若要运行 Get-DistributionGroup 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 参数指定用于筛选收件人的 OPath 筛选器。

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

Identity

可选

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

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

  • GUID

  • Distinguished name (DN)

  • LegacyExchangeDN

  • 域\帐户名


  • 别名

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序的默认收件人作用域设置，并将整个林作为作用域。这使该命令能够访问当前不在默认作用域中的 Active Directory 对象。使用 IgnoreDefaultScope 参数将引入以下限制：

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

  • 仅可以对 Identity 参数使用 DN。不接受其他形式的标识，如别名或 GUID。

  • 不能同时使用 OrganizationalUnit 参数和 Identity 参数。

  • 不能使用 Credential 参数。

ManagedBy

可选

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy 参数指示管理该组的用户或联系人的可分辨名称。

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。

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

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数指示将要返回的收件人对象的最大数目。

SortBy

可选

System.String

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

输入类型

返回类型

错误

错误 说明

  

异常

异常 说明

  

示例

以下代码是 Get-DistributionGroup 命令的示例。在本例中，Get-DistributionGroup 命令检索组 Distribution Group1 并通过管道将对象传输给 Format-List 命令以显示有关通讯组的信息。

Get-DistributionGroup -Identity "Distribution Group1" | Format-List