Shelvesets コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) の shelvesets コマンドを使用して、シェルブされた一連の変更に関する情報を表示します。
前提条件
shelvesets コマンドを使用するには、シェルブセット内の項目に対して、[読み取り] アクセス許可と [チェックアウト] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。
構文
tf shelvesets [/owner:ownername] [/format:(brief|detailed)] [/collection:TeamProjectCollectionUrl]] [/login:username,[password]] shelvesetname
パラメーター
引数
| Argument | 説明 |
|---|---|
<ownername> |
/owner オプションには * や DOMAIN\username などの値を指定します。 |
<shelvesetname> |
シェルブセットの名前。 |
<TeamProjectCollectionUrl> |
情報を表示する、一連のシェルブされた変更を含むプロジェクト コレクションの URL (例: http://myserver:8080/tfs/DefaultCollection)。 |
<username> |
/login オプションに値を指定します。 ユーザー名の値は、DOMAIN\username または username として指定できます。 |
Options
| オプション | 説明 |
|---|---|
/owner |
シェルブセットの所有者を 1 つ以上指定します。 ワイルドカード文字を使用できます。 |
/format |
シェルブセット情報を表示するときの形式の種類を指定します。Brief を指定すると、シェルブセットの名前、それを作成したユーザーの名前、シェルブセットのコメント (存在する場合) が表示されます。 Detailed を指定すると、関連する作業項目とチェックイン メモの一覧に加えて、シェルブセットの名前、所有者、コメントが表示されます。 既定値は Brief です。 |
/collection |
プロジェクト コレクションを指定します。 |
/login |
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。 |
解説
シェルブセットは Shelve コマンドによって作成されます。 シェルブセットは Azure DevOps サーバーに保存され、十分なアクセス許可を持つすべてのユーザーが Unshelve コマンドを使用してワークスペースに取得できます。
変更セットとは異なり、シェルブセットはバージョンなしのエンティティです。 ご自身または他のユーザーがシェルブセット内の項目をアンシェルブし、ファイルをいくつか編集し、シェルブセットを再シェルブした場合、TFVC では後で比較するために新しいバージョンの項目を作成しません。 誰がいつ、どのように項目を改訂したかの記録は、TFVC に保持されません。 一連の保留中の変更をシェルブするかチェックインするかの決定の詳細、およびシェルブの一般的な概要については、シェルブセットの操作に関する記事を参照してください。
特定のシェルブセット内の個々のソース ファイルのリビジョンの詳細を確認するには、/shelveset オプションを指定して Status コマンド を使用します。
ワークスペースに項目をアンシェルブせずに、シェルブされたリビジョンをその基本シェルブセット バージョンと比較できます。 この機能を使用すると、簡単なピア コード レビューを行うことができます。
tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
例
次の例では、現在のディレクトリがマップされている Azure DevOps サーバーの BuddyTest_23 シェルブセットに関する情報を表示します。
c:\projects>tf shelvesets BuddyTest_23
次の例では、Pat が 所有するシェルブセットの一覧を表示します。
c:\projects>tf shelvesets /owner:Pat
次の例では、現在のディレクトリがマップされている Azure DevOps サーバー上のすべてのシェルブセットに関する情報を表示します。
c:\projects>tf shelvesets /owner:*