TFSLabConfig 使用權限命令

發行項
03/01/2013

使用 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 的有效關鍵字：

物件型別	描述
TeamProjectCollectionHostGroup	Team 專案集合的主機群組
TeamProjectCollectionLibraryShare	Team 專案集合的程式庫共用
TeamProject	Team 專案
TeamProjectHostGroup	Team 專案的主機群組
TeamProjectLibraryShare	Team 專案的程式庫共用
LabTemplate	Team 專案程式庫共用中的虛擬機器或範本
LabEnvironment	在 Team 專案主機群組上部署，或是儲存在 Team 專案程式庫共用中的環境。