Comando de permissões TFSLabConfig

Artigo
06/09/2015

Use o TFSLabConfig Permissions comando para definir e obter as permissões definidas para um usuário especificado ou para vários usuários em um objeto especificado em Visual Studio Lab Management. Para obter mais informações sobre permissões individuais, consulte a seção permissões do Lab Management Referência de permissões para o Team Foundation Server.

Permissões Necessárias

Permissões de consulta em um objeto, você deve ter leitura permissões para o objeto. Para alterar permissões em um objeto de Permissions de comando, você deve ter o Manage Permissions permissão. Por padrão, o criador do objeto tem essa permissão. Para obter mais informações, consulte Referência de permissões para o 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]

Parâmetros

Opção	Descrição
Collection:collectionUrl	Obrigatório. A URL da coleção de projeto de equipe na camada de aplicativo de Team Foundation Server. Por exemplo, /collection:http: / / abc: 8080/TFS/DefaultCollection.
objectSpec	Opcional. Especifica o objeto de destino como um compartilhamento de projeto ou biblioteca de equipe ao qual as permissões são aplicadas. Para obter informações sobre como especificar objetos, consulte objectSpec abaixo.
User:userName1[,userName2][,...]	Opcional. Especifica um ou mais usuários para o qual as permissões são aplicadas. Use vírgulas para separar vários nomes de usuário.
Group:groupName1[,groupName2][,...]	Opcional. Especifica um ou mais grupos aos quais as permissões são aplicadas. Use vírgulas para separar vários nomes.
Allow:{* \|perm1[,perm2][,...]}	Opcional. Permite que as permissões especificadas para os usuários especificados ou grupos. Use um asterisco para especificar todas as permissões. Para especificar uma permissão individual, use os identificadores de Name at command line coluna da tabela na seção permissões do Lab Management Referência de permissões para o Team Foundation Server. Use vírgulas para separar várias permissões.
Deny:{* \|perm1[,perm2][,...]}	Opcional. Nega permissões especificadas para os usuários especificados ou grupos. Use um asterisco para especificar todas as permissões. Para especificar uma permissão individual, use os identificadores de Name at command line coluna da tabela na seção permissões do Lab Management Referência de permissões para o Team Foundation Server. Use vírgulas para separar várias permissões.
Remove:{* \|perm1[,perm2][,...]}	Opcional. Desconfigura as permissões especificadas que anteriormente foram concedidas ou negadas ao usuário ou grupo. Para especificar uma permissão individual, use os identificadores de Name at command line coluna da tabela na seção permissões do Lab Management Referência de permissões para o Team Foundation Server. Use vírgulas para separar várias permissões.
Inherit:Yes\|No	Opcional. Se você especificar Yes, todas as permissões associadas a uma ACL pai são herdadas por um item. Não pode ser combinado com o /remove, /user, ou /group opções.

objectSpec

Você pode especificar os objetos que você deseja incluir o TFSLabConfig Permissions comando de duas maneiras:

Use uma ou mais opções de locais para especificar o objeto de Lab Management hierarquia.
Use o /Url opção para especificar o objeto como um Uri.

Se o objectSpec opção de parâmetro não for especificada, as permissões são aplicadas a todos os objetos da coleção de projeto de equipe.

Opções de tipo de objeto

A tabela a seguir lista a combinação válida de opções que você pode usar para especificar um objeto como o objectSpec parâmetro de um TFSLabConfig permissions comando.

Para definir permissões em	Use essas opções
Um grupo de host específico em uma coleção de projeto de equipe	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Um compartilhamento de biblioteca específica em uma coleção de projeto de equipe	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Todos os hosts de grupo em um projeto de equipe	/TeamProject:projectName /TeamProjectHostGroup:*
Um host de grupo em um projeto de equipe	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName
Um ambiente de laboratório em um grupo de host para um projeto de equipe	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName
Todos os compartilhamentos de biblioteca em um projeto de equipe	/TeamProject: projectName /TeamProjectLibraryShare:*
Um compartilhamento de biblioteca em um projeto de equipe	/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName
Um modelo de laboratório em um compartilhamento de biblioteca de um projeto de equipe	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Um ambiente de laboratório em um compartilhamento de biblioteca de um projeto de equipe	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

URL

Use a seguinte sintaxe para especificar o objectSpec o objeto de destino de um TFSLabConfig permissions comando usando o /Url opção:

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

ObjectId é o identificador numérico exclusivo do objeto.

A tabela a seguir lista as palavras-chave válidas para o objectType palavra-chave:

Tipo de objeto	Descrição
TeamProjectCollectionHostGroup	Um grupo de hosts de uma coleção de projeto de equipe
TeamProjectCollectionLibraryShare	Um compartilhamento de biblioteca de uma coleção de projeto de equipe
TeamProject	Um projeto de equipe
TeamProjectHostGroup	Um grupo de host de um projeto de equipe
TeamProjectLibraryShare	Um compartilhamento de biblioteca de um projeto de equipe
LabTemplate	Uma máquina virtual ou um modelo em um compartilhamento de biblioteca de projeto de equipe
LabEnvironment	Um ambiente que é implantado em um grupo de hosts de projeto de equipe ou armazenado em um compartilhamento de biblioteca de projeto de equipe.

Permissões

Você pode especificar um ou mais dos Lab Management permissões como o destino do /Allow, /Deny, ou /Remove opções. Listas de permissões disponíveis, consulte o Lab Management Permissions seção de Referência de permissões para o Team Foundation Server tópico.