Get-ExchangeCertificate

Get-ExchangeCertificate
    [[-Identity] <ExchangeCertificateIdParameter>]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [<CommonParameters>]

Get-ExchangeCertificate
    [-Instance <X509Certificate2>]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Server <ServerIdParameter>]
    [<CommonParameters>]

Get-ExchangeCertificate
    [[-Thumbprint] <String>]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Server <ServerIdParameter>]
    [<CommonParameters>]

既定では、このコマンドレットは要約リストに表示される次の証明書のプロパティを返します。

• Thumbprint: 証明書データの一意のダイジェスト。 拇印値の例は 78E1BE82F683EE6D8CB9B9266FC1185AE0890C41 です。
• Services: Enable-ExchangeCertificate コマンドレットを使用して証明書を割り当てた Exchange サービス。 値は None、Federation、IIS、IMAP、POP、SMTP、UM、UMCallRouter です。 Exchange で使用されていない証明書 (IIS Web 管理サービスに使用される WMSvc-<ServerName> 証明書など) に値 None が表示されます。
• Subject: 証明書のサブジェクト名フィールドには X.500 の値が含まれます。 重要な部分は、CN= 値です。

コマンドに | Format-List を追加すると、コマンドレットは次の追加の証明書のプロパティを返します。

• AccessRules: 通常、この値は、値 System.Security.AccessControl.CryptoKeyAccessRule の複数のインスタンスをコンマで区切ります。
• CertificateDomains: 証明書のサブジェクトの別名フィールドのホスト名または FQDN です。
• HasPrivateKey: 証明書に秘密キーが含まれているかどうか。
• IsSelfSigned: 証明書に自己署名があるかどうか (証明機関によって発行されていない)。
• Issuer: 証明書の発行元。
• NotAfter: 証明書の有効期限。
• NotBefore: 証明書の発行日。
• PublicKeySize: パブリック キーのサイズ (バイト単位)。
• RootCAType: 証明書に署名した CA の種類。 値は None (この値は Microsoft Exchange Server Auth Certificate と、作成した新しい自己署名入りの証明書に表示されます)、ThirdParty、Enterprise、Registry (この値は自己署名入りの Exchange 証明書に表示されます)、GroupPolicy または Unknown (この値は保留中の証明書要求に表示されます) です。
• SerialNumber: 証明書の一意のシリアル番号。
• Status: 証明書の状態。 値は DateInvalid、Invalid、PendingRequest、RevocationCheckFailure、Revoked、Unknown、Untrusted または Valid です。

コマンドに | Format-List * を追加すると、コマンドレットは次の追加の証明書のプロパティを返します。

• Archived
• CertificateRequest: このプロパティには、証明書要求のハッシュ値が含まれます。
• DnsNameList
• EnhancedKeyUsageList: 通常、この値はサーバー認証 (1.3.6.1.5.5.7.3.1) です。
• Extensions
• FriendlyName
• Handle
• ID: この値では、ServerFQDN\Thumbprint という構文が使用されます。
• IISServices
• IssuerName: 通常、この値は System.Security.Cryptography.X509Certificates.X500DistinguishedName です。
• KeyIdentifier
• PrivateKey: 通常、この値は System.Security.Cryptography.RSACryptoServiceProvider です。
• PrivateKeyExportable: この値が True である場合、サーバーから証明書をエクスポートできます。
• PublicKey: 通常、この値は System.Security.Cryptography.RSACryptoServiceProvider です。
• RawData
• SendAsTrustedIssuer
• ServicesStringForm
• SignatureAlgorithm: 通常、この値は System.Security.Cryptography.Oid です。
• SubjectKeyIdentifier
• SubjectName: 通常、この値は System.Security.Cryptography.X509Certificates.X500DistinguishedName です。
• Version: 通常、この値は 3 です。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

Get-ExchangeCertificate -Server Mailbox01

この例では、Mailbox01 というサーバーのすべての Exchange 証明書と保留中の証明書要求の要約リストを返します。

Get-ExchangeCertificate -Thumbprint 0271A7F1CA9AD8A27152CCAE044F968F068B14B8 | Format-List

この例では、指定された証明書の詳細な情報を返します。

Get-ExchangeCertificate -Thumbprint 0271A7F1CA9AD8A27152CCAE044F968F068B14B8 | Format-List *

この例では、指定された証明書について取得可能なすべての情報を返します。

Get-ExchangeCertificate -DomainName mail.contoso.com

この例では、Exchange がドメイン名 mail.contoso.com に選択する証明書を示します。 送信コネクタまたは受信コネクタが、使用する証明書をコネクタの完全修飾ドメイン名 (FQDN) に基づいて選択します。 同じ FQDN を持つ複数の証明書がある場合は、DomainName パラメーターを使用して FQDN を指定することで、Exchange が選択する証明書を確認できます。 最初に返される証明書は、Exchange が選択する証明書です。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。