Команда "workspace"
Обновлен: Ноябрь 2007
Позволяет создавать, удалять, просматривать или изменять свойства и сопоставления, связанные с рабочей областью.
Требуемые разрешения
Для изменения или удаления существующей рабочей области необходимо быть ее владельцем или иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Для создания рабочей области необходимо иметь глобальное разрешение Создание рабочей области со значением Разрешить. Для создания рабочих областей для других пользователей необходимо иметь разрешение Администрирование рабочих областей со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:(“comment”|@comment file)]
[/s:servername] [workspacename[;workspaceowner]]
tf workspace /delete [/server:servername] workspacename[;workspaceowner]
tf workspace [/server:servername] [/comment: (“comment”|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]]
Параметры
Аргумент |
Описание |
|---|---|
workspacename |
Задает имя рабочей области для создания, изменения, удаления или о которой нужно отобразить сведения. |
workspaceowner |
Задает имя пользователя для рабочей области. Этот параметр является обязательным, если пользователь, выполняющий команду, не является владельцем рабочей области. |
computername |
Предоставляет значение для параметра /computer . |
comment |
Предоставляет значение для параметра /comment . |
@commentfile |
Указывает путь к файлу, в котором следует прочесть комментарий. |
servername |
Предоставляемое пользователем значение параметра /server. For example, "teamfoundation2". |
Параметр |
Описание |
|---|---|
/new |
Создает рабочую область. |
/template |
Указывает существующую рабочую область, используемую в качестве шаблона для создания рабочей области. Новая рабочая область использует сопоставления уже существующей рабочей области. |
/delete |
Удаляет указанную рабочую область. |
/computer |
Указывает имя компьютера, на котором создается рабочая область. Этот параметр является дополнительным. |
/comment |
Предоставляет комментарий, описывающий рабочую область. |
/server |
Определяет Team Foundation Server. Этот параметр является обязательным при создании рабочей области и запуска команды workspace из каталога, не сопоставленного рабочей области. |
/newname |
Переименовывает существующую рабочую область. |
/noprompt |
Выполняет указанную команду рабочей области без отображения диалогового окна. |
Заметки
Рабочая область является локальной копией файлов и папок на сервере, а также хранит все изменения, сделанные локально. При добавлении, изменении, удалении, перемещении, переименовании и прочих изменениях любого элемента, находящегося в системе управления версиями, изменения происходят только в рабочей области, где их можно внести и проверить. Ожидающие изменения фиксируются на сервере и к ним могут обращаться другие пользователи за пределами рабочей области во время выполнения возврата.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Создание рабочей области
Перед добавлением файла на сервер управления версиями или извлечением элементов на сервере для редактирования необходимо создать рабочую область или связать одну из существующих с текущим каталогом. Дополнительные сведения см. в разделе Практическое руководство. Создание сопоставленной рабочей области.
Чтобы сделать текущий каталог рабочей папкой для существующей рабочей области на компьютере, введите tf workspaceworkspacename, где workspacename — имя существующей рабочей области. Откроется диалоговое окно Изменение рабочей области. Щелкните в поле ввода новой рабочей папки, введите путь к серверу, для которого нужно сопоставить текущий каталог в поле Папка системы управления версиями , введите текущий каталог в поле Локальная папка и нажмите кнопку ОК.
При создании рабочей области можно указать шаблон рабочей области как часть параметра /new. При указании шаблона Team Foundation создаст рабочую область на текущем компьютере, назначит ее владельцем текущего владельца и скопирует из шаблона следующие свойства: сопоставление и комментарий. Если имя не было указано, система использует имя текущего компьютера. При создании рабочей области с помощью шаблона Team Foundation не извлекает сопоставленные файлы с сервера. Для синхронизации новой рабочей области с последней версией на сервере используется Команда "get".
Сопоставление отдельной папки
Для сопоставления рабочей области можно выбрать только непосредственный дочерний элемент папки управления версиями. Для этого добавьте подстановочный знак "звездочка" в поле Папка системы управления версиями диалогового окна Добавление рабочей области. Например, "$/folder/*". Однако по умолчанию локальной области рекурсивно сопоставляются все дочерние элементы папки системы управления версиями.
Сопоставление отдельной папки в иерархии системы управления версиями является целесообразным, поскольку ограничивает количество элементов, загружаемых на компьютер клиента. Другим способом ограничения загружаемых файлов является маскирование файлов, которые не нужны в рабочей области. Дополнительные сведения см. в разделе Практическое руководство. Маскировка и отмена маскировки папок в рабочей области. При этом уменьшается время загрузки и экономится место на диске на компьютере клиента.
Удаление рабочей области
При удалении рабочей области, содержащей ожидающие изменения, Team Foundation отменит их в процессе удаления. При удалении рабочей области файлы и папки, находящиеся в ней, остаются на компьютере клиента.
Изменение рабочей области
Изменяются следующие атрибуты рабочей области.
Имя рабочей области
Комментарий
Сопоставления рабочей папки
Если спецификация рабочей области не предоставлена, используется рабочая область для текущей папки.
Примеры
В следующем примере открывается диалоговое окно Добавление рабочей области и создается рабочая область. Диалоговое окно Добавление рабочей области используется для изменения папки системы управления версиями, владельца, компьютера, комментария и локальных папок.
c:\projects>tf workspace /new /server:teamserver2
В следующем примере создается рабочая область с именем "Beta1", которой назначается владелец "jenh". Для изменения владельца необходимо иметь разрешение "Администрирование рабочих областей". Дополнительные сведения о разрешениях безопасности см. в разделе Разрешения Team Foundation Server.
c:\projects>tf workspace /new Beta1;jenh
В следующем примере создается рабочая область с помощью шаблона рабочей области "Beta1", владельцем которой является "jenh".
c:\projects>tf workspace /new /template:Beta1;jenh /server:teamserver2
В следующем примере рабочая область "Beta1" удаляется из системы.
c:\projects>tf workspace /delete Beta1
В следующем примере изменяются свойства текущей рабочей области.
c:\projects>tf workspace
В следующем примере открывается рабочая область "Beta1", принадлежащая пользователю "jenh", для просмотра свойств и сопоставлений. Для изменения свойств и сопоставлений необходимо иметь разрешение "Администрирование рабочих областей".
c:\projects> tf workspace Beta1;jenh
См. также
Задачи
Пошаговое руководство. Управление версиями в Team Foundation с помощью командной строки
Практическое руководство. Создание сопоставленной рабочей области
Практическое руководство. Маскировка и отмена маскировки папок в рабочей области
Основные понятия
Работа с рабочими областями системы управления версиями
Ссылки
Синтаксис командной строки (Team System)