Команда Permissions TFSLabConfig

Статья
06/09/2015

Команда TFSLabConfig Permissions используется для назначения и получения набора разрешений указанного пользователя или нескольких пользователей указанного объекта в Visual Studio Lab Management. Дополнительные сведения об отдельных разрешениях см. в подразделе "Разрешения Lab Management" раздела Справочник по разрешениям Team Foundation Server.

Необходимые разрешения

Чтобы запросить разрешения для объекта, нужны разрешения на чтение для этого объекта. Чтобы изменить разрешения для объекта команды Permissions, необходимо разрешение Manage Permissions. По умолчанию данное разрешение есть у создателя объекта. Дополнительные сведения см. в разделе Справочник по разрешениям Team Foundation Server.

TFSLabConfig Permissions
      /Collection:collectionUrl
      [objectSpec]
      {[/User:userName1[,userName2][,...]]
      [/Group:groupName1[,groupName2][,...]]}
      [/Allow:{* |perm1[,perm2][,...] }] 
      [/Deny:{* |perm1[,perm2][,...]}]
      [/Remove:{* |perm1[,perm2][,...]}]
      [/Inherit:Yes|No]

Параметры

Параметр	Описание
Collection:collectionUrl	Обязательное. URL-адрес коллекции командных ПРОЕКТОВ уровня приложений Team Foundation Server. Например, /collection:http://abc:8080/TFS/DefaultCollection.
objectSpec	Необязательный параметр. Задает целевой объект, например командный проект или общую папку библиотеки, к которому применяются разрешения. Дополнительные сведения о том, как указать объекты, см. в подразделе objectSpec ниже.
User:userName1[,userName2][,...]	Необязательный параметр. Задает одного или нескольких пользователей, к которым применяются разрешения. Используйте запятые для разделения нескольких имен пользователей.
Group:groupName1[,groupName2][,...]	Необязательный параметр. Задает одну или несколько групп, к которым применяются разрешения. Используйте запятые для разделения нескольких имен групп.
Allow:{* \|perm1[,perm2][,...]}	Необязательный параметр. Включает заданные разрешения для указанных пользователей или групп. Чтобы задать все разрешения, воспользуйтесь звездочкой (). Чтобы задать отдельные разрешения, воспользуйтесь идентификаторами в столбце Name at command line* таблицы в параграфе "Разрешения Lab Management" в разделе Справочник по разрешениям Team Foundation Server. Используйте запятые для разделения нескольких разрешений.
Deny:{* \|perm1[,perm2][,...]}	Необязательный параметр. Отключает заданные разрешения для указанных пользователей или групп. Чтобы задать все разрешения, воспользуйтесь звездочкой (). Чтобы задать отдельные разрешения, воспользуйтесь идентификаторами в столбце Name at command line* таблицы в параграфе "Разрешения Lab Management" в разделе Справочник по разрешениям Team Foundation Server. Используйте запятые для разделения нескольких разрешений.
Remove:{* \|perm1[,perm2][,...]}	Необязательный параметр. Отменяет установку заданных разрешений, которые были ранее предоставлены пользователю или группе, или им в них было отказано. Чтобы задать отдельные разрешения, воспользуйтесь идентификаторами в столбце Name at command line таблицы в параграфе "Разрешения Lab Management" в разделе Справочник по разрешениям Team Foundation Server. Используйте запятые для разделения нескольких разрешений.
Inherit:Yes\|No	Необязательный параметр. При выборе значения Yes все разрешения, связанные с родительским ACL, наследуются элементом. Не может сочетаться с параметрами /remove, /user или /group.

objectSpec

Объекты для включения в команду TFSLabConfig Permissions можно указать двумя способами:

Чтобы указать объект в иерархии Lab Management, воспользуйтесь одним или несколькими параметрами, чтобы задать объект.
Воспользуйтесь параметром /Url, чтобы задать объект в виде универсального кода ресурса (URI).

Если параметр objectSpec не указан, разрешения применяются ко всем объектам в коллекции командных проектов.

Параметры объектного типа

В следующей таблице перечислены допустимые сочетание параметров, с помощью которых объект можно задать как параметр objectSpec команды TFSLabConfig permissions.

Установка разрешения	Применение этих параметров
Определенная группа узлов в коллекции командных проектов.	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Определенная общая папка библиотеки в коллекции командных проектов	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Все узлы групп в командном проекте	/TeamProject:projectName /TeamProjectHostGroup:*
Узел группы в командном проекте	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName
Лабораторная среда в группе узлов для командного проекта	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName
Все общие папки библиотек в командном проекте	/TeamProject: projectName /TeamProjectLibraryShare:*
Общая папка библиотеки в командном проекте	/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName
Лабораторный шаблон в общей папке библиотеки командного проекта	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Лабораторная среда в общей папке библиотеки командного проекта	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

Чтобы указать конечный объект objectSpec команды TFSLabConfig permissions с помощью параметра /Url используется следующий синтаксис:

**/url:VSTFS:///LabManagement/objectType/**objectId

objectId – это уникальный числовой идентификатор объекта.

В следующей таблице перечислены допустимые ключевые слова для ключевого слова objectType.

Тип объекта	Описание
TeamProjectCollectionHostGroup	Группа узлов коллекции командных проектов
TeamProjectCollectionLibraryShare	Общая папка библиотеки коллекции командных проектов
TeamProject	Командный проект
TeamProjectHostGroup	Группа узлов командного проекта
TeamProjectLibraryShare	Общая папка библиотеки командного проекта
LabTemplate	Виртуальная машина или шаблон в общей папке библиотеки командного проекта
LabEnvironment	Среда, развернутая в группе узлов командного проекта или сохраненная в общей папке библиотеки командного проекта.

Разрешения

В качестве целевого объекта параметров /Allow, /Deny или /Remove можно указать одно или несколько разрешений Lab Management. Список доступных разрешений см. в подразделе Lab Management Permissions раздела Справочник по разрешениям Team Foundation Server.