Команда Permission
Изменяет список управления доступом пользователя (ACL) и отображает параметры авторизации для элемента в системе управления версиями.
Необходимые разрешения
Для использования команды permission необходимо иметь разрешение Управление параметрами безопасности со значением Разрешить для изменяемых папок, являться членом группы безопасности Администраторы Team Foundation или быть администратором локального компьютера (группа безопасности администраторов Windows). Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf permission [/allow:(* |perm1[,perm2,...]]
[/deny:(* |perm1[,perm2,...])] [/remove:(* |perm1[,perm2,...])]
[/inherit:yes|no] [/user:username1[,username2,...]]
[/group:groupname1[,groupname2,...]] [/collection:TeamProjectCollectionUrl]
[/recursive] itemspec [/global][/login:username,[password]]
Параметры
Аргумент |
Описание |
|---|---|
perm |
Имя разрешения или роли для изменения. Дополнительные сведения об именах разрешений см. в разделе Разрешения Team Foundation Server. |
Username |
Предоставляет значение для параметра /user. В зависимости от сетевых параметров значение имени пользователя может быть выражено одним из двух способов: ДОМЕН\имя пользователя или имя пользователя. |
Groupname |
Предоставляемое пользователем значение параметра /group . |
TeamProjectCollectionUrl |
URL-адрес коллекции командных проектов, содержащей элемент, для которого необходимо изменить разрешения (например, http://myserver:8080/tfs/DefaultCollection). |
Itemspec |
Указывает файл или папку для которой изменяются разрешения. Дополнительные сведения о том, как Team Foundation выполняет анализ itemspecs, чтобы определить, какие элементы находятся в области его действия, см. в разделе Синтаксис командной строки (управление версиями). .gif "Примечание") Примечание
Можно указать более одного аргумента Itemspec.
|
Username |
Предоставляет значение для параметра /login. Можно задать значение для имени пользователя как ДОМЕН\имя_пользователя или как имя_пользователя. |
Параметр |
Описание |
|---|---|
/allow |
Указывает список разрешений Team Foundation (подсистема контроля версий), добавляемых к белому списку ACL. |
/deny |
Указывает список запрещенных прав доступа Team Foundation (подсистема контроля версий), добавляемых в список управления доступом пользователя. |
/remove |
Указывает список разрешений Team Foundation (подсистема контроля версий), удаляемых из белого и запрещающего ACL. |
/inherit |
При выборе значения yes все разрешения, связанные с родительским ACL, наследуются элементом. Не может использоваться вместе с параметром /remove. |
/user |
Задает имя пользователя, для которого нужно изменить разрешения. |
/group |
Имя группы, для которой нужно изменить разрешения. |
/collection |
Указывает коллекцию командных проектов. |
/recursive |
Применяет заданную команду ко всем элементам в каталоге и всех его подкаталогах. Параметр /recursive работает только при просмотре разрешений для элемента в исходном дереве. Не работает при установке разрешений, например /allow, /deny и /remove. |
/global |
Используется для просмотра или назначения любых разрешений сервера Team Foundation. Для назначения разрешений предназначены параметры /allow, /deny или /remove. Аргумент itmespec не требуется. При указании игнорируется. При использовании для просмотра разрешений сервера Team Foundation применяются пять следующих разрешений.
Дополнительные сведения о разрешениях см. в разделе Разрешения Team Foundation Server. |
/login |
Задает имя пользователя и пароль для проверки подлинности пользователя с Visual Studio Team Foundation Server. |
Заметки
Команда permission (или ее краткий аналог perm) может использоваться для управления параметрами авторизации для объектов сервера Team Foundation (подсистема контроля версий). Однако данная команда не позволяет управлять такими параметрами проверки подлинности, как создание или изменение групп безопасности Team Foundation.
Дополнительные сведения о поиске программы командной строки if см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере отображаются списки управления доступом (ACL) Team Foundation для файла 314.cs.
c:\projects>tf permission 314.cs
Следующий пример отображает информацию ACL, который относится к группе "Разработчики" для коллекции, которая расположена в http://myserver:8080/tfs/DefaultCollection/.
c:\projects>tf permission /group:[teamproject]\developers /collection: http://myserver:8080/tfs/DefaultCollection/
В следующем примере члены группы "Руководители" получают разрешение на изменение локальных копий всех своих элементов в папке "$/baseobjects" сервера Team Foundation (подсистема контроля версий).
c:\projects>tf permission /allow:PendChange /group:[teamproject]\leads $/baseobjects
В следующем примере удаляются все разрешения, связанные с параметрами, из папки "$/baseobjects" для членов группы "Разработчики".
c:\projects>tf permission /remove:* /group:developers $/baseobjects
В следующем примере члены группы "Тестировщики" получают разрешение на изменение локальных копий всех своих элементов в папке "$/testproject".
c:\projects>tf permission /allow:PendChange /group:testers$/testproject
В следующем примере пользователь получает разрешение на создание ожидающих изменений в локальной копии "$/testtproject/314.cs" в его рабочей области.
c:\projects>tf permission /allow:PendChange /user:somealias $/testproject/314.cs.
В следующем примере пользователю запрещается создавать ожидающие изменения в локальной копии "$/testproject/1256.cs".
c:\projects>tf permission /deny:PendChange /user:somealias $/testproject/1256.cs
См. также
Ссылки
Синтаксис командной строки (управление версиями)