TFSLabConfig 使用權限命令
使用 TFSLabConfig Permissions 命令，即可設定和取得 Visual Studio Lab Management 中指定之物件上的指定使用者或多個使用者的權限集。 如需個別使用權限的詳細資訊，請參閱 Team Foundation Server 使用權限的＜Lab Management 權限＞一節。
必要的使用權限
若要查詢物件的權限，您必須擁有該物件的讀取權限。 若要變更 Permissions 所命令之物件的權限，您必須具有 Manage Permissions 權限。 預設情況下，物件的建立者會有這個權限。 如需詳細資訊，請參閱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]
參數
選項 |
描述 |
|---|---|
Collection:collectionUrl |
必要項。 Team Foundation Server 之應用程式層上的 Team 專案集合的 URL。 例如，/collection:http://abc:8080/TFS/DefaultCollection。 |
objectSpec |
選擇項。 指定目標物件，例如會將權限套用至的 Team 專案或程式庫共用。 如需如何指定物件的詳細資訊，請參閱以下的 objectSpec。 |
User:userName1[,userName2][,...] |
選擇項。 指定要套用使用權限的一個或多個使用者。 使用逗號可隔開多個使用者名稱。 |
Group:groupName1[,groupName2][,...] |
選擇項。 指定要套用使用權限的一個或多個群組。 使用逗號可隔開多個群組名稱。 |
Allow:{* |perm1[,perm2][,...]} |
選擇項。 啟用指定之使用者或群組的指定使用權限。 使用星號 (*) 來指定所有的使用權限。 若要指定個別的權限，請使用 Team Foundation Server 使用權限之＜Lab Management 權限＞章節中資料表的 Name at command line 資料行中的識別項。 使用逗號可隔開多個權限。 |
Deny:{* |perm1[,perm2][,...]} |
選擇項。 拒絕指定之使用者或群組的指定使用權限。 使用星號 (*) 來指定所有的使用權限。 若要指定個別的權限，請使用 Team Foundation Server 使用權限之＜Lab Management 權限＞章節中資料表的 Name at command line 資料行中的識別項。 使用逗號可隔開多個權限。 |
Remove:{* |perm1[,perm2][,...]} |
選擇項。 取消設定原先授與或拒絕使用者或群組的指定使用權限。 若要指定個別的權限，請使用 Team Foundation Server 使用權限之＜Lab Management 權限＞章節中資料表的 Name at command line 資料行中的識別項。 使用逗號可隔開多個權限。 |
Inherit:Yes|No |
選擇項。 如果有指定 Yes，則項目會繼承與父 ACL 關聯的所有使用權限。 無法以 /remove、/user 或 /group 選項合併。 |
objectSpec
您可以用兩種方式指定要在 TFSLabConfig Permissions 命令中包括的物件：
使用一個或多個位置選項來指定 Lab Management 階層架構中的物件。
使用 /Url 選項將物件指定為 URI。
如果未指定 objectSpec 參數選項，則使用權限會套用至 Team 專案集合中的所有物件。
物件型別選項
下表列出可用來將物件指定為 TFSLabConfig permissions 命令之 objectSpec 參數的有效選項組合。
若要設定權限 |
使用這些選項 |
|---|---|
Team 專案集合中的特定主機群組。 |
/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName |
Team 專案集合中的特定程式庫共用 |
/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName |
Team 專案中的所有群組主機 |
/TeamProject:projectName /TeamProjectHostGroup:* |
Team 專案中的群組主機 |
/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName |
Team 專案之主機群組中的實驗室環境 |
/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName /LabEnvironment:labEnvironmentName |
Team 專案中的所有程式庫共用 |
/TeamProject: projectName /TeamProjectLibraryShare:* |
Team 專案中的程式庫共用 |
/TeamProject: projectName /TeamProjectLibraryShare:teamProjectLibraryShareName |
Team 專案之程式庫共用中的實驗室範本 |
/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName |
Team 專案之程式庫共用中的實驗室環境 |
/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName |
URL
使用下列語法，藉由使用 /Url 選項來指定 TFSLabConfig permissions 命令的 objectSpec 目標物件：
**/url:VSTFS:///LabManagement/objectType/**objectId
objectId 是物件的唯一數值識別項。
下表列出 objectType 的有效關鍵字：
Object 型別 |
描述 |
|---|---|
TeamProjectCollectionHostGroup |
Team 專案集合的主機群組 |
TeamProjectCollectionLibraryShare |
Team 專案集合的程式庫共用 |
TeamProject |
Team 專案 |
TeamProjectHostGroup |
Team 專案的主機群組 |
TeamProjectLibraryShare |
Team 專案的程式庫共用 |
LabTemplate |
Team 專案程式庫共用中的虛擬機器或範本 |
LabEnvironment |
在 Team 專案主機群組上部署，或是儲存在 Team 專案程式庫共用中的環境。 |
使用權限
您可以將一個或多個 Lab Management 權限指定為 /Allow、/Deny或 /Remove 選項的目標。 如需可用權限的清單，參閱 Team Foundation Server 使用權限主題的Lab Management Permissions一節。
使用星號 (*) 來指定所有實驗室權限。
使用逗號可隔開多個權限。
備註
如果 /User 或 /Group 選項都沒有指定，就會顯示指定之物件的目前使用權限。
如果未指定 objectSpec 參數選項，則使用權限會套用至 Team 專案集合中的所有物件。