Команда "status"
Обновлен: Ноябрь 2007
Отображает сведения об ожидающих изменениях в элементах одной или нескольких рабочих областей.
Требуемые разрешения
Для использования команды status необходимо иметь разрешение Чтение со значением Разрешить для всех указанных элементов или папок. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
Параметры
Аргумент |
Описание |
|---|---|
itemspec |
Определяет файл или папку, для которой отображаются подробные сведения о состоянии. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Синтаксис командной строки (Team System). |
servername |
Предоставляемое пользователем значение параметра /server. Пример: "http://teamfoundation2:8080". |
workspacename |
Предоставляемое пользователем значение параметра /workspace. |
workspaceowner |
Указывает имя пользователя, создавшего рабочую область. |
shelvesetname |
Предоставляемое пользователем значение параметра /shelveset. |
shelvesetowner |
Указывает имя владельца набора отложенных изменений. |
username |
Предоставляет значение для параметра /user. В зависимости от параметров сети значение имени пользователя может быть выражено одним из двух способов: ДОМЕН\имя пользователя или имя пользователя. |
Параметр |
Описание |
|---|---|
/server |
Определяет 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:*
В следующем примере отображаются сведения обо всех ожидающих изменениях для текущего пользователя во всех рабочих областях на сервере "teamserver2".
c:\projects>tf status/server:teamserver2 /workspace:*
В следующем примере отображаются сведения обо всех изменениях, сделанных, но не возвращенных пользователем "Joe", во всех рабочих областях, сопоставленных серверу "teamserver2".
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe
См. также
Основные понятия
Работа с рабочими областями системы управления версиями
Работа с наборами изменений системы управления версиями
Работа с наборами отложенных изменений системы управления версиями
Ссылки
Синтаксис командной строки (Team System)