TFSLabConfig Permissions-Befehl
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 Lab-Management-Berechtigungen unter Team Foundation Server-Berechtigungen.
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 Manage Permissions verfügen. Standardmäßig verfügt der Ersteller des Objekts über diese Berechtigung. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.
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 |
Beschreibungen |
|---|---|
Collection:collectionUrl |
Erforderlich. Die URL der Teamprojektsammlung auf der Anwendungsebene von Team Foundation Server. Beispiel: /collection:http://abc:8080/TFS/DefaultCollection. |
objectSpec |
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][,...] |
Optional. Gibt einen oder mehrere Benutzer an, auf die die Berechtigungen angewendet werden. Trennen Sie mehrere Benutzernamen durch Kommas. |
Group:groupName1[,groupName2][,...] |
Optional. Gibt eine oder mehrere Gruppen an, auf die die Berechtigungen angewendet werden. Trennen Sie mehrere Gruppennamen durch Kommas. |
Allow:{* |perm1[,perm2][,...]} |
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 Lab-Management-Berechtigungen von Team Foundation Server-Berechtigungen. Trennen Sie mehrere Berechtigungen durch Kommas. |
Deny:{* |perm1[,perm2][,...]} |
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 Lab-Management-Berechtigungen von Team Foundation Server-Berechtigungen. Trennen Sie mehrere Berechtigungen durch Kommas. |
Remove:{* |perm1[,perm2][,...]} |
Optional. Hebt die Festlegung der angegebenen Berechtigungen auf, 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 Lab-Management-Berechtigungen von Team Foundation Server-Berechtigungen. Trennen Sie mehrere Berechtigungen durch Kommas. |
Inherit:Yes|No |
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 in der Teamprojektsammlung für alle Objekte ü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.
Zum Festlegen von Berechtigungen für |
Verwenden Sie diese Optionen |
|---|---|
Eine bestimmte Hostgruppe in einer Teamprojektsammlung |
/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName |
Eine bestimmte Bibliotheksfreigabe in einer Teamprojektsammlung |
/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 |
Beschreibungen |
|---|---|
TeamProjectCollectionHostGroup |
Eine Hostgruppe einer Teamprojektsammlung |
TeamProjectCollectionLibraryShare |
Eine Bibliotheksfreigabe einer Teamprojektsammlung |
TeamProject |
Ein Teamprojekt |
TeamProjectHostGroup |
Eine Hostgruppe eines Teamprojekts |
TeamProjectLibraryShare |
Eine Bibliotheksfreigabe eines Teamprojekts |
LabTemplate |
Ein virtueller Computer oder eine Vorlage in eine 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 Team Foundation Server-Berechtigungen.
Geben Sie alle Lab-Berechtigungen mithilfe eines Sternchens (*) an.
Trennen Sie mehrere Berechtigungen durch Kommas.
Hinweise
Wenn weder die /User-Option noch die /Group-Option angegeben wird, werden die aktuellen Berechtigungen des angegebenen Objekts angezeigt.
Wenn die objectSpec-Parameteroption nicht angegeben wird, werden die Berechtigungen in der Teamprojektsammlung für alle Objekte übernommen.
Siehe auch
Aufgaben
Konfigurieren und Verwalten von Lab-Management
Konzepte
Team Foundation Server-Berechtigungen