Comando TFSLabConfig Permissions

Articolo
02/19/2013

Utilizzare il comando TFSLabConfig Permissions per impostare e ottenere le autorizzazioni impostate su un oggetto specificato per un utente indicato o per i più utenti in Visual Studio Lab Management.Per ulteriori informazioni sulle autorizzazioni individuali, vedere la sezione relativa alle autorizzazioni di gestione di Autorizzazioni per Team Foundation Server.

Autorizzazioni necessarie

Per eseguire una query sulle autorizzazioni relative a un oggetto è necessario avere le autorizzazioni di lettura per l'oggetto.Per modificare le autorizzazioni relative a un oggetto tramite il comando Permissions, è necessario disporre dell'autorizzazione Manage Permissions.Per impostazione predefinita, l'autore dell'oggetto dispone di questa autorizzazione.Per ulteriori informazioni, vedere la classe Autorizzazioni per 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]

Parametri

Opzione	Descrizione
Collection:collectionUrl	Necessario.URL della raccolta di progetti team a livello di applicazione di Team Foundation Server.Ad esempio, /collection: http://abc:8080/TFS/DefaultCollection.
objectSpec	Opzionale.Specifica l'oggetto di destinazione, quale un progetto team o una condivisione di libreria, a cui si applicano le autorizzazioni.Per informazioni su come specificare gli oggetti, vedere objectSpec di seguito.
User:userName1[,userName2][,...]	Opzionale.Specifica uno o più utenti a cui sono applicate le autorizzazioni.Utilizzare le virgole per separare più nomi utente.
Group:groupName1[,groupName2][,...]	Opzionale.Specifica uno o più gruppi a cui sono applicate le autorizzazioni.Utilizzare le virgole per separare più nomi di gruppi.
Allow:{* \|perm1[,perm2][,...]}	Opzionale.Abilita le autorizzazioni specificate per gli utenti o i gruppi indicati.Utilizzare un asterisco () per specificare tutte le autorizzazioni.Per specificare una singola autorizzazione, utilizzare gli identificatori nella colonna Name at command line* della tabella nella sezione relativa alle autorizzazioni di gestione di Autorizzazioni per Team Foundation Server.Utilizzare le virgole per separare più autorizzazioni.
Deny:{* \|perm1[,perm2][,...]}	Opzionale.Nega le autorizzazioni specificate agli utenti o ai gruppi indicati.Utilizzare un asterisco () per specificare tutte le autorizzazioni.Per specificare una singola autorizzazione, utilizzare gli identificatori nella colonna Name at command line* della tabella nella sezione relativa alle autorizzazioni di gestione di Autorizzazioni per Team Foundation Server.Utilizzare le virgole per separare più autorizzazioni.
Remove:{* \|perm1[,perm2][,...]}	Opzionale.Annulla l'impostazione delle autorizzazioni specificate, precedentemente concesse o negate all'utente o al gruppo.Per specificare una singola autorizzazione, utilizzare gli identificatori nella colonna Name at command line della tabella nella sezione relativa alle autorizzazioni di gestione di Autorizzazioni per Team Foundation Server.Utilizzare le virgole per separare più autorizzazioni.
Inherit:Yes\|No	Opzionale.Se si specifica Yes, tutte le autorizzazioni associate a un ACL padre verranno ereditate da un elemento.Non può essere combinata con le opzioni /remove, /user o /group.

objectSpec

È possibile specificare gli oggetti che si desidera includere nel comando TFSLabConfig Permissions in due modi:

Utilizzare una o più opzioni dei percorsi per specificare l'oggetto nella gerarchia di Lab Management.
Utilizzare l'opzione /Url per l'oggetto come Uri.

Se l'opzione del parametro objectSpec non è specificata, le autorizzazioni vengono applicate a tutti gli oggetti nella raccolta di progetti team.

Opzioni di tipo Object

Nella tabella seguente sono elencate le combinazioni valide di opzioni che è possibile utilizzare per specificare un oggetto come il parametro objectSpec di un comando TFSLabConfig permissions.

Per impostare le autorizzazioni relative a	Utilizzare queste opzioni
Gruppo host specifico in una raccolta di progetti team	/TeamProjectCollectionHostGroup:teamProjectCollectionHostGroupName
Condivisione di libreria specifica in una raccolta di progetti team	/TeamProjectCollectionLibraryShare:teamProjectCollectionLibraryShareName
Tutti gli host di gruppo in un progetto team	/TeamProject:projectName/TeamProjectHostGroup:*
Host di gruppo in un progetto team	/TeamProject:projectName/TeamProjectHostGroup:teamProjectHostGroupName
Ambiente lab in un gruppo host per un progetto team	/TeamProject:projectName /TeamProjectHostGroup:teamProjectHostGroupName/LabEnvironment:labEnvironmentName
Tutte le condivisioni di libreria in un progetto team	/TeamProject:projectName/TeamProjectLibraryShare:*
Condivisione di libreria in un progetto team	/TeamProject:projectName/TeamProjectLibraryShare:teamProjectLibraryShareName
Modello lab in una condivisione di libreria di un progetto team	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabTemplate:labTemplateName
Ambiente lab in una condivisione di libreria di un progetto team	/TeamProject:projectName /TeamProjectLibraryShare:teamProjectLibraryShareName /LabEnvironment:labEnvironmentName

Url

Utilizzare la sintassi seguente per specificare l'oggetto di destinazione objectSpec di un comando TFSLabConfig permissions tramite l'opzione /Url:

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

L'objectId è l'identificatore numerico univoco dell'oggetto.

Nella tabella riportata di seguito sono elencate le parole chiave valide della parola chiave objectType:

Tipo Object	Descrizione
TeamProjectCollectionHostGroup	Gruppo host di una raccolta di progetti team
TeamProjectCollectionLibraryShare	Condivisione di libreria di una raccolta di progetti team
TeamProject	Progetto team
TeamProjectHostGroup	Gruppo host di un progetto team
TeamProjectLibraryShare	Condivisione di libreria di un progetto team
LabTemplate	Macchina virtuale o modello in una condivisione di libreria del progetto team
LabEnvironment	Ambiente distribuito in un gruppo host del progetto team o archiviato in una condivisione di libreria del progetto team.

Autorizzazioni

È possibile specificare una o più autorizzazioni di Lab Management come destinazione delle opzioni /Allow, /Deny o /Remove.Per un elenco delle autorizzazioni disponibili, vedere la sezione Lab Management Permissions dell'argomento Autorizzazioni per Team Foundation Server.