Certificates コマンド
Certificates コマンドを使用すると、HTTPS、SSL (Secure Sockets Layer)、および証明書を利用する Visual Studio Team Foundation Server の配置でのクライアント認証用に証明書を構成する方法を変更できます。 既定では、Certificates コマンドは、現在のユーザーの証明書一覧からクライアント証明書を自動的に選択します。 ただし、このコマンドのオプションを使用すると、現在のユーザー コンテキストまたはローカル コンピューターのコンテキストから特定の証明書を指定できます。
Certificates コマンドを使用する前に、まず、証明書を利用するように Team Foundation Server の配置内のサーバーを構成する必要があります。
必要なアクセス許可
Certificates コマンドを使用するには、コマンドを実行するコンピューターの Team Foundation 管理者セキュリティ グループおよびローカルの Administrators グループのメンバーである必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
注意
管理者の資格情報を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。 昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。
TFSConfig Certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
パラメーター
プレースホルダー |
説明 |
|---|---|
Thumbprint |
使用する証明書の SHA-1 ハッシュ形式で SHA (Secure Hash Algorithm) を含む 16 進文字列を指定します。 証明書のサムプリントを検索する方法の詳細については、Microsoft Web サイトの「方法: 証明書のサムプリントを取得する」を参照してください。 |
オプション |
説明 |
|---|---|
/machine |
証明書の一覧を、現在のユーザーのコンテキストではなく、ローカル コンピューターのコンテキストから取得するように指定します。 |
/disable |
クライアントの認証証明書の設定が無効になるように指定します。 |
/autoSelect |
証明書が証明書の一覧から自動的に選択されるように指定します。 [クライアント証明書の管理] ウィンドウは表示されません。 |
/noprompt |
Certificates コマンドが実行されたときに [クライアント証明書の管理] ウィンドウが表示されないように指定します。 |
/thumbprints:thumbprint |
指定したサムプリントと一致する証明書が使用されるように指定します。 複数の証明書は、個々のサムプリントをコンマで区切って指定できます。 |
解説
HTTPS/SSL および証明書を使用するように構成された Team Foundation Server の配置で使用されるクライアント証明書を構成するには、Certificates コマンドを使用します。 オプションを指定せずに Certificates コマンドを使用すると、クライアント証明書は、コマンドを実行する現在のユーザー コンテキストから自動的に選択されます。
使用例
プロンプトを表示せずに "aa bb cc dd ee" というサムプリントを含むローカル コンピューター証明書を指定する方法を次の例に示します。
注意
例として登場する企業、組織、製品、ドメイン名、電子メール アドレス、ロゴ、人物、場所、およびイベントはすべて架空のものです。実在する企業、組織、製品、ドメイン名、電子メール アドレス、ロゴ、人物、場所、またはイベントとは一切関係ありません。
TFSConfig Certificates /machine /thumbprint:aa bb cc dd ee /noprompt
現在のユーザー ストアからクライアント証明書の自動選択を使用するように指定する方法を次の例に示します。
TFSConfig Certificates /autoselect
参照
概念
Team Foundation Server のアーキテクチャ