Profile コマンド

profile コマンドを使用すると、名前付きのログイン プロファイルを作成、コピー、更新、および削除できます。 ログイン プロファイルは、Visual Studio Team Foundation Server のインスタンスへの接続に使用されます。 コンピューター上に作成したプロファイルは、そのコンピューター上でのみアクセスでき、Team Explorer Everywhere のすべてのクライアントで使用できます。

ログイン プロファイルは、他のコマンドを実行するときに指定できます。 詳細については、「Using a Profile」を参照してください。

必要なアクセス許可

Team Foundation Server のアクセス許可は不要です。プロファイルはすべて、Team Foundation Server のプラットフォーム間のコマンド ライン クライアントを実行するコンピューターのローカル、つまり、ホーム ディレクトリに保存されています。

tf profile -copy ExistingProfileName  NewProfileName

tf profile -delete ProfileName

tf profile -edit [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=[Number...]] ExistingProfileName

tf profile -new [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=Number]...]  NewProfileName

パラメーター

解説

すべてのプロファイルには、Team Foundation Server プロジェクトを指定する URL が含まれます。 Visual Studio Team Foundation Server 2010 のインスタンスに接続する場合、URL はチーム プロジェクト コレクションも指定します。 プロファイルには、ユーザー資格情報やネットワーク プロキシの設定など、他の接続情報も格納できます。

最も一般的なプロファイル プロパティを次の表に示します。

プロファイルの一部として 2 つのプロキシを指定できます。 1 つ目は、httpProxyEnabled=true を指定すると有効になり、Team Foundation Server のインスタンスへの接続に使用されるプロキシを定義します。 2 つ目は、tfProxyEnabled=true を指定すると有効になり、Team Foundation バージョン管理からファイルをダウンロードするときに使用されるプロキシを指定します。

profiles コマンドを使用すると、ローカル コンピューター上のプロファイルに関する情報を表示できます。 詳細については、「Profiles コマンド」を参照してください。

例

プロファイルを MyProfile という名前の新しいプロファイルにコピーする例を次に示します。

tf profile -copy http://tfs01.xyz.example.com MyProfile

MyProfile という名前のプロファイルを更新して httpProxy を無効にする例を次に示します。

tf profile -edit MyProfile -boolean:httpProxyEnabled=false

tfProxyUrl プロパティをクリアする例を次に示します。

tf profile -edit MyProfile -string:tfProxyUrl=

MyProxyProfile という名前の複雑なプロファイルを作成する例を次に示します。 この例は、読みやすくするために、数行に折り返して表示しています。

tf profile -new MyProxyProfile \
    -string:serverUrl=http://tfs01.xyz.example.com \
    -string:userName=john \
    -string:userDomain=company \
    -string:password="Se^%cret1" \
    -boolean:httpProxyEnabled=true \
    -string:httpProxyUrl=http://proxy01.xyz.example.com \
    -boolean:httpProxyEnableAuth=true \
    -string:httpProxyUsername=john \
    -string:httpProxyPassword="Pr8xyP&^ss" \
    -boolean:tfProxyEnabled=true \
    -string:tfProxyUrl=http://tfproxy01.xyz.example.com \
    -boolean:acceptUntrustedCertificates=true

MyProfile という名前のプロファイルを削除する例を次に示します。

tf profile -delete MyProfile

プロファイルの使用

Team Foundation Server のプラットフォーム間のコマンド ライン クライアントでプロファイルを使用するには、コマンドの実行時に /profile オプションを使用してプロファイルの名前を指定します。 たとえば、workspace コマンドの実行時に john@tfs01 プロファイルを使用するには、次のコマンド ラインを指定します。

tf -profile:john@tfs01 -workspaces

参照

その他の技術情報

コマンド ライン リファレンス (Team Explorer Everywhere)