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