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