Undo コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) の undo コマンドは、ファイルまたはフォルダーに対する保留中の変更を1つ以上破棄します。
前提条件
既定では、プロジェクトの共同作成者グループのメンバーには、リポジトリに投稿し、自分のワークスペースで undo コマンドを使用するためのアクセス許可があります。 別のユーザーのワークスペースで保留中の変更を元に戻すには、[Administer workspaces](ワークスペースの管理) アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。
構文
tf undo [/workspace:<workspace-name>[;<workspace-owner>]]
[/recursive] <item-specification> [/noprompt] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>]
Parameters
パラメーター
説明
/collection:<team-project-collection-url>
対象項目を含むプロジェクト コレクションの URL を指定します (例: https://myserver:8080/tfs/DefaultCollection)。
/workspace オプションを使用しない場合、現在のディレクトリをマップするワークスペースを含むプロジェクト コレクションが既定で使用されます。
<item-specification>
項目の範囲を指定します。 複数の <item-specification> 引数を指定できます。 構文については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
/login
コマンドを実行するために使用されるユーザー アカウントを指定します。 「Team Foundation バージョン管理コマンドの使用」を参照してください。
/noprompt
ウィンドウとダイアログ ボックスが表示されなくなり、出力データがコマンド プロンプトにリダイレクトされます。 「Team Foundation バージョン管理コマンドの使用」を参照してください。
/recursive
指定したディレクトリおよびサブディレクトリ内の項目に対する変更を再帰的に元に戻します。
/workspace <workspace-name>[;<workspace-owner>]
保留中の変更を元に戻すワークスペースの名前を指定します。 指定しない場合、現在のディレクトリをマップするワークスペースが使用されます。
<workspace-owner> を指定すると、特定のユーザーに属するワークスペース内の保留中の変更を元に戻すことができます。 この引数を指定しない場合、現在のユーザーが所有するワークスペースが既定で使用されます。 ただし、/loginにユーザー名を指定すると、そのユーザーが所有するワークスペースが使用されます。 別のユーザーのワークスペースの変更を元に戻すには、[UndoOther] アクセス許可が [許可] に設定されている必要があります。
注意
undo コマンドを使用すると、まだ使用されているリモート ワークスペースの保留中の変更を元に戻すことができます。 そのワークスペースで作業を続行する前に、ユーザーはワークスペースをホストするマシンにサインインし、元に戻す操作の影響を受ける項目を取得する必要があります。 get コマンドとその /all 引数の詳細については、「Get コマンド」を参照してください。
解説
undo コマンドは、保留中の編集の変更がある項目ごとに、そのファイルがディスク上で変更されているかどうかを判断します。 ファイルが変更され、/noprompt オプションが指定されていない場合は、システムによって処理を進めることを確認するダイアログが表示されます。 キーボードで、次を選択します。
- 変更をそのままにしておく場合は N。
- 現在の変更のみ処理を進める場合は Y。
- このファイルと、検出されたその他の変更ファイルの処理を進める場合は A。
undo コマンドは、指定された項目に対するロックをすべて削除します。
例
次のコマンドは、program.cs ファイルに対する保留中の変更を削除します。
c:\code\SiteApp\Main\SolutionA\Project1>tf undo program.cs
次のコマンドは、c:\code\SiteApp\Main フォルダーとそのサブフォルダー内のすべての項目に対する保留中の変更を削除します。
c:\code\SiteApp\Main>tf undo * /recursive
次のコマンドは、指定されたコレクションとリモート ワークスペース内の program.cs ファイルに対する保留中の変更を削除します。
c:\>tf undo /collection:https://fabrikam-3:8080/tfs/DefaultCollection
/workspace:FABRIKAM-1;PatI $/SiteApp/Main/SolutionA/Project1/program.cs
ヒント
- 現在のワークスペースまたはリモート ワークスペースで保留中の変更の一覧を表示するには、
statusコマンドを使用します。 詳細については、「Status コマンド」を参照してください。 /workspaceオプションと必要に応じて/collectionオプションを使用して、リモート開発マシンの変更を元に戻すことができます。 この機能は、ファイルがチェックアウトされており、アクセスできない開発マシン上でロックされている可能性がある場合に特に有効です。 詳細については、この記事の前半の/workspace引数の説明を参照してください。- たとえば、より緊急性の高いタスクによって作業が中断された場合など、ワークスペースをクリーンする必要がある場合があります。 保留中の変更を元に戻すのではなく保持したい場合は、
shelveコマンドを使用して変更を中断できます。 詳細については、「Shelve コマンド」を参照してください。 開いているウィンドウ、ブレークポイント、およびその他の重要な手掛かりの位置を保持することもできます。詳細については、「作業の中断とシェルブセットの管理」を参照してください。 - 保留中の変更を元に戻す以外に、既にチェックインされている変更を破棄することもできます。 詳細については、「Undelete コマンド」および「Rollback コマンド (Team Foundation バージョン管理)」を参照してください。