Команда Status
Отображает сведения об ожидающих изменениях в элементах одной или нескольких рабочих областей.
Необходимые разрешения
Для использования команды status необходимо иметь разрешение Чтение со значением Разрешить для всех указанных элементов или папок. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf status itemspec [/collection:TeamProjectCollectionUrl] [/login:username,[password]] ([/workspace:workspacename[;workspaceowner]]|[/shelveset:shelvesetname[;shelvesetowner]])[/format:(brief|detailed)]
[/recursive][/user:(*|username)]
Параметры
Аргумент |
Описание |
---|---|
itemspec |
Определяет файл или папку, для которой отображаются подробные сведения о состоянии. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Синтаксис командной строки (управление версиями). ![]()
Можно указать более одного аргумента Itemspec.
|
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, для которой необходимо показать информацию о состоянии (например, http://myserver:8080/tfs/DefaultCollection). |
workspacename |
Предоставляемое пользователем значение параметра /workspace. |
workspaceowner |
Указывает имя пользователя, создавшего рабочую область. |
shelvesetname |
Предоставляемое пользователем значение параметра /shelveset. |
shelvesetowner |
Указывает имя владельца набора отложенных изменений. |
username |
Предоставляет значение для параметра /user. В зависимости от сетевых параметров значение имени пользователя может быть выражено одним из двух способов: ДОМЕН\имя пользователя или имя пользователя. |
Параметр |
Описание |
---|---|
/collection |
Указывает коллекцию командных проектов. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
/workspace |
Указывает имя рабочей области, для которой отображается список изменений. Если параметр не указан и выполняется команда из каталога, добавленного к рабочей области, используется текущая рабочая область. Параметр не может использоваться вместе с параметром /shelveset. |
/shelveset |
Имя набора отложенных изменений, для которого отображается список изменений. Параметр не может использоваться вместе с параметром /workspace. |
/format |
Формат сведений о состоянии. Brief отображает список изменений и изменения, внесенные при отложенном возврате. Detailed отображает полные сведения о состоянии. Brief является значением по умолчанию. |
/recursive |
Отображает сведения о состоянии для всех элементов в определенном каталоге и всех его вложенных каталогах. |
/user |
Фильтрует список изменений по имени пользователя. Для представления всех пользователей используется звездочка (*). Значением по умолчанию является текущий пользователь. |
Заметки
Команда status отображает список ожидающих изменений. Ожидающее изменение является версией файла или папки, которое не было отправлено на сервер или объединено в набор изменений версий. Дополнительные сведения см. в разделе Ожидающие изменения.
При указании параметра /shelveset отображаются подробные сведения об отложенных изменениях, не касающихся версий, в наборе отложенных изменений. Дополнительные сведения о различиях между ожидающими изменениями и отложенными изменениями см. в разделе Работа с наборами отложенных изменений.
Ссылки на другие команды Team Foundation, предоставляющие дополнительные сведения об элементах на сервере и всех сопоставленных ему рабочих областях, см. в разделе Информационные команды.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Команда "output"
Отображает новое имя для ожидающего изменения с типом rename. Дополнительные сведения см. в разделе Команда Rename (управление версиями Team Foundation).
Существует два режима отображения: краткий и подробный.
/Format:brief отображает имя файла элемента, изменение и локальный путь. Если элемент заблокирован — тип ожидающего изменения, имя пользователя, сделавшего его, и расположение версии элемента рабочей области на диске. Результат сортируется сначала по папке, а затем по имени файла в папке.
/Format:detailed отображает несколько строк сведений о каждом ожидающем изменении. Подробные результаты в дополнение к кратким включают дату, время и другие сведения.
Примеры
В следующем примере отображаются сведения обо всех ожидающих изменениях для текущего пользователя в текущей рабочей области. Текущей является рабочая область, которой сопоставлен локальный каталог.
c:\projects>tf status
В следующем примере отображаются все ожидающие изменения для текущего пользователя в каталоге "d:\src on" на текущем компьютере.
c:\projects>tf status /recursive d:\src
В следующем примере отображаются все ожидающие изменения для текущего пользователя в рабочей области "Beta1".
c:\projects>tf status /workspace:Beta1
В следующем примере отображаются сведения о состоянии для всех ожидающих изменений пользователя "Jason".
c:\projects>tf status /user:Jason
В следующем примере отображаются сведения о состоянии всех ожидающих изменений для всех пользователей во всех рабочих областях на сервере.
c:\projects>tf status /user:*
В следующем примере отображаются сведения обо всех ожидающих изменениях для текущего пользователя во всех рабочих областях коллекции, расположенной по адресу http://myserver:8080/tfs/DefaultCollection/.
c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:*
В следующем примере отображается информация обо всех изменениях, сделанных Joe, но не провереных, во всех рабочих областях, расположенных по адресу http://myserver:8080/tfs/DefaultCollection/ коллекции.
c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:* /user:Joe
См. также
Ссылки
Синтаксис командной строки (управление версиями)
Основные понятия
Создание рабочей области для работы с командным проектом
Работа с наборами отложенных изменений