Поделиться через

Команда status (Team Foundation Version Control)

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

Заметка

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

Необходимые условия

Чтобы использовать команду 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]

Параметры

Аргументы

аргумент

описание

/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

Дальнейшие действия