Команда состояния (система управления версиями Team Foundation)

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Команда система управления версиями Team Foundation (TFVC) status или ее псевдоним statотображают сведения о ожидающих изменениях файлов и папок и ожидающих изменений в одной или нескольких рабочих областях. При использовании /shelveset параметра команда отображает сведения о ожидающих изменениях в наборе полок.

Примечание.

Кандидат от ожидающих изменений — это файл в папке рабочей области или вложенной папке, которая не добавляется в управление версиями. Чтобы просмотреть все ожидающие изменения в Visual Studio, перейдите в раздел Team Обозреватель> Pending Changes Исключенные изменения>, а затем нажмите кнопку "Обнаруженные".

Необходимые компоненты

Чтобы использовать status команду, необходимо иметь разрешение на чтение исходного элемента и разрешения на получение и слияние для целевой папки, заданной для параметра Allow. Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".

Синтаксис

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Параметры

Аргументы

Argument

Description

/collection: <TeamProjectCollectionUrl>

При использовании /workspace параметра указывает URL-адрес коллекции проектов, содержащей рабочую область, содержащую ожидающие изменения. Например: http://myserver:8080/tfs/DefaultCollection.

Если не указано, по умолчанию коллекция проектов считается той, которая содержит рабочую область, которая сопоставляет текущий каталог.

Игнорируется, если вы не используете /workspace этот параметр.

Примечание.

Сведения об ограничениях этого параметра см. в примечаниях.

/format

Указывает, сколько сведений о каждом ожидающих изменениях отображается:

  • Brief (по умолчанию): отображает одну строку о каждом ожидающих изменениях, включающих: имя файла, изменения, заблокирован ли элемент, как указано звездочкой *, локальным путем и пользователем при использовании /collection и /workspace параметров. Некоторые данные могут быть усечены.
  • Detailed: отображает полное описание каждого ожидающего изменения. Помимо приведенных выше сведений, этот параметр отображает дополнительные данные, такие как дата и время.

<itemspec>

Указывает элементы, для которых требуется отложенные данные об изменениях. Синтаксис см. в разделе "Использование команд управления версиями Team Foundation". Можно указать несколько itemspec аргументов.

/login

Указывает учетную запись пользователя, используемую для выполнения команды. См . команды управления версиями Team Foundation.

/recursive

Рекурсивно извлекает данные о ожидающих изменениях элементов в указанном каталоге и любых подкаталогах.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Указывает набор полок, содержащий изменения, которые нужно перечислить.

Этот параметр нельзя объединить с параметром /workspace .

/user

Перечисляет все ожидающие изменения, внесенные указанным пользователем. Звездочка * содержит данные об изменениях от всех пользователей. По умолчанию используется текущий пользователь.

Допустимые значения для этого параметра:

  • <username>
  • <useraccount>
  • Звездочка *

Примечание.

Сведения об ограничениях этого параметра см. в примечаниях.

/workspace:<workspacename>[;<workspaceowner>]

Указывает имя рабочей области, содержащей ожидающие изменения. Если это не указано, рабочая область является той, которая сопоставляет текущий каталог.

Вы можете указать workspaceowner , чтобы получить данные о ожидающих изменениях в рабочей области, которая принадлежит конкретному пользователю. Если это не указано, рабочая область считается текущим пользователем или, если указано, значение /login:<username>.

Этот параметр нельзя объединить с параметром /shelveset .

Примечание.

Сведения об ограничениях этого параметра см. в примечаниях.

Замечания

Вы можете использовать status команду для просмотра ожидающих изменений в текущей рабочей области, например рабочей области, которая сопоставляет текущий каталог независимо от того, является ли это локальная рабочая область или рабочая область сервера. Эту команду можно также использовать для просмотра ожидающих изменений в удаленной рабочей области сервера, например изменений, внесенных другим пользователем на другом компьютере разработки, с помощью /collection/userпараметров и /workspace параметров. Однако вы не можете просматривать ожидающие изменения в удаленной локальной рабочей области.

Дополнительные сведения см. в статье "Выбор между использованием локальной или серверной рабочей области".

Примеры

Во всех следующих примерах предполагается, что $/SiteApp/Main/ сопоставляется с c:\code\SiteApp\Main\ в рабочей области.

Перечисление всех изменений в текущей рабочей области

В следующем примере перечислены все ожидающие изменения в рабочей области:

c:\code\SiteApp\Main\SolutionA\>tf stat

Вывод списка всех изменений в папке

В следующем примере перечислены все ожидающие изменения всех элементов в папке SolutionA :

c:\code\SiteApp\Main>tf stat SolutionA\*

Вывод списка всех изменений в папке и ее вложенных папок

В следующем примере перечислены ожидающие изменения всех элементов в папке SolutionA , включая изменения в вложенных папках:

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Следующие шаги