Status コマンド

  • [アーティクル]

1 つ以上のワークスペース内のファイルおよびフォルダーへの保留中の変更に関する情報を表示します。 また、/shelveset オプションを使用すると、シェルブセット内の保留中の変更に関する情報を表示します。

要件: 「Team Foundation Server のアクセス許可の参照」を参照してください。

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

パラメーター

引数

説明

/collection: TeamProjectCollectionUrl

/workspace オプションを使用するときは、保留中の変更のあるワークスペースを含むチーム プロジェクト コレクションの URL を指定します。 たとえば、「http://myserver:8080/tfs/DefaultCollection」を指定します。 それを指定しない場合、既定では、チーム プロジェクト コレクションは現在のディレクトリをマップするワークスペースを含むコレクションであると見なされます。

/workspace オプションを使用しない場合には無視されます。

注意

このオプションの制限については、下記の解説を参照してください。

/format

それぞれの保留中の変更に関して、どれほど詳しく表示するかを指定します。

  • Brief (既定): それぞれの保留中の変更を 1 行で表示します。それに含まれるのは、ファイル名、変更内容、項目がロックされている (アスタリスク (*) で示される) かどうか、ローカル パス、およびユーザー (/collection および /workspace オプションを使用している場合) です。 データによっては切り捨てられる場合があります。

  • Detailed: それぞれの保留中の変更セットについて、すべての説明が表示されます。 上記の情報に加えて、このオプションでは日時やロックなどの追加情報が表示されます。

itemspec

保留中の変更データの対象となる項目を指定します。 構文については、「Team Foundation バージョン管理のコマンド リファレンス」を参照してください。 複数の itemspec 引数を指定できます。

/login

コマンドを実行するために使用されるユーザー アカウントを指定します。 「Team Foundation バージョン管理のコマンド リファレンス」を参照してください。

/recursive

指定されたディレクトリとすべてのサブディレクトリ内で、項目への保留中の変更に関するデータを再帰的に取得します。

/shelveset:shelvesetname[;shelvesetowner]

リストにする変更を含むシェルブセットを指定します。

このオプションは、/workspace オプションと組み合わせることはできません。

/user

指定されたユーザーが行なったすべての保留中の変更の一覧を示します。 アスタリスク (*) を指定すると、すべてのユーザーによる変更が表示されます。 既定値は現在のユーザーです。

注意

このオプションの制限については、下記の解説を参照してください。

/workspace:workspacename[;workspaceowner]

保留中の変更を含むワークスペースの名前を指定します。 指定なしの場合には、現在のディレクトリをマップするワークスペースになります。

特定のユーザーに属するワークスペース内の保留中の変更に関するデータを取得するため、workspaceowner を指定することができます。 指定なしの場合、ワークスペースは現在のユーザーに想定され、指定される場合には、/login:username が想定されます。

このオプションは、/shelveset オプションと組み合わせることはできません。

注意

このオプションの制限については、下記の解説を参照してください。

解説

ローカル ワークスペースであるか、サーバー ワークスペースであるかにかかわらず、Status コマンドを使用することにより、現在のワークスペース (たとえば、コマンド プロンプト ウィンドウで現在のディレクトリをマップするワークスペース) における保留中の変更を表示できます。 このコマンドを使用して、リモート サーバー ワークスペースにおける保留中の変更 (たとえば、他の開発用コンピューター上で他のユーザーによってなされる変更) を表示することもできます。そのためには、/collection、/user、および /workspace オプションを使用します。 ただし、リモート ローカル ワークスペースにおける保留中の変更は表示できません。

「ローカル ワークスペースとサーバー ワークスペースのどちらを使用するかを決定する」も参照してください。

例

以下のすべての例では、$/SiteApp/Main/ がワークスペース内の c:\code\SiteApp\Main\ にマップされているとします。

現在のワークスペース内のすべての変更を一覧表示する

c:\code\SiteApp\Main\SolutionA\>tf stat

ワークスペース内のすべての保留中の変更を一覧表示します。

フォルダー内のすべての変更を一覧表示する

c:\code\SiteApp\Main>tf stat SolutionA\*

SolutionA フォルダー内のすべての項目に対するすべての保留中の変更を一覧表示します。

フォルダーとそのサブフォルダー内のすべての変更を一覧表示する

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

SolutionA フォルダー内のすべての項目 (そのサブフォルダー内の項目を含む) に対するすべての保留中の変更を一覧表示します。

Visual Studio での作業

ヒント