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 的有效關鍵字:

物件型別

描述

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 專案集合中的所有物件。

請參閱

概念

TFSLabConfig 命令參考

Team Foundation Server 的權限參考

TFSConfig Lab 命令參考

設定和管理 Lab Management