[ワークスペース] コマンド (Team Foundation のバージョン管理)
Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation Version Control (TFVC) workspace コマンドを使用すると、ワークスペースに関連付けられているプロパティとマッピングを作成、削除、表示、または変更できます。
前提 条件
- 既存のワークスペースを変更または削除するには、所有者であるか、グローバル [ワークスペースの管理] アクセス許可 [を許可] に設定します。
- ワークスペースを作成するには、グローバル ワークスペースの作成 アクセス許可 [を許可] に設定します。
- 他のユーザーのワークスペースを作成するには、[
ワークスペースの管理] アクセス許可を [の許可]設定します。
詳細については、「既定の TFVC アクセス許可 」を参照してください。
構文
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
パラメーター
以降のセクションでは、workspace コマンドの引数とオプションについて説明します。
引数
| 引数 | 形容 |
|---|---|
<workspace-name> |
情報を作成、編集、削除、または表示するワークスペースの名前を指定します。 |
<workspace-owner> |
ワークスペースのユーザー名を指定します。 このパラメーターは、ワークスペース所有者がコマンドを実行しているユーザーでない場合に必要です。 |
<computer-name> |
/computer オプションに値を提供します。 |
<comment> |
/comment オプションに値を提供します。 |
@<comment-file> |
コメントを読み取るファイルのパスを指定します。 |
<username> |
/login オプションに値を提供します。 この値は、DOMAIN\<username> または <username>として指定できます。 |
<password> |
/login オプションに値を提供します。 |
<team-project-collection-url> |
https://myserver:8080/tfs/DefaultCollectionなど、作成、編集、削除、または表示する情報を含むプロジェクト コレクションの URL。 |
<owner-name> |
/newowner オプションに値を提供します。 |
オプション
| オプション | 形容 |
|---|---|
/new |
新しいワークスペースを作成します。 |
/template |
新しいワークスペースを作成するためのテンプレートとして使用する既存のワークスペースを指定します。 新しいワークスペースでは、既存のワークスペースのマッピングが使用されます。 |
/delete |
指定したワークスペースを削除します。 |
/computer |
ワークスペースを作成するコンピューターの名前を指定します。 このオプションは高度なオプションです。 |
/comment |
ワークスペースについて説明するコメントを提供します。 |
/newname |
既存のワークスペースの名前を変更します。 |
/noprompt |
ダイアログ ボックスを表示せずに、指定したワークスペース コマンドを実行します。 |
/collection |
プロジェクト コレクションを指定します。 |
/permission |
ワークスペースのアクセス許可のオプションを指定します。
Private: ワークスペースを使用、チェックイン、または管理できるのは所有者だけです。
- Public Limited: 任意の有効なユーザーがワークスペースを使用できます。 ただし、ワークスペースに対してファイルをチェックインまたは管理できるのは所有者だけです。
- Public: 有効なユーザーは、ワークスペースを使用、チェックイン、または管理できます。 |
/location |
ワークスペースを作成する場所を指定します。
local: クライアント コンピューター上。 この値が既定値です。
- server: Azure DevOps サーバー上。 |
/login |
Azure DevOps でユーザーを認証するためのユーザー名とパスワードを指定します。 |
/newowner |
ワークスペースの新しい所有者のユーザー名を指定します。 |
備考
ワークスペース は、サーバー上のファイルとフォルダーのローカル コピーと、ローカルで行った変更です。 バージョン管理された項目を追加、編集、削除、移動、名前変更、または変更すると、変更はワークスペースに分離され、変更を行ってテストできます。 チームのコードベースに作業をチェックイン
tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンド使用する」を参照してください。
ワークスペースを作成する
バージョン 管理サーバーにファイルを追加したり、サーバー上の項目をチェックアウトしたりする前に、ワークスペースを作成するか、既存のワークスペースを現在のディレクトリに関連付ける必要があります。 詳細については、「開発用コンピューター での Team Foundation バージョン管理のセットアップ」を参照してください。
現在のディレクトリをコンピューター上の既存のワークスペースの作業フォルダーにするには、次の手順に従います。
- 「
tf workspace <workspace-name>」と入力します。ここで、<workspace-name>は既存のワークスペースの名前です。 [ワークスペース の編集] ダイアログ ボックスが表示されます。 - クリックして、新しい作業フォルダーを入力します。
- [ソース管理フォルダーの
] ボックスに、現在のディレクトリをマップするサーバー パスを入力します。 - [ローカル フォルダー] ボックスに、現在のディレクトリを入力します。
- [OK]
選択します。
新しいワークスペースを作成するときに、/new オプションの一部として テンプレート ワークスペース を指定できます。 テンプレート ワークスペースを指定すると、TFVC は現在のコンピューターに新しいワークスペースを作成します。 TFVC は、所有者を現在の所有者に設定し、次のワークスペース プロパティをテンプレート ワークスペースから新しいワークスペースにレプリケートします。mappings と comment。 名前が指定されていない場合、システムは現在のコンピューター名に基づく名前を使用します。 テンプレートを使用してワークスペースを作成する場合、TFVC はサーバーからマップされるファイルを取得しません。
get コマンドを使用して、新しいワークスペースをサーバー上の最新バージョンと同期します。 詳細については、「get コマンド
単一フォルダーのマッピング
バージョン コントロール フォルダーの直下の子のみをローカル ワークスペースにマップするように選択できます。 これを行うには、[ワークスペースの追加] ダイアログ ボックスの [ソース管理フォルダー] ボックスにアスタリスク (*) ワイルドカード文字を追加します (例: $/folder/*)。 それ以外の場合、既定では、バージョン 管理フォルダーのすべての子がローカル ワークスペースに再帰的にマップされます。
バージョン コントロール階層内の単一フォルダー マッピングは、クライアント コンピューターにダウンロードされる項目の数が制限されるため便利です。 ダウンロードしたファイルを制限するもう 1 つの方法は、ワークスペースに必要のないファイルをクロークすることです。 詳細については、「ワークスペース
ワークスペースを削除する
保留中の変更を含むワークスペースを削除すると、TFVC は削除プロセスの一環として保留中の変更を取り消します。 ワークスペースを削除しても、そのワークスペースに存在していたクライアント コンピューター上のファイルとフォルダーは削除されません。
手記
手動で実行するコマンドでは、ユーザーの受信確認をバイパスするために /noprompt オプションが必要です。 PowerShell Start() メソッドを使用してコマンドを実行する場合は注意してください。
/noprompt オプションは、PowerShell で自動的に設定できます。
ワークスペースを削除するときは、<workspace-owner> と <workspace-name> を指定する必要があります
workspace コマンドを使用して、これらの値を取得できます。 詳細については、「workspaces コマンド」を参照してください。
<workspace-owner> 値を見つけるには、次のコマンドを実行します。
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
<workspace-name> 値を見つけるには、前のコマンドの出力の <OwnerId> 値を <workspace-owner> 値として使用します。 この値の形式は、Azure Active Directory (Azure AD) オブジェクト ID の後に円記号とユーザー プリンシパル名が続きます。 値全体を使用します。 次に、次のコマンドを実行します。
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
ワークスペースを削除するには、次のコマンドを実行します。
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
ワークスペースを編集する
次のワークスペース属性を変更できます。
- ワークスペース名
- コメント
- 作業フォルダーのマッピング
ワークスペースの仕様が指定されていない場合は、現在のフォルダーのワークスペースが使用されます。
例
次の例では、[ワークスペースの追加] ダイアログ ボックスを開き、新しいワークスペースを作成します。 [ワークスペース の追加
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
次の例では、
c:\projects>tf workspace /new Beta1;jenh
次の例では、jenh がテンプレートとして所有する
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
次の例では、Beta1 ワークスペースをサーバーから削除します。
c:\projects>tf workspace /delete Beta1
次の例では、現在のワークスペースのプロパティを編集します。
c:\projects>tf workspace
次の例では、jenh が所有する
c:\projects> tf workspaces Beta1;jenh