Import-CsCertificate
トピックの最終更新日: 2012-03-23
Microsoft Lync Server 2010 で使用する証明書をインポートします。Request-CsCertificate コマンドレットを使用しても証明書を取得できない場合、証明書を Lync Server 2010 のサーバーの役割に割り当てるには、この証明書をインポートする必要があります。
構文
Import-CsCertificate -Path <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Password <String>] [-PrivateKeyExportable <$true | $false>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
解説
Lync Server 2010 は、サーバーとサーバーの役割がそれぞれの ID を検証できるようにするために、証明書を使用します。たとえば、エッジ サーバー は、証明書を使用して、通信しているコンピューターが実際に フロントエンド サーバー であることを確認します。また、逆の場合も同様です。Lync Server を完全に実装するには、適切な証明書を適切なサーバーの役割に割り当てることが必要です。
証明書を Lync Server の役割に割り当てるには、これらの証明書が Lync Server で認識されている必要があります。Request-CsCertificate コマンドレットによって、新しい証明書要求をオンラインでもオフラインでも行うことができます。オンライン要求を行うと、証明書は自動的にダウンロードされてローカルの証明書ストアに保存されます。同じく重要となるのは、その証明書は Lync Server 2010 ですぐ使用できるようになることです。オフライン要求を行うと、証明書ファイルが送信されてきます。その時点で、Import-CsCertificate を使用して証明書をインポートできます。このプロセスにより、証明書を Lync Server のサーバーの役割に割り当てることができます。
このコマンドレットを実行できるユーザー: Import-CsCertificate コマンドレットをローカルで実行するため、ローカル管理者である必要があります。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsCertificate"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Path |
必須 |
文字列 |
インポートする証明書ファイルの完全なパスです。次に例を示します。–Path "C:\Certificates\WebServer.cer" |
Password |
省略可能 |
文字列 |
証明書ファイルに関連付けられているパスワードです。 |
PrivateKeyExportable |
省略可能 |
ブール値 |
True に設定されている場合は、ネットワーク サービス アカウントで証明書の秘密キーの部分を読み取ることができます。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
Report |
省略可能 |
文字列 |
コマンドレット実行時に作成されるログ ファイルのファイル パスを指定できるようにします。次に例を示します。-Report "C:\Logs\Certificates.html" |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。Import-CsCertificate は、パイプ処理による入力を受け入れません。
戻り値の種類
なし。
例
-------------------------- 例 1 ------------------------
Import-CsCertificate -Path "C:\Certificates\WebServer.cer" -PrivateKeyExportable $True
例 1 のコマンドでは、C:\Certificates\WebServer.cer という証明書をインポートします。コマンドが完了すると、証明書をサーバーの役割に割り当てることができるようになります。