Workspaces コマンド (Team Foundation バージョン管理)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation バージョン管理 (TFVC) workspaces コマンドを使用して、システム内のワークスペースに関する情報を表示し、Azure DevOps サーバー上のユーザー名またはコンピューター名の変更に関するキャッシュされた情報を更新します。
前提条件
workspaces コマンドを使用するには、[読み取り] アクセス許可が [許可] に設定されている必要があります。 詳細については、「既定の TFVC アクセス許可」を参照してください。
構文
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
パラメーター
以降のセクションでは、workspaces コマンドの引数とオプションについて説明します。
引数
Argument
説明
<owner-name>
/owner オプションに値を指定します。 どのユーザーによって作成されたワークスペースとも一致させるには、空の文字列 ("") を使用します。
<computer-name>
/computer オプションに値を指定します。 どのコンピューター上のワークスペースとも一致させるには、空の文字列 ("") を使用します。
<workspace-name>
情報を表示するワークスペースの名前を指定します。 値が指定されていない場合、サーバー内のすべてのワークスペースに関する情報が表示されます。 アスタリスク (*) ワイルドカード文字を使用して、サーバーのすべてのワークスペースに関する情報を表示することもできます。
<old-user-name>
/updateUserName オプションに対して以前のユーザー名を指定します。
<old-computer-name>
/updateComputerName オプションに対して以前のコンピューター名を指定します。
<team-project-collection-url>
情報を表示するワークスペースを含むプロジェクト コレクションの URL (例: https://myserver:8080/tfs/DefaultCollection)。
<username>
/login オプションに値を指定します。 この値は、DOMAIN\<username> または <username> として指定できます。
<password>
/login オプションに値を指定します。
Options
オプション
説明
/owner
ワークスペースを作成したユーザーの名前を指定します。 所有者が指定されない場合、TFVC では、現在のユーザーが所有するワークスペースのみに関する情報を返します。
/computer
サーバーのワークスペースの一覧のフィルター処理に使用するクライアント コンピューターの名前を指定します。 コンピューターが指定されない場合、TFVC では、現在のコンピューター上のワークスペースに関する情報のみを返します。
/format
ワークスペース情報の形式を指定します。 Brief を指定すると、マッピングなしのワークスペース情報が返されます。 Detailed を指定すると、ワークスペース情報と、さらにマッピングが返されます。 Xml を指定すると、ワークスペース情報、マッピング、最新のアクセス日、さらに所有者のエイリアスが返されます。 詳細形式は、/collection オプションが指定されている場合にのみ使用できます。 既定値は Brief です。
/updateUserName
ネットワーク ユーザー名が変更されたユーザーの、Azure DevOps サーバー上のセキュリティ ID 情報を更新します。 このオプションを指定する場合は、/collection オプションを使用してプロジェクト コレクションも指定する必要があります。
/updateComputerName
クライアント コンピューターの名前の変更を反映するようにテーブルを更新することを、TFVC に指示します。 このオプションを指定する場合は、/collection オプションを使用してプロジェクト コレクションも指定する必要があります。
/remove
指定されたプロジェクト コレクションの指定されたワークスペース エントリをクライアント キャッシュから削除します。
/collection
プロジェクト コレクションを指定します。
/login
Azure DevOps Server でユーザーを認証するためのユーザー名とパスワードを指定します。
解説
tf コマンドライン ユーティリティの workspaces コマンドを使用すると、現在のコンピューター上の、指定されたユーザーが所有するワークスペース、または特定の Azure DevOps サーバーに関連するすべてのワークスペースに関する情報が表示されます。 TFVC では、各ワークスペースの名前、所有者、コメント、コンピューター名を表示します。 詳細な出力では、ワークスペース マッピングも表示します。 所有者、コンピューター、ワークスペース名などのフィルターを指定しない限り、TFVC では、自分で作成したワークスペースに関する情報のみが表示されます。
ワークスペースのプロパティを編集する方法の詳細については、「Workspace コマンド」を参照してください。
tf コマンド ライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドの使用」を参照してください。
例
次の例では、現在のコンピューター上の現在のユーザーのすべてのワークスペースの一覧を表示します。
c:\projects>tf workspaces
次の例では、アドレス https://myserver:8080/tfs/DefaultCollection の次のプロジェクト コレクションで作成された、すべてのコンピューター上のすべてのユーザーのすべてのワークスペースの一覧を表示します。
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
次の例では、アドレス https://myserver:8080/tfs/DefaultCollection のプロジェクト コレクションで現在のユーザーが作成したすべてのワークスペースに関する詳細情報を表示します。
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
次の例では、現在のユーザーが所有し、現在のコンピューター上にある、ワークスペース WS1 に関する詳細情報を表示します。 表示される情報には、ワークスペース マッピングの一覧が含まれます。
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
次の例では、アドレス https://myserver:8080/tfs/DefaultCollection のプロジェクト コレクションで、キャッシュされたすべてのワークスペースをキャッシュから削除します。
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection