Partager via


TFSLabConfig Permissions, commande

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.

  • Utilisez un astérisque (*) pour spécifier toutes les autorisations de laboratoire.

  • Utilisez des virgules pour séparer plusieurs autorisations.

Notes

Si ni l'option /User ni l'option /Group n'est spécifiée, les autorisations actuelles de l'objet spécifié sont affichées.

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.

Voir aussi

Concepts

Référence de la commande TFSLabConfig

Référence des autorisations pour Team Foundation Server

Référence de la commande TFSConfig Lab

Configuration et administration de Lab Management