Поделиться через

Команда Permissions TFSLabConfig

  • Статья

Команда 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.

  • Чтобы задать все разрешения лаборатории, воспользуйтесь звездочкой (*).

  • Используйте запятые для разделения нескольких разрешений.

Заметки

Если не указан ни один из параметров /User или /Group, отображаются текущие разрешения указанного объекта.

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

См. также

Задачи

Настройка и администрирование Lab Management

Основные понятия

Настройка Lab Management с помощью средства TFSLabConfig

Разрешения Team Foundation Server

Другие ресурсы

Команды Lab