Workspace コマンド
ワークスペースに関連するプロパティおよびマッピングを作成、削除、表示、または変更できます。
必要なアクセス許可
既存のワークスペースを変更または削除するには、所有者であるか、グローバルな [ワークスペースの管理] アクセス許可が [許可] に設定されている必要があります。 ワークスペースを作成するには、グローバルな [ワークスペースの作成] のアクセス許可が [許可] に設定されている必要があります。 他のユーザーのワークスペースを作成するには、[ワークスペースの管理] のアクセス許可が [許可] に設定されている必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:("comment"|@comment file)]
[/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]
tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]
tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]
パラメーター
引数 |
説明 |
|---|---|
workspacename |
作成、編集、削除、または情報を表示するワークスペースの名前を指定します。 |
workspaceowner |
ワークスペースのユーザー名を指定します。 このパラメーターは、コマンドを実行するユーザーがワークスペースの所有者でない場合に必要です。 |
computername |
/computer オプションに値を指定します。 |
comment |
/comment オプションに値を指定します。 |
@commentfile |
コメントを格納するファイルのパスを指定します。 |
username |
/login オプションに値を指定します。 ユーザー名の値は、DOMAIN\UserName または UserName のいずれかとして指定できます。 |
TeamProjectCollectionUrl |
情報の作成、編集、削除、表示などの対象となるワークスペースを含むチーム プロジェクト コレクションの URL (http://myserver:8080/tfs/DefaultCollection など)。 |
ownername |
/newowner オプションに値を指定します。 |
オプション |
説明 |
|---|---|
/new |
新しいワークスペースを作成します。 |
/template |
新しいワークスペースを作成するテンプレートとして使用する既存のワークスペースを指定します。 新しいワークスペースでは、既存のワークスペース マッピングが使用されます。 |
/delete |
指定されたワークスペースを削除します。 |
/computer |
ワークスペースを作成するコンピューターの名前を指定します。 これは、高度なオプションです。 |
/comment |
ワークスペースについて説明するコメントを指定します。 |
/newname |
既存のワークスペースの名前を変更します。 |
/noprompt |
指定された workspace コマンドを、ダイアログ ボックスを表示せずに実行します。 |
/collection |
チーム プロジェクト コレクションを指定します。 |
/permission |
ワークスペースのアクセス許可のオプションを指定します。
|
/login |
Visual Studio Team Foundation Server でユーザーを認証するためのユーザー名とパスワードを指定します。 |
/newowner |
ワークスペースの新しい所有者のユーザー名を指定します。 |
解説
ワークスペースは、サーバー上のファイルとフォルダー、およびローカルで加えたあらゆる変更内容をローカルにコピーしたものです。 追加、編集、削除、移動、名前変更を行うか、バージョン管理される項目を変更した場合、変更を追加およびテスト可能なワークスペース内で変更内容が分離されます。 保留中の変更はサーバーにコミットされ、チェックインを実行するとワークスペース外の他のユーザーが使用可能になります。
tf コマンド ライン ユーティリティの使い方の詳細については、「Tf コマンド ライン ユーティリティのコマンド」を参照してください。
ワークスペースの作成
バージョン管理サーバーにファイルを追加したり、サーバー上の項目をチェックアウトして編集したりするには、ワークスペースを作成するか、既存のワークスペースを現在のディレクトリに関連付ける必要があります。 詳細については、「ワークスペースの作成とファイルの取得」を参照してください。
現在のディレクトリをコンピューター上の既存のワークスペースの作業フォルダーにするには、「tf workspace workspacename」と入力します。workspacename は既存のワークスペースの名前です。 [ワークスペースの編集] ダイアログ ボックスが表示されます。 [新しい作業フォルダーを入力するには、ここをクリックします] をクリックし、[ソース管理フォルダー] ボックスに現在のディレクトリを割り当てるサーバー パスを入力して、[ローカル フォルダー] ボックスに現在のディレクトリを入力します。次に、[OK] をクリックします。
新しいワークスペースを作成する際、/new オプションの一部としてテンプレート ワークスペースを指定できます。 テンプレート ワークスペースを指定すると、Team Foundation により新しいワークスペースが現在のコンピューターに作成され、所有者が現在の所有者に設定されます。さらに、属性 (マッピングとコメント) がテンプレート ワークスペースから新しいワークスペースにレプリケートされます。 名前を指定しない場合、現在のコンピューター名に基づく名前が使用されます。 テンプレートを使用してワークスペースを作成すると、Team Foundation は、割り当て対象のファイルをサーバーから取得しません。 新しいワークスペースを、サーバー上の最新バージョンと同期するには、Get コマンド を使用します。
1 レベルのフォルダー マッピング
ローカル ワークスペースにマップするように選択できるのは、バージョン管理フォルダーの直接の子に限定されます。 この操作を行うには、[ワークスペースの追加] ダイアログ ボックスの [ソース管理フォルダー] ボックスにアスタリスク (*) ワイルドカード文字を追加します。 たとえば、$/folder/* のように入力します。 この操作を行わないと、既定で、バージョン管理フォルダーのすべての子がローカル ワークスペースに対して再帰的にマップされます。
バージョン管理の階層内の 1 つ下にあるレベルのみを対象にフォルダー マッピングを行う機能を使うと便利です。この機能により、クライアント コンピューターにダウンロードされる項目の数が制限されます。 また、ダウンロードするファイルの数を制限する別の方法として、ファイルのクローク設定を行う方法が挙げられます。これにより、ワークスペース内にファイルを格納する必要がなくなります。 詳細については、「ワークスペースでのフォルダーのクロークまたはクローク解除」を参照してください。 この方法を採用すると、ダウンロード時間を短縮し、クライアント コンピューター上のディスク容量を節約できます。
ワークスペースの削除
保留中の変更を含むワークスペースを削除した場合、Team Foundation により削除処理の一部として保留中の変更が取り消されます。 ワークスペースを削除しても、そのワークスペース内にあったクライアント コンピューター上のファイルとフォルダーは削除されません。
ワークスペースの編集
ワークスペースの次の属性を変更できます。
ワークスペース名
コメント
作業フォルダー マッピング
ワークスペースの指定がない場合、現在のフォルダーのワークスペースが使用されます。
例
次の例は、[ワークスペースの追加] ダイアログ ボックスを表示して新しいワークスペースを作成します。 [ワークスペースの追加] ダイアログ ボックスでは、ソース管理フォルダー、所有者、コンピューター、コメント、およびローカル フォルダーを編集できます。
c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection
次の例は、Beta1 という新しいワークスペースを作成し、ワークスペースの所有者として jenh を割り当てます。 新しいワークスペースの所有権を別のユーザーに割り当てるには、AdminWorkspaces アクセス許可が必要です。 セキュリティ アクセス許可の詳細については、「Team Foundation Server のアクセス許可」を参照してください。
c:\projects>tf workspace /new Beta1;jenh
次の例は、jenh が所有している Beta1 ワークスペースをテンプレートとして使用して新しいワークスペースを作成します。
c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://myserver:8080/tfs/DefaultCollection
次の例は、Beta1 ワークスペースをサーバーから削除します。
c:\projects>tf workspace /delete Beta1
次の例は、現在のワークスペースのプロパティを編集します。
c:\projects>tf workspace
次の例は、ユーザー jenh が所有者となっている Beta1 ワークスペースを開き、そのプロパティとマッピングを参照します。 AdminWorkspaces アクセス許可を持っている場合、ワークスペースのプロパティとマッピングを変更できます。
c:\projects> tf workspace Beta1;jenh