Test-ImapConnectivity
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2010-08-18
Test-ImapConnectivity コマンドレットは、IMAP4 サービスが正常に実行されているかどうかを確認するために使用します。Test-ImapConnectivity コマンドレットを使用すると、同じ Active Directory サイト内にある Exchange 2007 サーバー上のすべてのメールボックスについて、指定したクライアント アクセス サーバーの IMAP4 機能をテストすることができます。
構文
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
Test-ImapConnectivity コマンドレットは、IMAP4 サービスが正常に実行されているかどうかを確認するために使用します。Test-ImapConnectivity コマンドレットを使用すると、指定したクライアント アクセス サーバーの IMAP4 機能をテストすることができます。
クライアント アクセス サーバーで Test-PopConnectivity コマンドレットを実行して IMAP4 機能をテストするには、使用するアカウントに Exchange サーバーの管理者の役割、および対象サーバーのローカルの Administrators グループのメンバシップが委任されている必要があります。
Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 | ||
|---|---|---|---|---|---|
ClientAccessServer |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
このパラメータには、テストするクライアント アクセス サーバーの名前を指定します。このパラメータは、URL パラメータと同時に使用できません。 |
||
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
||
ConnectionType |
省略可能 |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
このパラメータには、クライアント アクセス サーバーに接続するために使用する接続の種類を指定します。 |
||
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
Active Directory ディレクトリ サービスからデータを取得するドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドレットに DomainController パラメータを含めます。 |
||
LightMode |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータは、Test-ImapConnectivity コマンドレットには実装されていません。このパラメータを使用しても、コマンドレットの動作は変更されません。
|
||
MailboxCredential |
省略可能 |
System.Management.Automation.PSCredential |
このパラメータには、1 つの URL をテストする場合に使用するメールボックスの資格情報を含めます。 |
||
MailboxServer |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
このパラメータには、テストするメールボックス サーバーの名前を指定します。指定されていない場合、ローカルの Active Directory サイト内にあるすべてのメールボックス サーバーがテストされます。 |
||
MonitoringContext |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータが含まれている場合は、タスクは Microsoft Operations Manager (MOM) のスケジュール設定によって実行されます。このパラメータを指定して MOM を利用せずにタスクを実行すると、タスクは失敗します。このパラメータを指定しない場合、管理者がタスクを対話的に実行する必要があります。 |
||
PerConnectionTimeout |
省略可能 |
System.Int32 |
このパラメータには、各接続でテスト操作が終了するまで待機する時間を秒単位で指定します。PerConnectionTimeout の既定値は 24 秒です。0 秒より大きく、120 秒より小さい Timeout 値を指定する必要があります。このパラメータは常に 5 秒以上の値で構成することをお勧めします。 |
||
PortClientAccessServer |
省略可能 |
System.Int32 |
このパラメータには、Test-ImapConnectivity コマンドレットでクライアント アクセス サーバーに接続するときに使用するポートを指定します。 |
||
ResetTestAccountCredentials |
省略可能 |
System.Management.Automation.SwitchParameter |
ResetTestAccountCredentials パラメータは、このコマンドを実行するために使用されるテスト アカウントのパスワードをリセットします。Microsoft System Center Operations Manager を使用して Exchange 環境を管理している場合、テスト アカウントのパスワードは一般に 7 日ごとにリセットされます。セキュリティ上の理由で必要になったときにはいつでもこのフラグを使用して、パスワードをリセットできます。 |
||
Timeout |
省略可能 |
System.UInt32 |
このパラメータには、テスト操作が終了するまで待機する時間を秒単位で指定します。Timeout の既定値は 30 秒です。0 秒より大きく、1 時間 (3,600 秒) より小さい Timeout 値を指定する必要があります。このパラメータは常に 5 秒以上の値で構成することをお勧めします。 |
||
TrustAnySSLCertificate |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータが使用されている場合、SSL (Secure Sockets Layer) 証明書の検証エラーは報告されません。このパラメータを使用すると、Test-ImapConnectivity コマンドレットは証明書とクライアント アクセス サーバーの URL が対応していない場合にエラーを生成せずに、IMAP4 サービスをチェックします。 |
||
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
.gif "note")
注 :入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
|
例
最初のコード例は、ユーザー contoso\kweku の資格情報を使用して、クライアント アクセス サーバー Contoso12 の IMAP4 接続をテストします。
2 番目のコード例は、Contoso12 という名前の特定のクライアント アクセス サーバーについて IMAP4 接続をテストします。このコード例では、すべての Exchange 2007 メールボックスがテストされます。
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。