Connect-SMIMEIMAPCmdlet
Parameters Output Objects Config Settings
The Connect-SMIMEIMAP cmdlet is used to create a persistent connection object.
Syntax
$cnn = Connect-SMIMEIMAP [parameters]
Remarks
This cmdlet allows you to create a persistent connection object to be used with related cmdlets.When executing the cmdlet a connection object is returned. Pass this object to the Connection parameter of related cmdlets to use the newly created connection object.
To disconnect call Disconnect-SMIMEIMAP.
Parameter List
The following is the full list of the parameters of the cmdlet with short descriptions. Click on the links for further details.
| LogFile | The location of a file to which debug information is written. |
| AuthMechanism | The authentication mechanism to be used when connecting to the mail server. |
| CertPassword | The password to the certificate store. |
| Config | Specifies one or more configuration settings. |
| Credential | The PSCredential object to use for user/password authentication. |
| FirewallHost | Name or IP address of firewall. |
| FirewallPassword | A password if authentication is to be used when connecting through the firewall. |
| FirewallPort | The port of the firewall to which to connect. |
| FirewallType | Determines the type of firewall to connect through. |
| FirewallUser | A user name if authentication is to be used connecting through a firewall. |
| Force | Forces the component to accept the default behavior instead of querying the user. |
| LocalIP | The IP address of the local interface to use. |
| LogFile | The location of a file to which debug information is written. |
| Password | The password to use for authentication. |
| Port | The TCP port in the remote host to which to connect. |
| Server | The address of the Server. |
| Timeout | The maximum time allowed for the operation. |
| User | The username to use for authentication. |
Output Objects
The following is the full list of the output objects returned by the cmdlet with short descriptions. Click on the links for further details.
| SMIMEIMAPConnection | The connection object. |
Config Settings
The following is a list of config settings for the cmdlet with short descriptions. Click on the links for further details.
| BuildInfo | Information about the product's build. |
| CodePage | The system code page used for Unicode to Multibyte translations. |
| LicenseInfo | Information about the current license. |
| MaskSensitive | Whether sensitive data is masked in log messages. |
| UseInternalSecurityAPI | Tells the component whether or not to use the system security libraries or an internal implementation. |
LogFile Parameter (Connect-SMIMEIMAP Cmdlet)
The location of a file to which debug information is written.
Syntax
Connect-SMIMEIMAP -LogFile string
Remarks
When specified, the cmdlet will log debug information to the file. If the file exists, the information will be appended.Default Value
null
ACL Parameter (Connect-SMIMEIMAP Cmdlet)
Indicates whether or not to list the mailbox ACLs.
Syntax
Connect-SMIMEIMAP -ACL SwitchParameter
Remarks
Default Value
false
AuthMechanism Parameter (Connect-SMIMEIMAP Cmdlet)
The authentication mechanism to be used when connecting to the mail server.
Syntax
Connect-SMIMEIMAP -AuthMechanism string
Remarks
Default Value
0
CertPassword Parameter (Connect-SMIMEIMAP Cmdlet)
The password to the certificate store.
Syntax
Connect-SMIMEIMAP -CertPassword string
Remarks
Default Value
""
Parameter Alias
CertificatePassword
CertStore Parameter (Connect-SMIMEIMAP Cmdlet)
The name of the certificate store for the decryption certificate.
Syntax
Connect-SMIMEIMAP -CertStore string
Remarks
Default Value
"MY"
CertStoreType Parameter (Connect-SMIMEIMAP Cmdlet)
The type of certificate store for the decryption certificate.
Syntax
Connect-SMIMEIMAP -CertStoreType string
Remarks
Default Value
0
CertSubject Parameter (Connect-SMIMEIMAP Cmdlet)
The subject of the certificate used for decryption.
Syntax
Connect-SMIMEIMAP -CertSubject string
Remarks
Default Value
"*"
Config Parameter (Connect-SMIMEIMAP Cmdlet)
Specifies one or more configuration settings.
Syntax
Connect-SMIMEIMAP -Config string[]
Remarks
Default Value
null
Credential Parameter (Connect-SMIMEIMAP Cmdlet)
The PSCredential object to use for user/password authentication.
Syntax
Connect-SMIMEIMAP -Credential PSCredential
Remarks
Default Value
null
Parameter Position
1
Parameter Alias
auth
FirewallHost Parameter (Connect-SMIMEIMAP Cmdlet)
Name or IP address of firewall.
Syntax
Connect-SMIMEIMAP -FirewallHost string
Remarks
Default Value
""
FirewallPassword Parameter (Connect-SMIMEIMAP Cmdlet)
A password if authentication is to be used when connecting through the firewall.
Syntax
Connect-SMIMEIMAP -FirewallPassword string
Remarks
Default Value
""
FirewallPort Parameter (Connect-SMIMEIMAP Cmdlet)
The port of the firewall to which to connect.
Syntax
Connect-SMIMEIMAP -FirewallPort int
Remarks
Default Value
0
FirewallType Parameter (Connect-SMIMEIMAP Cmdlet)
Determines the type of firewall to connect through.
Syntax
Connect-SMIMEIMAP -FirewallType string
Remarks
Default Value
0
FirewallUser Parameter (Connect-SMIMEIMAP Cmdlet)
A user name if authentication is to be used connecting through a firewall.
Syntax
Connect-SMIMEIMAP -FirewallUser string
Remarks
Default Value
""
Folder Parameter (Connect-SMIMEIMAP Cmdlet)
The IMAP folder to which to connect.
Syntax
Connect-SMIMEIMAP -Folder string
Remarks
Default Value
""
Parameter Alias
Mailbox
Force Parameter (Connect-SMIMEIMAP Cmdlet)
Forces the component to accept the default behavior instead of querying the user.
Syntax
Connect-SMIMEIMAP -Force SwitchParameter
Remarks
Default Value
false
HeadersOnly Parameter (Connect-SMIMEIMAP Cmdlet)
If true, only message headers will be fetched.
Syntax
Connect-SMIMEIMAP -HeadersOnly SwitchParameter
Remarks
Default Value
false
List Parameter (Connect-SMIMEIMAP Cmdlet)
Number of messages to list.
Syntax
Connect-SMIMEIMAP -List int
Remarks
Default Value
0
Parameter Alias
Last
ListFolders Parameter (Connect-SMIMEIMAP Cmdlet)
Indicates whether or not to perform a List Mailboxes operation on the IMAP server.
Syntax
Connect-SMIMEIMAP -ListFolders SwitchParameter
Remarks
Default Value
false
Parameter Alias
ListMailboxes
LocalFile Parameter (Connect-SMIMEIMAP Cmdlet)
Part is stored here if this property is set.
Syntax
Connect-SMIMEIMAP -LocalFile string
Remarks
Default Value
""
LocalIP Parameter (Connect-SMIMEIMAP Cmdlet)
The IP address of the local interface to use.
Syntax
Connect-SMIMEIMAP -LocalIP string
Remarks
Default Value
""
Parameter Alias
LocalAddress
LogFile Parameter (Connect-SMIMEIMAP Cmdlet)
The location of a file to which debug information is written.
Syntax
Connect-SMIMEIMAP -LogFile string
Remarks
Default Value
""
Part Parameter (Connect-SMIMEIMAP Cmdlet)
If set, the component will retrieve the content of the part from the server.
Syntax
Connect-SMIMEIMAP -Part string
Remarks
Default Value
""
Password Parameter (Connect-SMIMEIMAP Cmdlet)
The password to use for authentication.
Syntax
Connect-SMIMEIMAP -Password string
Remarks
Default Value
""
Port Parameter (Connect-SMIMEIMAP Cmdlet)
The TCP port in the remote host to which to connect.
Syntax
Connect-SMIMEIMAP -Port int
Remarks
Default Value
143
Server Parameter (Connect-SMIMEIMAP Cmdlet)
The address of the Server.
Syntax
Connect-SMIMEIMAP -Server string
Remarks
Default Value
""
Parameter Position
0
This is a required parameter.
SignerCertPassword Parameter (Connect-SMIMEIMAP Cmdlet)
The password to the certificate store.
Syntax
Connect-SMIMEIMAP -SignerCertPassword string
Remarks
Default Value
""
SignerCertStore Parameter (Connect-SMIMEIMAP Cmdlet)
The name of the certificate store for the signature verification certificate.
Syntax
Connect-SMIMEIMAP -SignerCertStore string
Remarks
Default Value
"MY"
SignerCertStoreType Parameter (Connect-SMIMEIMAP Cmdlet)
The type of certificate store for the signature verification certificate. In most cases PublicKeyFile is used.
Syntax
Connect-SMIMEIMAP -SignerCertStoreType string
Remarks
Default Value
0
SignerCertSubject Parameter (Connect-SMIMEIMAP Cmdlet)
The subject of the recipient's public certificate used for signature verification.
Syntax
Connect-SMIMEIMAP -SignerCertSubject string
Remarks
Default Value
"*"
SMIME Parameter (Connect-SMIMEIMAP Cmdlet)
Specifies the expected protection level on the received messages.
Syntax
Connect-SMIMEIMAP -SMIME string
Remarks
Default Value
0
Timeout Parameter (Connect-SMIMEIMAP Cmdlet)
The maximum time allowed for the operation.
Syntax
Connect-SMIMEIMAP -Timeout int
Remarks
Default Value
10
User Parameter (Connect-SMIMEIMAP Cmdlet)
The username to use for authentication.
Syntax
Connect-SMIMEIMAP -User string
Remarks
Default Value
""
View Parameter (Connect-SMIMEIMAP Cmdlet)
The message number to view.
Syntax
Connect-SMIMEIMAP -View int
Remarks
Default Value
0
Parameter Alias
MessageNumber
SMIMEIMAPConnection Output Object (Connect-SMIMEIMAP Cmdlet)
The connection object.
Syntax
Object SMIMEIMAPConnection {string AuthMechanism;
string CertPassword;
string[] Config;
PSCredential Credential;
string FirewallHost;
string FirewallPassword;
int FirewallPort;
string FirewallType;
string FirewallUser;
SwitchParameter Force;
string LocalIP;
string LogFile;
string Password;
int Port;
string Server;
int Timeout;
string User;
}