Get-IMAPSettings
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
The Get-IMAPSettings cmdlet displays the properties of a single Microsoft Exchange Server 2007 Client Access server that is running the Internet Message Access Protocol Version 4 Rev 1 (IMAP4) service.
Syntax
Get-ImapSettings [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Detailed Description
The Get-IMAPSettings cmdlet lets you view the settings for the IMAP4 service that is running on an Exchange 2007 Client Access server. Information can only be returned about servers that are located in the Exchange organization from which the cmdlet is being run.
To run the Get-IMAPSettings cmdlet, the account you use must be delegated the Exchange Server Administrator role and membership in the local Administrators group for the target server.
For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
If this parameter is specified, the cmdlet returns an individual Client Access server in your organization for which you are specifying IMAP settings. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following code example displays the parameters and values for a Client Access server named CAS01 that is running the IMAP4 service.
Get-IMAPSettings -Server CAS01