New-ExchangeCertificate
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
New-ExchangeCertificate コマンドレットは、自己署名証明書を作成および更新したり、証明機関 (CA) に新しい証明書や証明書更新を求める証明書要求 (証明書署名要求 (CSR) とも言う) を作成したりする場合に使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Request
New-ExchangeCertificate
[-BinaryEncoded]
[-GenerateRequest]
[-RequestFile <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DomainName <MultiValuedProperty>]
[-Force]
[-FriendlyName <String>]
[-IncludeAcceptedDomains]
[-IncludeAutoDiscover]
[-IncludeServerFQDN]
[-IncludeServerNetBIOSName]
[-Instance <X509Certificate2>]
[-KeySize <Int32>]
[-PrivateKeyExportable <Boolean>]
[-Server <ServerIdParameter>]
[-SubjectKeyIdentifier <String>]
[-SubjectName <X500DistinguishedName>]
[-WhatIf]
[<CommonParameters>]
Certificate
New-ExchangeCertificate
[-Services <AllowedServices>]
[-Confirm]
[-DomainController <Fqdn>]
[-DomainName <MultiValuedProperty>]
[-Force]
[-FriendlyName <String>]
[-IncludeAcceptedDomains]
[-IncludeAutoDiscover]
[-IncludeServerFQDN]
[-IncludeServerNetBIOSName]
[-Instance <X509Certificate2>]
[-KeySize <Int32>]
[-PrivateKeyExportable <Boolean>]
[-Server <ServerIdParameter>]
[-SubjectKeyIdentifier <String>]
[-SubjectName <X500DistinguishedName>]
[-WhatIf]
[<CommonParameters>]
説明
Exchange では、トランスポート層セキュリティ (TLS) 暗号化に証明書を使用します。
TLS サービスの証明書を構成するときは、考慮すべき要素が多数あります。 また、これらの要素が構成全体に与える影響も理解しておく必要があります。 詳細については、「Exchange Server でのデジタル証明書と暗号化」を参照してください。
TLS は、コンピューター システム間で送信されるデータを暗号化するために使用されるプロトコルとして、Secure Sockets Layer (SSL) に取って代わりました。 以前は、「TLS」と「SSL」はしばしば同じ意味で使われていました。 Exchange ドキュメントでの SSL への参照は、バージョン番号 (SSL 3.0 など) も含まれる場合を除き、実際には TLS を意味します。 詳細については、「Exchange Server TLS 構成のベスト プラクティス」を参照してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-ExchangeCertificate
この例では、次の設定の自己署名証明書を作成します。
- [件名] の値は
CN=<ServerName>です (CN=Mailbox01 など)。 - ドメイン (サブジェクトの別名) の値は
<ServerName>,<ServerFQDN>です (たとえば、Mailbox01,Mailbox01.contoso.com)。 - サービスの値は
IMAP,POP,SMTPです。 - Services 値 SMTP は、Network Services ローカル セキュリティ グループに証明書の秘密キーに対する読み取りアクセス権を付与します。
- サービス値 SMTP とサブジェクトの値にはサーバー名が含まれており、Active Directory に証明書が公開されるため、Exchange 直接信頼がサーバーの信頼性を相互 TLS に対して検証できます。
Exchange のセットアップ時に作成された既存の自己署名証明書をこの証明書で置き換えたくない場合は、既存の既定の SMTP 証明書を上書きするように求めるプロンプトで [いいえ] を選択してください。
例 2
Get-ExchangeCertificate -Thumbprint c4248cd7065c87cb942d60f7293feb7d533a4afc | New-ExchangeCertificate -PrivateKeyExportable $true
この例では、特定の拇印値を使用して証明書を更新する方法を示します。 サムプリントの値は、次の 2 つの方法のいずれかで検索できます。
- Exchange 管理センターで証明書を選択し、[編集] を選択して証明書のプロパティを表示します。 サムプリントの値は [Exchange 証明書] ウィンドウに表示されます。
- Get-ExchangeCertificate コマンドレットを実行して、サーバーにインストールされているすべての証明書の一覧を、サムプリントの値と共に返します。
PrivateKeyExportable パラメーターを値 $true に設定すると、更新された証明書をサーバーからエクスポートする (および他のサーバーにインポートする) ことができます。
例 3
New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com -RequestFile "C:\Cert Requests\woodgrovebank.req"
Exchange 2013 では、この例では、次の設定を持つ証明機関に対する新しい証明書要求を作成します。
- 要求は、Base64 でエンコードされます。
- [件名] の値は
c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.comです。 - ドメイン (サブジェクトの別名) 値には、追加の valuesautodiscover.woodgrovebank.com、mail.fabrikam.com、および autodiscover.fabrikam.com が含まれています。
- コマンド出力は画面に表示され、テキスト ファイル C:\Cert Requests\woodgrovebank.req にも書き込まれます。
注: RequestFile パラメーターは、Exchange 2013 でのみ使用できます。 Exchange 2016 または Exchange 2019 で新しい証明書要求ファイルを作成するには、例 4 と例 5 を参照してください。
証明書要求を作成したら、出力を CA に送信します。 CA から証明書を受け取ったら、Import-ExchangeCertificate コマンドレットを使用して証明書をインストールし、Enable-ExchangeCertificate コマンドレットを使用して証明書を Exchange サービスに割り当てます。
CA が DER によってエンコードされたファイルで証明書要求を必要とする場合は、BinaryEncoding スイッチを使用して、ファイルを .pfx 拡張子で保存します。
例 4
$txtrequest = New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com
[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))
この例では、例 3 と同じ証明書設定を使用して、証明機関に対する新しい Base64 エンコード証明書要求を作成します。
Exchange 2016 および Exchange 2019 では RequestFile パラメーターを使用できないため、このメソッドが必要です。
例 5
$binrequest = New-ExchangeCertificate -GenerateRequest -BinaryEncoded -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com
[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.pfx', $binrequest.FileData)
この例では、例 4 と同じ証明書設定を使用して、証明機関に対する新しい DER エンコード (バイナリ) 証明書要求を作成します。
Exchange 2016 および Exchange 2019 では RequestFile パラメーターを使用できないため、このメソッドが必要です。
例 6
Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest -RequestFile "C:\Cert Requests\fabrikam_renewal.req"
Exchange 2013 では、この例では、証明機関によって発行された既存の証明書の更新要求を作成します。 この証明書の要求の設定は、次のとおりです。
- 既存の証明書の拇印値は 8A141F7F2BBA8041973399723BD2598D2ED2D831 です。 Get-ExchangeCertificate コマンドレットを使用して拇印値を検索できます。
- 要求は、Base64 でエンコードされます。
- 出力は画面に表示されます。また、テキスト ファイル C:\Cert Requests\fabrikam_renewal.req にも書き込まれます。
注: RequestFile パラメーターは、Exchange 2013 でのみ使用できます。 Exchange 2016 または Exchange 2019 で証明機関の証明書更新要求を作成するには、例 7 と例 8 を参照してください。
証明書の更新要求の作成後、出力を CA に送信します。 更新された証明書を CA から受信した後、Import-ExchangeCertificate コマンドレットを使用して証明書をインストールします。
例 7
$txtrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest
[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))
この例では、例 6 と同じ証明書設定を使用して、Base64 でエンコードされた証明機関の証明書更新要求ファイルを作成します。
Exchange 2016 および Exchange 2019 では RequestFile パラメーターを使用できないため、このメソッドが必要です。
例 8
$binrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest
[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.pfx', $binrequest.FileData)
この例では、例 7 と同じ証明書設定を使用して、証明機関用の新しい DER エンコード (バイナリ) 証明書更新要求ファイルを作成します。
パラメーター
-BinaryEncoded
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
BinaryEncoded スイッチは、Distinguished Encoding Rules (DER) を使用して新しい証明書要求をエンコードするかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しないと、要求は Base64 でエンコードされます。
このスイッチを利用できるのは、GenerateRequest スイッチを使用する場合のみです。
Base64 でエンコードされる要求の場合、ファイルの内容を証明機関に送信します。 DER でエンコードされる要求の場合は、証明書ファイル自体を送信します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Request
| 配置: | 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 です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainName パラメーターは、証明書要求または自己署名証明書のサブジェクト代替名フィールド (サブジェクト代替名または SAN フィールドとも呼ばれる) に 1 つ以上の FQDN またはサーバー名を指定します。
証明書の Subject フィールドの値が転送先サーバー名または FQDN と一致しない場合、リクエスターは Subject Alternative Name フィールドで一致する項目を探します。
通常、値には、サーバー名 (Mailbox01 など) および FQDN (mail.contoso.com など) が含まれます。 複数の値をコンマで区切って指定できます。 値には、文字 a から z、0 から 9、およびハイフン (-) を含めることができます。 ドメイン名の長さは 255 文字以下にする必要があります。
次の両方の条件を満たす場合、既定値には Exchange サーバーの名前と FQDN が含まれます。
- このパラメーターを使用していない。
- IncludeAcceptedDomains、IncludeAutoDiscover、IncludeServerFQDN、または IncludeServerNetBIOSName のいずれのパラメーターも使用しません。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
[強制] スイッチは、警告または確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
既定では、SMTP が有効な自己署名証明書を作成する場合 (Services パラメーターを指定しない場合、または Services パラメーターの値が SMTP の場合)、作成しようとしている新しい証明書で既存の既定の SMTP 証明書を置き換えるように求めるダイアログが表示されます。 Force スイッチを使用する場合、確認なく自動的に、新しい SMTP 証明書で既存の SMTP 証明書が置き換えられます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FriendlyName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
FriendlyName パラメーターは、証明書要求または自己署名証明書のフレンドリ名を指定します。 値は 64 文字未満にする必要があります。
既定値は Microsoft Exchange です。 フレンドリ名の値は、説明テキストで、証明書の機能には影響しません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GenerateRequest
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GenerateRequest スイッチは、証明機関 (CA) の証明書要求を作成することを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用して出力をファイルにエクスポートすると、CA に送信する PKCS #10 証明書要求が生成されます。 情報を送信する方法は CA によって異なりますが、Base64 でエンコードされる要求の場合は、メール メッセージや、CA の Web サイトの要求フォームに内容を貼り付けるのが普通です。
Import-ExchangeCertificate コマンドレットを使用して証明機関から証明書をインストールした後、Enable-ExchangeCertficate コマンドレットを使用して Exchange サービスに対して証明書を有効にします。
このスイッチを使用しない場合、コマンドは Exchange サーバー上に新しい自己署名証明書を作成します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Request
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeAcceptedDomains
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeAcceptedDomains スイッチは、Exchange organization 内のすべての承認済みドメインが、証明書要求または自己署名証明書の [サブジェクトの別名] フィールドに含まれることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用する場合:
- DomainName パラメーターに承認済みドメインが既に含まれていると、この値は Subject Alternative Name フィールドで複製されません。
- 新しい自己署名証明書の場合、Services パラメーターを使用しないと、証明書は SMTP にのみ割り当てられます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeAutoDiscover
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeAutoDiscover スイッチは、Exchange organization 内の承認済みドメインごとに、サブフィックス自動検出 サブジェクトの別名値を追加するかどうかを指定します。 このスイッチで値を指定する必要はありません。
たとえば、組織が承認済みドメイン woodgrovebank.com および woodgrovebank.co.uk を持つ場合、このスイッチを使用すると Subject Alternative Name フィールドに次の値が追加されます。
- autodiscover.woodgrovebank.com
- autodiscover.woodgrovebank.co.uk
このスイッチを使用する場合:
- DomainName パラメーターに
autodiscover.<AcceptedDomain>値を既に含めている場合、その値は [サブジェクトの別名] フィールドで複製されません。 - 新しい自己署名証明書の場合、Services パラメーターを使用しないと、証明書は SMTP にのみ割り当てられます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeServerFQDN
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeServerFQDN スイッチは、Exchange サーバーの FQDN が新しい証明書要求または自己署名証明書の [サブジェクトの別名] フィールドに含まれることを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用し、サーバーの FQDN を DomainName パラメーターに既に含めている場合、値は [サブジェクトの別名] フィールドで複製されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncludeServerNetBIOSName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
IncludeServerNetBIOSName スイッチは、Exchange サーバーの NetBIOS 名が、新しい証明書要求または自己署名証明書の [サブジェクトの別名] フィールドに含まれることを指定します。 このスイッチに値を指定する必要はありません。
このスイッチを使用し、サーバーの NetBIOS 名を DomainName パラメーターに既に含めておくと、[サブジェクトの別名] フィールドに値が重複することはありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Instance
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは非推奨となり、使用されなくなりました。
パラメーターのプロパティ
| 型: | X509Certificate2 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-KeySize
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
KeySize パラメーターは、新しい証明書要求または自己署名証明書に関連付けられる RSA パブリック キーのサイズ (ビット単位) を指定します。 有効な値は次のとおりです。
- 1024
- 2048 (既定値)
- 4096
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PrivateKeyExportable
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
PrivateKeyExportable パラメーターは、証明書にエクスポート可能な秘密キーがあるかどうかを指定します。また、サーバーから証明書をエクスポートできる (および他のサーバーに証明書をインポートできる) かどうかを制御します。 有効な値は次のとおりです。
- $true: 秘密キーはエクスポート可能であるため、サーバーから証明書をエクスポートできます。
- $false: 秘密キーはエクスポートできないため、証明書をエクスポートできません。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequestFile
適用対象: Exchange Server 2013
注: このパラメーターは、UNC パス値を受け入れるため、2022 H1 累積更新プログラムによって Exchange 2016 および Exchange 2019 から削除されました。 RequestFile パラメーターを使用せずに証明書要求をファイルにエクスポートするには、例 4 と例 5 (新規) または例 7 と例 8 (更新) を参照してください。
このパラメーターは Exchange Server 2013 でのみ使用できます。
RequestFile パラメーターは、証明書要求ファイルの名前とパスを指定します。 このファイルには、Base64 でエンコードされる証明書要求を生成するときに画面に表示されるのと同じ情報が含まれています (BinaryEncoded スイッチは使用しないでください)。
コマンドを実行しているのと同じ Exchange サーバーに証明書または証明書要求がある場合は、ローカル パスを使用できます。 それ以外の場合は、UNC パス (\\Server\Share) を使用します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
このパラメーターを使用できるのは、GenerateRequest スイッチを使用する場合のみです。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Request
| 配置: | 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 |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Services
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Services パラメータは、新しい自己署名証明書を有効にする Exchange サービスを指定します。 有効な値は次のとおりです。
- なし: 後で Enable-ExchangeCertificate コマンドレットを使用して、Exchange サービスの証明書を有効にできます。
- フェデレーション
- IIS
- IMAP: IMAP4 サービスのワイルドカード証明書を有効にしないでください。 代わりに、Set-ImapSettings コマンドレットを使用して、クライアントが IMAP4 サービスへの接続に使用する FQDN を構成します。
- POP: POP3 サービス用のワイルドカード証明書を有効にしないでください。 代わりに、Set-PopSettings コマンドレットを使用して、クライアントが POP3 サービスへの接続に使用する完全修飾ドメイン名 (FQDN) を構成します。
- SMTP: SMTP の証明書を有効にすると、内部 Exchange 間の SMTP トラフィックを暗号化するために使用される既定の Exchange 自己署名証明書を置き換えるように求められます。 確認のためのプロンプトが表示されることなく既定の証明書を置き換える場合には、Force スイッチを使用します。
- UM: この値は、Set-UMService コマンドレットの UMStartupMode パラメーターが TLS またはデュアルに設定されている必要があります。 UMStartupMode パラメーターが TCP の既定値に設定されている場合、UM サービスの証明書を有効にすることはできません。
- UMCallRouter: この値は、Set-UMCallRouterService コマンドレットの UMStartupMode パラメーターが TLS またはデュアルに設定されている必要があります。 UMStartupMode パラメーターが既定値の TCP に設定されている場合、UM Call Router サービスの証明書を有効にすることはできません。
複数の値をコンマで区切って指定できます。 既定値は IMAP、POP、SMTP です。
このパラメーターを GenerateRequest スイッチと併用することはできません。
証明書でサービスを有効にすると、そのサービスを証明書から削除できなくなります。
パラメーターのプロパティ
| 型: | AllowedServices |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Certificate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SubjectKeyIdentifier
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SubjectKeyIdentifier パラメーターは、新しい自己署名証明書の一意のサブジェクト キー識別子を指定します。 たとえば、$ski = [System.Guid]::NewGuid().ToString("N") コマンドを実行し、このパラメーターに値 $ski を使用します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SubjectName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SubjectName パラメーターは、証明書要求または自己署名証明書の Subject フィールドを指定します。
すべての証明書には [サブジェクト] フィールドの値が必要であり、使用できる値は 1 つだけです。 要求元は、宛先サーバー名または FQDN をサブジェクトの共通名 (CN) 値と照合しようとします。
このパラメーターは次の構文を使用します: [C=CountryOrRegion,S=StateOrProvince,L=LocalityOrCity,O=Organization,OU=Department],CN=HostNameOrFQDN。 必要な値は CN=HostNameOrFQDN のみですが、証明書要求の場合は必ず C=CountryOrRegion を含める必要がありますが、他の値は証明機関によっても必要な場合があります。
たとえば、証明書のサブジェクトを米国の mail.contoso.com にする場合、次の任意の値を使用できます。
- C=US,S=WA,L=Redmond,O=Contoso,OU=IT,CN=mail.contoso.com
- C=US,O=Contoso,CN=mail.contoso.com
- C=US,CN=mail.contoso.com
このパラメーターを使用しない場合、既定値はコマンドを実行する Exchange サーバーの名前です (CN=Mailbox01 など)。
サブジェクトの別名 (SAN) 証明書の場合、DomainName パラメーターから、SubjectName 値で使用するいずれかの値を選ぶ必要があります。 実際、SubjectName に指定する CN 値は、DomainName 値に自動的に含まれます。
ワイルドカード証明書の場合、ワイルドカード文字 (*) が含まれる SubjectName 値を使用します。 たとえば、C=US,CN=*.contoso.com などです。
パラメーターのプロパティ
| 型: | X500DistinguishedName |
| 規定値: | 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 |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。