TFSLabConfig Permissions, commande

Article
06/09/2015

Utilisez la commande TFSLabConfig Permissions pour définir et obtenir des autorisations définies pour un utilisateur spécifié ou pour plusieurs utilisateurs sur un objet spécifié dans Visual Studio Lab Management. Pour plus d'informations sur les autorisations individuelles, consultez la section Autorisations Lab Management de Référence des autorisations pour Team Foundation Server.

Autorisations requises

Pour interroger les autorisations d'un objet, vous devez posséder les autorisations de lecture pour l'objet. Pour modifier les autorisations sur un objet de la commande Permissions, vous devez posséder l'autorisation Manage Permissions. Par défaut, le créateur de l'objet a cette autorisation. Pour plus d'informations, consultez Référence des autorisations pour 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]

Paramètres

Option	Description
Collection:collectionUrl	Requis. URL de la collection de projets d'équipe sur la couche application de Team Foundation Server. Par exemple, /collection:http://abc:8080/TFS/DefaultCollection.
objectSpec	Optionnel. Spécifie l'objet cible tel qu'un projet d'équipe ou partage de bibliothèque auquel les autorisations sont appliquées. Pour plus d'informations sur la spécification d'objets, consultez objectSpec ci-dessous.
User:userName1[,userName2][,...]	Optionnel. Spécifie un ou plusieurs utilisateurs auxquels les autorisations sont appliquées. Utilisez des virgules pour séparer plusieurs noms d'utilisateur.
Group:groupName1[,groupName2][,...]	Optionnel. Spécifie un ou plusieurs groupes auxquels les autorisations sont appliquées. Utilisez des virgules pour séparer plusieurs noms de groupe.
Allow:{* \|perm1[,perm2][,...]}	Optionnel. Active les autorisations spécifiées pour les utilisateurs ou les groupes spécifiés. Utilisez un astérisque () pour spécifier toutes les autorisations. Pour spécifier une autorisation, utilisez les identificateurs dans la colonne Name at command line* du tableau dans la section Autorisations Lab Management de Référence des autorisations pour Team Foundation Server. Utilisez des virgules pour séparer plusieurs autorisations.
Deny:{* \|perm1[,perm2][,...]}	Optionnel. Refuse les autorisations spécifiées pour les utilisateurs ou les groupes spécifiés. Utilisez un astérisque () pour spécifier toutes les autorisations. Pour spécifier une autorisation, utilisez les identificateurs dans la colonne Name at command line* du tableau dans la section Autorisations Lab Management de Référence des autorisations pour Team Foundation Server. Utilisez des virgules pour séparer plusieurs autorisations.
Remove:{* \|perm1[,perm2][,...]}	Optionnel. Annule la définition des autorisations spécifiées qui ont été précédemment accordées ou refusées à l'utilisateur ou au groupe. Pour spécifier une autorisation, utilisez les identificateurs dans la colonne Name at command line du tableau dans la section Autorisations Lab Management de Référence des autorisations pour Team Foundation Server. Utilisez des virgules pour séparer plusieurs autorisations.
Inherit:Yes\|No	Optionnel. Si vous spécifiez Yes, toutes les autorisations associées à une liste de contrôle d'accès (ACL, access-control list) parente sont héritées par un élément. Ne peut pas être associé avec les options /remove, /user ou /group.

objectSpec

Vous pouvez spécifier les objets que vous souhaitez inclure dans la commande TFSLabConfig Permissions de deux manières :

Utilisez une ou plusieurs options d'emplacements pour spécifier l'objet dans la hiérarchie Lab Management.
Utilisez l'option /Url pour spécifier l'objet comme un Uri.

Si l'option de paramètre objectSpec n'est pas spécifiée, les autorisations sont appliquées à tous les objets dans la collection de projets d'équipe.

Options de type d'objet

Le tableau suivant répertorie la combinaison valide des options que vous pouvez utiliser pour spécifier un objet en tant que paramètre objectSpec d'une commande TFSLabConfig permissions

Pour définir des autorisations sur	Utiliser ces options
Groupe hôte spécifique dans une collection de projets d'équipe	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Partage de bibliothèque spécifique dans une collection de projets d'équipe	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Tous les hôtes de groupe dans un projet d'équipe	/TeamProject:projectName /TeamProjectHostGroup:*
Hôte de groupe dans un projet d'équipe	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName
Environnement lab dans un groupe hôte pour un projet d'équipe	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName
Tous les partages de bibliothèque dans un projet d'équipe	/TeamProject: projectName /TeamProjectLibraryShare:*
Partage de bibliothèque dans un projet d'équipe	/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName
Modèle lab dans un partage de bibliothèque d'un projet d'équipe	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Environnement lab dans un partage de bibliothèque d'un projet d'équipe	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

Utilisez la syntaxe suivante pour spécifier l'objet cible objectSpec d'une commande TFSLabConfig permissions à l'aide d'une option /Url :

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

L'objectId est l'identificateur numérique unique de l'objet.

Le tableau suivant répertorie les mots clés valides pour le mot clé objectType :

Type d'objet	Description
TeamProjectCollectionHostGroup	Groupe hôte d'une collection de projets d'équipe
TeamProjectCollectionLibraryShare	Partage de bibliothèque d'une collection de projets d'équipe
TeamProject	Projet d'équipe
TeamProjectHostGroup	Un groupe hôte de projet d'équipe
TeamProjectLibraryShare	Partage de bibliothèque d'un projet d'équipe
LabTemplate	Un ordinateur virtuel ou modèle dans un partage de bibliothèque de projet d'équipe
LabEnvironment	Un environnement déployé sur un groupe hôte de projet d'équipe ou stocké dans un partage de bibliothèque de projet d'équipe.

Autorisations

Vous pouvez spécifier une ou plusieurs autorisations Lab Management comme cible des options /Allow, /Deny ou /Remove. Pour une liste des autorisations disponibles, consultez la section Lab Management Permissions de la rubrique Référence des autorisations pour Team Foundation Server.