TFSLabConfig Permissions-Befehl

Artikel
05/16/2015

Verwenden Sie den TFSLabConfig Permissions-Befehl, um für einen bestimmten Benutzer oder für mehrere Benutzer Berechtigungen für ein angegebenes Objekt in Visual Studio Lab Management festzulegen. Weitere Informationen über einzelne Berechtigungen finden Sie im Abschnitt zu Lab Management-Berechtigungen unter Berechtigungsreferenz für Team Foundation Server.

Erforderliche Berechtigungen

Um Berechtigungen für ein Objekt abzufragen, müssen Sie Leseberechtigungen für das Objekt besitzen. Um Berechtigungen für ein Objekt mit dem Permissions-Befehl zu ändern, müssen Sie über die Berechtigung Manage Permissions verfügen. Standardmäßig verfügt der Ersteller des Objekts über diese Berechtigung. Weitere Informationen finden Sie unter Berechtigungsreferenz für 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]

Parameter

Option	Beschreibung
Collection:collectionUrl	Erforderlich. Die URL der Teamprojektauflistung auf der Anwendungsebene von Team Foundation Server. Beispiel: /collection:http://abc:8080/TFS/DefaultCollection.
objectSpec	Dies ist optional. Gibt das Zielobjekt an, z. B. ein Teamprojekt oder eine Bibliotheksfreigabe, auf das die Berechtigungen angewendet werden. Weitere Informationen zum Angeben von Objekten finden Sie weiter unten unter objectSpec.
User:userName1[,userName2][,...]	Dies ist optional. Gibt einen oder mehrere Benutzer an, auf die die Berechtigungen angewendet werden. Trennen Sie mehrere Benutzernamen durch Kommas.
Group:groupName1[,groupName2][,...]	Dies ist optional. Gibt eine oder mehrere Gruppen an, auf die die Berechtigungen angewendet werden. Trennen Sie mehrere Gruppennamen durch Kommas.
Allow:{* \|perm1[,perm2][,...]}	Dies ist optional. Aktiviert die angegebenen Berechtigungen für die angegebenen Benutzer oder Gruppen. Geben Sie alle Berechtigungen mithilfe eines Sternchens () an. Um eine einzelne Berechtigung anzugeben, verwenden Sie die Bezeichner in der Spalte Name at command line* der Tabelle im Abschnitt Berechtigungen für Lab-Management von Berechtigungsreferenz für Team Foundation Server. Trennen Sie mehrere Berechtigungen durch Kommas.
Deny:{* \|perm1[,perm2][,...]}	Dies ist optional. Verweigert die angegebenen Berechtigungen für die angegebenen Benutzer oder Gruppen. Geben Sie alle Berechtigungen mithilfe eines Sternchens () an. Um eine einzelne Berechtigung anzugeben, verwenden Sie die Bezeichner in der Spalte Name at command line* der Tabelle im Abschnitt Berechtigungen für Lab-Management von Berechtigungsreferenz für Team Foundation Server. Trennen Sie mehrere Berechtigungen durch Kommas.
Remove:{* \|perm1[,perm2][,...]}	Dies ist optional. Setzt die angegebenen Berechtigungen zurück, die dem Benutzer oder der Gruppe zuvor gewährt oder verweigert wurden. Um eine einzelne Berechtigung anzugeben, verwenden Sie die Bezeichner in der Spalte Name at command line der Tabelle im Abschnitt Berechtigungen für Lab-Management von Berechtigungsreferenz für Team Foundation Server. Trennen Sie mehrere Berechtigungen durch Kommas.
Inherit:Yes\|No	Dies ist optional. Wenn Sie Yes angeben, erbt ein Element alle einer übergeordneten Zugriffssteuerungsliste zugeordneten Berechtigungen. Sie kann nicht mit den Optionen /remove, /user oder /group kombiniert werden.

objectSpec

Sie können die Objekte, die Sie in den TFSLabConfig Permissions-Befehl einschließen möchten, auf zwei Arten angeben:

Verwenden Sie einem oder mehrere Speicherortoptionen, um das Objekt in der Lab Management-Hierarchie anzugeben.
Verwenden Sie die /Url-Option, um das Objekt als URI anzugeben.

Wenn die objectSpec-Parameteroption nicht angegeben wird, werden die Berechtigungen für alle Objekte in der Teamprojektsammlung übernommen.

Objekttypoptionen

In der folgenden Tabelle ist die gültige Kombination von Optionen aufgeführt, mit denen Sie ein Objekt als objectSpec-Parameter eines TFSLabConfig permissions-Befehls angeben können.

So legen Sie Berechtigungen fest	Verwenden dieser Optionen
Eine bestimmte Hostgruppe in einer Teamprojektauflistung	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Eine bestimmte Bibliotheksfreigabe in einer Teamprojektauflistung	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Alle Gruppenhosts in einem Teamprojekt	/TeamProject:projectName /TeamProjectHostGroup:*
Ein Gruppenhost in einem Teamprojekt	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName
Eine Lab-Umgebung in einer Hostgruppe für ein Teamprojekt	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName
Alle Bibliotheksfreigaben in einem Teamprojekt	/TeamProject: projectName /TeamProjectLibraryShare:*
Eine Bibliotheksfreigabe in einem Teamprojekt	/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName
Eine Lab-Vorlage in einer Bibliotheksfreigabe eines Teamprojekts	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Eine Lab-Umgebung in einer Bibliotheksfreigabe eines Teamprojekts	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

Geben Sie das objectSpec-Zielobjekt eines TFSLabConfig permissions-Befehls mit der /Url-Option mit der folgenden Syntax an:

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

Die objectId ist der eindeutige numerische Bezeichner des Objekts.

In der folgenden Tabelle sind die gültigen Schlüsselwörter für das objectType-Schlüsselwort aufgeführt.

Object-Datentyp	Beschreibung
TeamProjectCollectionHostGroup	Eine Hostgruppe einer Teamprojektauflistung
TeamProjectCollectionLibraryShare	Eine Bibliotheksfreigabe einer Teamprojektauflistung
TeamProject	Ein Teamprojekt
TeamProjectHostGroup	Eine Hostgruppe eines Teamprojekts
TeamProjectLibraryShare	Eine Bibliotheksfreigabe eines Teamprojekts
LabTemplate	Ein virtueller Computer oder eine Vorlage in einer Teamprojekt-Bibliotheksfreigabe
LabEnvironment	Eine Umgebung, die in einer Teamprojekt-Hostgruppe bereitgestellt oder in einer Teamprojekt-Bibliotheksfreigabe gespeichert wird.

Berechtigungen

Sie können eine oder mehrere Lab Management-Berechtigungen als Ziel der Optionen /Allow, /Deny oder /Remove angeben. Eine Liste der verfügbaren Berechtigungen finden Sie im Abschnitt Lab Management Permissions des Themas Berechtigungsreferenz für Team Foundation Server.