次の方法で共有

[ワークスペース] コマンド (Team Foundation のバージョン管理)

  • [アーティクル]

Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation Version Control (TFVC) workspaces コマンドは、システム内のワークスペースに関する情報を表示し、Azure DevOps サーバー上のユーザー名またはコンピューター名の変更に関するキャッシュされた情報を更新します。

前提 条件

コマンドを使用するには、読み取り アクセス許可を [許可に設定します。 詳細については、「既定の 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 コマンドの引数とオプションについて説明します。

引数

引数の

説明

<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 オプションに値を提供します。

オプション

オプションの

説明

/owner

ワークスペースを作成したユーザーの名前を指定します。 所有者が指定されていない場合、TFVC は現在のユーザーのみが所有するワークスペースに関する情報を返します。

/computer

サーバーのワークスペースの一覧をフィルター処理するクライアント コンピューターの名前を指定します。 コンピューターが指定されていない場合、TFVC は現在のコンピューター上のワークスペースに関する情報のみを返します。

/format

ワークスペース情報の形式を指定します。 Brief は、マッピングなしでワークスペース情報を返します。 Detailed は、ワークスペース情報とマッピングも返します。 Xml は、ワークスペース情報、マッピング、最新のアクセス日、および所有者エイリアスも返します。 詳細形式は、/collection オプションが指定されている場合にのみ使用できます。 Brief が既定値です。

/updateUserName

ネットワーク ユーザー名が変更されたユーザーの Azure DevOps サーバーのセキュリティ ID 情報を更新します。 このオプションを指定する場合は、/collection オプションを使用してプロジェクト コレクションも指定する必要があります。

/updateComputerName

クライアント コンピューターの名前の変更を反映するようにテーブルを更新するように TFVC に指示します。 このオプションを指定する場合は、/collection オプションを使用してプロジェクト コレクションも指定する必要があります。

/remove

指定したプロジェクト コレクションの指定したワークスペース エントリをクライアント キャッシュから削除します。

/collection

プロジェクト コレクションを指定します。

/login

Azure DevOps Server でユーザーを認証するためのユーザー名とパスワードを指定します。

備考

コマンド ライン ユーティリティの コマンドは、指定したユーザーが所有している現在のコンピューター、または特定の 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