Status コマンド (Team Foundation バージョン管理)

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理 (TFVC) の status コマンドまたはその別名 statは、ファイルとフォルダーに対する保留中の変更と、1 つ以上のワークスペースの保留中の変更候補に関する情報を表示します。 /shelveset オプションを使用すると、このコマンドはシェルブセット内の保留中の変更に関する情報を表示します。

注意

保留中の変更候補は、バージョン管理に追加されていないワークスペースのフォルダーまたはサブフォルダー内のファイルです。 Visual Studio で保留中のすべての変更候補を表示するには、[チーム エクスプローラー]>[保留中の変更]>[除外される変更] に移動し、[検出済み] を選択します。

前提条件

status コマンドを使用するには、ソース アイテムの読み取りアクセス許可と、ターゲット フォルダーのチェックアウトおよびマージのアクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。

構文

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

パラメーター

引数

Argument

説明

/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

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

このオプションで使用できる値は次のとおりです。

  • <username>
  • <useraccount>
  • アスタリスク *

注意

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

/workspace:<workspacename>[;<workspaceowner>]

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

workspaceowner を指定して、特定のユーザーに属するワークスペース内の保留中の変更に関するデータを取得できます。 指定しないと、ワークスペースは現在のユーザー、指定されると、/login:<username> であるとみなされます。

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

注意

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

解説

ローカル ワークスペースであるか、サーバー ワークスペースであるかに関係なく、status コマンドを使用して、現在のワークスペース (たとえば、現在のディレクトリをマップするワークスペース) の保留中の変更を表示できます。 /collection、/user、および /workspace オプションを使用してこのコマンドを使用すると、リモート サーバー ワークスペースでの保留中の変更 (たとえば、別の開発マシン上で別のユーザーから加えられる変更) を表示することもできます。 ただし、リモート ローカル ワークスペースの保留中の変更は表示できません。

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

例

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

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

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

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

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

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

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

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

次の例は、"SolutionA" フォルダー内のすべてのアイテムに対する保留中の変更 (サブフォルダーの変更を含む) の一覧を示します。

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

次のステップ