Get-AddressList

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Get-AddressList cmdlet 来查看地址列表。

在 Exchange Online 中,此 cmdlet 仅在“地址列表”角色中可用,默认情况下,该角色不会分配给任何角色组。 若要使用此 cmdlet,需要将“地址列表”角色添加到角色组 (例如“组织管理”角色组) 。 有关详细信息,请参阅向角色组添加角色

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Get-AddressList
   -Container <AddressListIdParameter>
   [-DomainController <Fqdn>]
   [<CommonParameters>]
Get-AddressList
   [[-Identity] <AddressListIdParameter>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]
Get-AddressList
   [-SearchText <String>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

说明

可以通过管道将输出从 Get-AddressList cmdlet 传递给 Remove-AddressList、Set-AddressList、Update-AddressList 和 Move-AddressList cmdlet,而不是将 Identity 参数用于其中每个 cmdlet。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-AddressList

本示例会返回所有地址列表的摘要列表。

示例 2

Get-AddressList -Identity "All Users\Sales\building4" | Format-List

本示例返回位于 All Users\Sales\ 地址列表下名为“building4that's”的地址列表的详细信息。

参数

-Container

Container 参数可基于地址列表的位置筛选结果。 仅返回指定路径下的地址列表。 此参数的有效输入为根“\”(也称为“所有地址列表”)或现有的地址列表。 可以使用唯一标识该地址列表的任何值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID
  • 路径: "\AddressListName""\ContainerName\AddressListName" (,例如, "\All Users""\All Contacts\Marketing")

此参数不能与 Identity 或 SearchText 参数一起使用。

Type:AddressListIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 参数指定您想要查看的地址列表。 您可以使用任何能够唯一标识地址列表的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID
  • 路径: "\AddressListName""\ContainerName\AddressListName" (,例如, "\All Users""\All Contacts\Marketing")

此参数不能与 Container 或 SearchText 参数一起使用。

Type:AddressListIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchText

SearchText 参数会根据地址列表的名称和显示名称来筛选结果。 只返回那些名称或显示名称中包含指定文本字符串的地址列表。 如果值中有空格,请使用双引号 (") 将此值括起来。

此参数不能与 Container 或 Identity 参数一起使用。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。