Команда Workspace
Позволяет создавать, удалять, просматривать или изменять свойства и сопоставления, связанные с рабочей областью.
Необходимые разрешения
Для изменения или удаления существующей рабочей области необходимо быть ее владельцем или иметь глобальное разрешение Администрирование рабочих областей со значением Разрешить. Для создания рабочей области необходимо иметь глобальное разрешение Создание рабочей области со значением Разрешить. Для создания рабочих областей для других пользователей необходимо иметь разрешение Администрирование рабочих областей со значением Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:("comment"|@comment file)]
[/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]
tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]
tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
workspacename |
Задает имя рабочей области для создания, изменения, удаления или о которой нужно отобразить сведения. |
workspaceowner |
Задает имя пользователя для рабочей области. Этот параметр является обязательным, если пользователь, выполняющий команду, не является владельцем рабочей области. |
computername |
Предоставляет значение для параметра /computer . |
comment |
Предоставляет значение для параметра /comment . |
@commentfile |
Указывает путь к файлу, в котором следует прочесть комментарий. |
username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей рабочую область, информацию о которой нужно создать, изменить, удалить или отобразить (например, http://myserver:8080/tfs/DefaultCollection). |
ownername |
Предоставляет значение для параметра /newowner . |
Параметр |
Описание |
|---|---|
/new |
Создает рабочую область. |
/template |
Указывает существующую рабочую область, используемую в качестве шаблона для создания рабочей области. Новая рабочая область использует сопоставления уже существующей рабочей области. |
/delete |
Удаляет указанную рабочую область. |
/computer |
Указывает имя компьютера, на котором создается рабочая область. Этот параметр является расширенным параметром. |
/comment |
Предоставляет комментарий, описывающий рабочую область. |
/newname |
Переименовывает существующую рабочую область. |
/noprompt |
Выполняет указанную команду рабочей области без отображения диалогового окна. |
/collection |
Указывает коллекцию командных проектов. |
/permission |
Задает параметры разрешений для рабочей области:
|
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
/newowner |
Указывает имя пользователя в качестве нового владельца рабочей области. |
Заметки
Рабочая область является локальной копией файлов и папок на сервере, а также хранит все изменения, сделанные локально. При добавлении, изменении, удалении, перемещении, переименовании и прочих изменениях любого элемента, находящегося в системе управления версиями, изменения происходят только в рабочей области, где их можно внести и проверить. Ожидающие изменения фиксируются на сервере и к ним могут обращаться другие пользователи за пределами рабочей области во время выполнения возврата.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Создание рабочей области
Перед добавлением файла на сервер управления версиями или извлечением элементов на сервере для редактирования необходимо создать рабочую область или связать одну из существующих с текущим каталогом. Дополнительные сведения см. в разделе Создание рабочей области и получение файлов.
Чтобы сделать текущий каталог рабочей папкой для существующей рабочей области на компьютере, введите tf workspace workspacename, где workspacename — имя существующей рабочей области. Откроется диалоговое окно Изменение рабочей области. Щелкните в поле ввода новой рабочей папки, введите путь к серверу, для которого нужно сопоставить текущий каталог в поле Папка системы управления версиями , введите текущий каталог в поле Локальная папка и нажмите кнопку ОК.
При создании рабочей области можно указать шаблон рабочей области как часть параметра /new . При указании шаблона Team Foundation создаст рабочую область на текущем компьютере, назначит ее владельцем текущего владельца и скопирует из шаблона следующие свойства: сопоставление и комментарий. Если имя не было указано, система использует имя текущего компьютера. При создании рабочей области с помощью шаблона Team Foundation не извлекает сопоставленные файлы с сервера. Для синхронизации новой рабочей области с последней версией на сервере используется Команда Get.
Сопоставление отдельной папки
Для сопоставления рабочей области можно выбрать только непосредственный дочерний элемент папки управления версиями. Для этого добавьте подстановочный знак "звездочка" в поле Папка системы управления версиями диалогового окна Добавление рабочей области. Например, "$/folder/*". Однако по умолчанию локальной области рекурсивно сопоставляются все дочерние элементы папки системы управления версиями.
Сопоставление отдельной папки в иерархии системы управления версиями является целесообразным, поскольку ограничивает количество элементов, загружаемых на компьютер клиента. Другим способом ограничения загружаемых файлов является маскирование файлов, которые не нужны в рабочей области. Дополнительные сведения см. в разделе Маскировка и отмена маскировки папок в рабочей области. Это позволяет уменьшить время загрузки и сэкономить место на диске клиентского компьютера.
Удаление рабочей области
При удалении рабочей области, содержащей ожидающие изменения, Team Foundation отменит их в процессе удаления. При удалении рабочей области файлы и папки, находящиеся в ней, остаются на компьютере клиента.
Изменение рабочей области
Изменяются следующие атрибуты рабочей области.
Имя рабочей области
Комментарий
Сопоставления рабочей папки
Если спецификация рабочей области не предоставлена, используется рабочая область для текущей папки.
Примеры
В следующем примере открывается диалоговое окно Добавление рабочей области и создается рабочая область. Диалоговое окно Добавление рабочей области используется для изменения папки системы управления версиями, владельца, компьютера, комментария и локальных папок.
c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection
В следующем примере создается рабочая область с именем "Beta1", которой назначается владелец "jenh". Для изменения владельца необходимо иметь разрешение "Администрирование рабочих областей". Дополнительные сведения о разрешениях безопасности см. в разделе Разрешения Team Foundation Server.
c:\projects>tf workspace /new Beta1;jenh
В следующем примере создается рабочая область с помощью шаблона рабочей области "Beta1", владельцем которой является "jenh".
c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://myserver:8080/tfs/DefaultCollection
В следующем примере рабочая область "Beta1" удаляется c сервера.
c:\projects>tf workspace /delete Beta1
В следующем примере изменяются свойства текущей рабочей области.
c:\projects>tf workspace
В следующем примере открывается рабочая область "Beta1", принадлежащая пользователю "jenh", для просмотра свойств и сопоставлений. Для изменения свойств и сопоставлений необходимо иметь разрешение "Администрирование рабочих областей".
c:\projects> tf workspace Beta1;jenh
См. также
Задачи
Создание рабочей области и получение файлов
Маскировка и отмена маскировки папок в рабочей области
Ссылки
Синтаксис командной строки (управление версиями)
Основные понятия
Создание рабочей области для работы с командным проектом