Get-AddressList

Article
09/29/2015

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-AddressList cmdlet to view all attributes of an address list.

Syntax

Get-AddressList [-Identity <AddressListIdParameter>] [-DomainController <Fqdn>]

Get-AddressList -Container <AddressListIdParameter> [-DomainController <Fqdn>]

Detailed Description

To run the Get-AddressList cmdlet, the account you use must be delegated the following:

Exchange View-Only Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter	Required	Type	Description
Container	Required	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	This parameter specifies the identity of the parent address list of the address list or lists that you want to view. If no parent address list is specified, the command will get all address lists under the root "All Address Lists."
Identity	Optional	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Use the Identity parameter to specify the GUID, distinguished name or address list name that represents a specific address list. You can also include the path using the format Path\AddressListName. You can omit the parameter label Identity so that only the address list name or GUID is supplied.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.

Container

Required

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

This parameter specifies the identity of the parent address list of the address list or lists that you want to view. If no parent address list is specified, the command will get all address lists under the root "All Address Lists."

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Use the Identity parameter to specify the GUID, distinguished name or address list name that represents a specific address list. You can also include the path using the format Path\AddressListName.

You can omit the parameter label Identity so that only the address list name or GUID is supplied.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

The first example shows how to get the attributes of all the address lists under "All Address Lists" container.

The second example shows how to get the attributes of the address list called building4 and located under the "All Users\Sales\" address list, using the domain controller DomainController01.

Get-AddressList 
Get-AddressList -Identity "All Users\Sales\building4" -DomainController DomainController01

You can pipe the output from the Get-AddressList cmdlet to the Remove-AddressList, Set-AddressList, Update-Addresslist, and Move-AddressList cmdlets instead of using the Identity parameter with each of those cmdlets.

Share via