Get-IMAPSettings (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
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 following:
- Exchange Server Administrator role and local Administrators group for the target server
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 |
|---|---|---|---|
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