Set-ImapSettings
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-ImapSettings コマンドレットを使用して、Exchange サーバー上の Microsoft Exchange IMAP4 サービスの設定を変更します。 このサービスは、クライアント アクセス サーバーの役割がインストールされている Exchange サーバー上に存在し、Exchange に接続するために IMAP4 クライアントによって使用されます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-ImapSettings
[-AuthenticatedConnectionTimeout <EnhancedTimeSpan>]
[-Banner <String>]
[-CalendarItemRetrievalOption <CalendarItemRetrievalOptions>]
[-Confirm]
[-DomainController <Fqdn>]
[-EnableExactRFC822Size <Boolean>]
[-EnableGSSAPIAndNTLMAuth <Boolean>]
[-EnforceCertificateErrors <Boolean>]
[-ExtendedProtectionPolicy <ExtendedProtectionTokenCheckingMode>]
[-ExternalConnectionSettings <MultiValuedProperty>]
[-InternalConnectionSettings <MultiValuedProperty>]
[-LogFileLocation <String>]
[-LogFileRollOverSettings <LogFileRollOver>]
[-LoginType <LoginOptions>]
[-LogPerFileSizeQuota <Unlimited>]
[-MaxCommandSize <Int32>]
[-MaxConnectionFromSingleIP <Int32>]
[-MaxConnections <Int32>]
[-MaxConnectionsPerUser <Int32>]
[-MessageRetrievalMimeFormat <MimeTextFormat>]
[-OwaServerUrl <Uri>]
[-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>]
[-ProtocolLogEnabled <Boolean>]
[-ProxyTargetPort <Int32>]
[-Server <ServerIdParameter>]
[-ShowHiddenFoldersEnabled <Boolean>]
[-SSLBindings <MultiValuedProperty>]
[-SuppressReadReceipt <Boolean>]
[-UnencryptedOrTLSBindings <MultiValuedProperty>]
[-WhatIf]
[-X509CertificateName <String>]
[<CommonParameters>]
説明
Set-ImapSettings コマンドレットは、Microsoft Exchange IMAP4 サービスを実行している 1 つの Exchange サーバー、または Microsoft Exchange IMAP4 サービスを実行しているすべての Exchange サーバーに対して実行できます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-ImapSettings -Server "MBX01" -UnencryptedOrTLSBindings 10.0.0.0:143
この例では、TCP ポート 143 でローカル IP アドレス 10.0.0.0 を使用して、MBX01 という名前のサーバーへの非暗号化または STARTTLS で暗号化された IMAP4 接続を構成します。
例 2
Set-ImapSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Imap4Logging"
この例では、IMAP4 プロトコル ログ出力を有効にします。 また、IMAP4 プロトコル ログ出力のディレクトリを C:\Imap4Logging に変更します。
例 3
Set-ImapSettings -LogPerFileSizeQuota 2MB
この例では、ログ ファイルが 2 MB に達したら新しいログ ファイルを作成するように、IMAP4 プロトコル ログ出力を変更します。
例 4
Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly
この例では、新しいログ ファイルを 1 時間ごとに作成するように、IMAP4 プロトコル ログ出力を変更します。
例 5
Set-ImapSettings -X509CertificateName mail.contoso.com
この例では、IMAP4 クライアント接続の暗号化に使用される mail.contoso.com を含む証明書を指定します。
注: 単一サブジェクト証明書または SAN 証明書の場合は、Enable-ExchangeCertificate コマンドレットを使用して、Exchange IMAP サービスに証明書を割り当てる必要もあります。 ワイルドカード証明書の場合は、Exchange IMAP サービスに証明書を割り当てる必要はありません (割り当てるとエラーが発生します)。
パラメーター
-AuthenticatedConnectionTimeout
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
AuthenticatedConnectionTimeout パラメーターは、認証されたアイドル状態の接続を閉じるまでの待機時間を指定します。
値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。
正しい値は 00:00:30 ～ 1:00:00 です。 既定の設定は 00:30:00 (30 分) です。
パラメーターのプロパティ
| 型: | EnhancedTimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Banner
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Banner パラメーターは、接続している IMAP4 クライアントに表示されるテキスト文字列を指定します。 既定値は、Microsoft Exchange IMAP4 サービスの準備ができています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CalendarItemRetrievalOption
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
CalendarItemRetrievalOption パラメーターは、予定表アイテムを IMAP4 クライアントに表示する方法を指定します。 有効な値は次のとおりです。
- 0 または iCalendar。 この値が既定値です。
- 1 または IntranetUrl
- 2 または InternetUrl
- 3 またはカスタム
3 または Custom を指定する場合は、OwaServerUrl パラメーター設定の値を指定する必要があります。
パラメーターのプロパティ
| 型: | CalendarItemRetrievalOptions |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EnableExactRFC822Size
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
EnableExactRFC822Size パラメーターは、メッセージ サイズを IMAP4 クライアントに提示する方法を指定します。 有効な値は次のとおりです。
- $true: 正確なメッセージ サイズを計算します。 この設定はパフォーマンスに悪影響を与える可能性があるため、IMAP4 クライアントで必要な場合にのみ構成する必要があります。
- $false: 推定メッセージ サイズを使用します。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EnableGSSAPIAndNTLMAuth
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
EnableGSSAPIAndNTLMAuth パラメーターは、接続で Generic Security Services アプリケーション プログラミング インターフェイス (GSSAPI) を使用して統合 Windows 認証 (NTLM) を使用できるかどうかを指定します。 この設定は、トランスポート層セキュリティ (TLS) が無効になっている接続に適用されます。 有効な値は次のとおりです。
- $true: IMAP4 接続用の NTLM が有効になっています。 この値が既定値です。
- $false: IMAP4 接続の NTLM は無効になっています。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EnforceCertificateErrors
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
EnforceCertificateErrors パラメーターは、トランスポート層セキュリティ (TLS) 証明書の検証エラーを強制するかどうかを指定します。 有効な値は次のとおりです。
- $true: 証明書が有効でない場合、またはターゲット IMAP4 サーバーの FQDN と一致しない場合、接続試行は失敗します。
- $false: サーバーは、証明書エラーに基づいて IMAP4 接続を拒否しません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExtendedProtectionPolicy
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExtendedProtectionPolicy パラメーターは、認証の拡張保護の使用方法を指定します。 有効な値は次のとおりです。
- None: 認証の拡張保護は使用されません。 この値が既定値です。
- 許可: 認証の拡張保護は、着信 IMAP4 接続でサポートされている場合にのみ使用されます。 表示されていない場合、認証の拡張保護は使用されません。
- 必須: すべての IMAP4 接続には、認証の拡張保護が必要です。 着信 IMAP4 接続がサポートされていない場合、接続は拒否されます。
認証の拡張保護は、統合 Windows 認証 (NTLM とも呼ばれます) による資格情報の保護と処理を強化するため、クライアントでサポートされている場合 (Windows 7 以降および Windows Server 2008 R2 以降の既定のインストールでサポートされている場合に使用することを強くお勧めします)。
パラメーターのプロパティ
| 型: | ExtendedProtectionTokenCheckingMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExternalConnectionSettings
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExternalConnectionSettings パラメーターは、外部 IMAP4 クライアント (企業ネットワークの外部からの IMAP4 接続) が使用するホスト名、ポート、および暗号化方法を指定します。
このパラメーターには、構文 HostName:Port:[<TLS | SSL>] を使用します。 暗号化方法の値は省略可能です (空白は暗号化されていない接続を示します)。
既定値は空白 ($null) で、外部 IMAP4 接続設定が構成されていないことを意味します。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
このパラメーターに指定する暗号化方式とポートの組み合わせは、SSLBindings パラメーターおよび UnencryptedOrTLSBindings パラメーターで指定される対応する暗号化方式とポートと一致する必要があります。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InternalConnectionSettings
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
InternalConnectionSettings パラメーターは、内部 IMAP4 クライアント (企業ネットワーク内からの IMAP4 接続) が使用するホスト名、ポート、および暗号化方法を指定します。 この設定は、Microsoft Exchange IMAP4 サービスを実行している別の Exchange サーバーに IMAP4 接続が転送されるときにも使用されます。
このパラメーターには、構文 HostName:Port:[<TLS | SSL>] を使用します。 暗号化方法の値は省略可能です (空白は暗号化されていない接続を示します)。
既定値は <ServerFQDN>:993:SSL,<ServerFQDN>:143:TLS です。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
このパラメーターに指定する暗号化方式とポートの組み合わせは、SSLBindings パラメーターおよび UnencryptedOrTLSBindings パラメーターで指定される対応する暗号化方式とポートと一致する必要があります。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LogFileLocation
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
LogFileLocation パラメーターには、IMAP4 プロトコル ログ ファイルの場所を指定します。 既定値は %ExchangeInstallPath%Logging\Imap4 です。
このパラメーターは、ProtocolLogEnabled パラメーター値が $true の場合にのみ意味があります。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LogFileRollOverSettings
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
LogFileRollOverSettings パラメーターは、IMAP4 プロトコルのログ出力で新しいログ ファイルを作成する頻度を指定します。 有効な値は次のとおりです。
- 1 または Hourly。 この値は、Exchange 2019 および Exchange 2016 の既定値です。
- 2 または Daily。 この値は、Exchange 2013 および Exchange 2010 の既定値です。
- 3 または Weekly。
- 4 または Monthly。
このパラメーターは、LogPerFileSizeQuota パラメーター値が 0 で、ProtocolLogEnabled パラメーター値が $true の場合にのみ意味があります。
パラメーターのプロパティ
| 型: | LogFileRollOver |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LoginType
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
LoginType パラメーターは、IMAP4 接続の認証方法を指定します。 有効な値は次のとおりです。
- 1 または PlainTextLogin。
- 2 または PlainTextAuthentication。
- 3 または SecureLogin。 この値が既定値です。
パラメーターのプロパティ
| 型: | LoginOptions |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LogPerFileSizeQuota
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
LogPerFileSizeQuota パラメーターは、IMAP4 プロトコル ログ ファイルの最大サイズを指定します。
値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。
- B (バイト)
- KB (キロバイト)
- MB (メガバイト)
- GB (ギガバイト)
- TB (テラバイト)
通常、非修飾値はバイトとして扱われますが、小さい値は最も近いキロバイトに切り上げられる場合があります。
既定値は 0 で、LogFileRollOverSettings パラメーターで指定された頻度で新しい IMAP4 プロトコル ログ ファイルが作成されることを意味します。
このパラメーターは、ProtocolLogEnabled パラメーター値が $true の場合にのみ意味があります。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxCommandSize
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MaxCommandSize パラメーターは、1 つの IMAP4 コマンドの最大サイズをバイト単位で指定します。 有効な値は 1024 - 16384 です。 既定値は 10240 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxConnectionFromSingleIP
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MaxConnectionFromSingleIP パラメーターは、Exchange サーバーが単一の IP アドレスから受け入れる IMAP4 接続の最大数を指定します。 正しい値は 1 ～ 2147483647 です。 既定値は 2147483647 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxConnections
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MaxConnections パラメータは、Exchange サーバーで受け入れられる IMAP4 接続の最大数を指定します。 正しい値は 1 ～ 2147483647 です。 既定値は 2147483647 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxConnectionsPerUser
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MaxConnectionsPerUser パラメーターは、ユーザーごとに許可される IMAP4 接続の最大数を指定します。 正しい値は 1 ～ 2147483647 です。 既定値は 16 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MessageRetrievalMimeFormat
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MessageRetrievalMimeFormat パラメーターは、メッセージの MIME エンコードを指定します。 有効な値は次のとおりです。
- 0 または TextOnly。
- 1 または HtmlOnly。
- 2 または HtmlAndTextAlternative。
- 3 または TextEnrichedOnly。
- 4 または TextEnrichedAndTextAlternative。
- 5 または BestBodyFormat。 この値が既定値です。
- 6 または Tnef。
パラメーターのプロパティ
| 型: | MimeTextFormat |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OwaServerUrl
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
OwaServerUrl パラメーターは、カスタム Outlook on the web 予定表アイテムのインスタンスの予定表情報を取得するために使用する URL を指定します。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PreAuthenticatedConnectionTimeout
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
PreAuthenticatedConnectionTimeout パラメーターは、認証されていないアイドル状態の IMAP4 接続を閉じるまでの待機期間を指定します。
値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。
有効な値は 00:00:30 から 1:00:00 です。 既定値は 00:01:00、つまり 1 分間です。
パラメーターのプロパティ
| 型: | EnhancedTimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProtocolLogEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ProtocolLogEnabled パラメーターは、IMAP4 のプロトコル ログを有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: IMAP4 プロトコル ログは有効になっています。
- $false: IMAP4 プロトコル ログは無効になっています。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyTargetPort
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ProxyTargetPort パラメーターは、Microsoft Exchange IMAP4 サービスからプロキシされたクライアント接続をリッスンする Microsoft Exchange IMAP4 バックエンド サービスのポートを指定します。 既定値は 1993 です。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Server
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- Exchange の従来の DN
このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ShowHiddenFoldersEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ShowHiddenFoldersEnabled パラメーターは、非表示のメールボックス フォルダーを表示するかどうかを指定します。 有効な値は次のとおりです。
- $true: 隠しフォルダーが表示されます。
- $false: 隠しフォルダーは表示されません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SSLBindings
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SSLBindings パラメーターは、常に SSL/TLS によって暗号化される IMAP4 接続に使用される IP アドレスと TCP ポートを指定します。 このパラメーターには、構文 IPv4OrIPv6Address:Port を使用します。
既定値は [::]:993,0.0.0.0:993 です。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SuppressReadReceipt
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SuppressReadReceipt パラメーターは、IMAP4 電子メール プログラムで [送信するメッセージの開封確認メッセージを送信する] 設定が構成されている IMAP4 クライアントに重複した開封確認メッセージが送信されないようにするかどうかを指定します。 有効な値は次のとおりです。
- $true: 送信者は、受信者がメッセージを開封した場合にのみ開封確認を受け取ります。
- $false: 受信者がメッセージをダウンロードしたとき、および受信者がメッセージを開封したときに、送信者は開封確認メッセージを受け取ります。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UnencryptedOrTLSBindings
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
UnencryptedOrTLSBindings パラメーターは、暗号化されていない IMAP4 接続、または最初の暗号化されていないプロトコル ハンドシェイクの後に Opportunistic TLS (STARTTLS) を使用して暗号化される IMAP4 接続に使用される IP アドレスと TCP ポートを指定します。 このパラメーターには、構文 IPv4OrIPv6Address:Port を使用します。
既定値は [::]:143,0.0.0.0:143 です。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-X509CertificateName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
X509CertificateName パラメーターは、IMAP4 クライアント接続の暗号化に使用する証明書を指定します。
このパラメーターの有効な値は、ExternalConnectionSettings パラメーターまたは InternalConnectionSettings パラメーター (mail.contoso.com や mailbox01.contoso.com など) からの FQDN です。
単一のサブジェクト証明書またはサブジェクト別名 (SAN) 証明書を使用している場合は、Enable-ExchangeCertificate コマンドレットを使用して、Exchange IMAP サービスに証明書を割り当てる必要もあります。
ワイルドカード証明書を使用する場合は、Exchange IMAP サービスに証明書を割り当てる必要はありません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。