Get-GlobalAddressList

 

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

Use the Get-GlobalAddressList cmdlet to return all the attributes of a global address list (GAL) or a set of GALs.

Syntax

Get-GlobalAddressList [-Identity <GlobalAddressListIdParameter>] [-DomainController <Fqdn>]

Get-GlobalAddressList -DefaultOnly <SwitchParameter> [-DomainController <Fqdn>]

Detailed Description

The Get-GlobalAddressList cmdlet is mainly used to populate the GAL property pages in the Exchange Management Console. This command does not provide a filtering capability. If filtering is required, you should use a WHERE clause together with the command.

To run the Get-GlobalAddressList 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

DefaultOnly

Required

System.Management.Automation.SwitchParameter

Use the DefaultOnly parameter to get the default global address list only.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter in the command.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

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

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

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

In this example, the Get-GlobalAddressList command is used without parameters to return all the attributes of all GALs.

Get-GlobalAddressList