Personalizzazione e gestione dei tipi di collegamento

Articolo
08/11/2011

È possibile gestire tipi di collegamento definiti per un insieme di progetti team tramite i seguenti comandi witadmin:

deactivatelinktype: disattiva il tipo di collegamento specificato. Gli utenti non saranno più in grado di creare collegamenti di questo tipo. Collegamenti esistenti di questo tipo continueranno a funzionare correttamente.
deletelinktype: Rimuove in modo permanente il tipo di collegamento specificato dal database. Anche i collegamenti definiti con questo tipo di collegamento vengono rimossi.
exportlinktype: Esporta le definizioni dei tipi di collegamento. È possibile esportare la definizione di un solo tipo di collegamento o di tutti i tipi di collegamento definiti per il server.
importlinktype: Importa le definizioni di tipi di collegamento da un file XML. Se un tipo di collegamento con lo stesso nome di riferimento già esiste, verrà aggiornato per corrispondere al tipo di collegamento importato. Se il tipo di collegamento non è già esistente, ne verrà creato uno nuovo.
listlinktypes: Elenca il set disponibile di tipi di collegamento su un server.
reactivatelinktype: Riattiva il tipo di collegamento specificato e facoltativamente gli assegna un nuovo nome.

L'utilità della riga di comando witadmin si trova in Unità>:\Programmi\Microsoft Visual Studio 10.0\Common7\IDE nel computer client che esegue Team Explorer.

Nota

È possibile creare e modificare tipi di collegamento tramite Editor processi, uno strumento avanzato per Visual Studio. Questo strumento non è supportato. Per ulteriori informazioni, vedere la pagina seguente sul sito Web Microsoft: Power Tools di Team Foundation Server (aprile 2010).

Autorizzazioni necessarie

Per l'insieme di progetti in cui sono definiti i tipi di collegamento, è necessario disporre del set di autorizzazioni seguente:

Per elencare o esportare tipi di collegamento, è necessario essere un membro del gruppo Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti.
Per eliminare, importare o riattivare i tipi di collegamento, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o Project Administrators.

Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di Team Foundation Server.

Nota

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008. Per aprire una finestra del prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi, quindi scegliere Esegui come amministratore. Per ulteriori informazioni, visitare il sito Web Microsoft Controllo dell'account utente.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Parametri

Parametro	Oggetto di descrizione
/collection:CollectionURL	Specifica l'URI dell'insieme di progetti team. Il formato per l'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Di seguito è riportato un esempio. http://ServerName:8080/tfs/Collection0 Se non viene utilizzata una directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeInsieme
/n:LinkName	Il nome o il nome di riferimento del tipo di collegamento da disattivare o eliminare.
/f:FileName	Nome del file XML dei tipi di collegamento. Richiesto per importazione, facoltativo per esportazione. Se si omette questo parametro, l'output dei comandi viene visualizzato sul display.
/e:encoding	Il nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà utilizzata per esportare o importare i dati XML. Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7). Se si omette questo parametro, witadmin tenta di rilevare la codifica e se il rilevamento non riesce, witadmin utilizza UTF-8.
/v	Convalida il codice XML del tipo di collegamento senza importarlo.
/noprompt	Disabilita la richiesta di conferma.
/? o help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

Per la struttura dello schema di definizione del tipo di collegamento, vedere Utilizzo dei tipi di collegamento.

Esempi

Se non diversamente specificato, i valori seguenti vengono applicati in ogni esempio:

URI per l'insieme di progetti team: http://AdventureWorksServer:8080/AWTeam/Collection1
Nome del server: AdventureWorksServer
Nome del file di input o di output: myLinkTypes.xml
Nome del tipo di collegamento: mylinktype
Codifica predefinita: UTF-8

Elencare i tipi di collegamento

Nel comando seguente vengono visualizzati i tipi di collegamento personalizzati definiti per AdventureWorksServer di Team Foundation.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Elencare le definizioni di un tipo di collegamento

Nell'esempio seguente viene visualizzata la definizione del tipo di collegamento nella finestra Prompt dei comandi:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Disattivare e riattivare un tipo di collegamento

Negli esempi seguenti viene prima disattivato il tipo di collegamento, mylinktype, e poi riattivato:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

Esportare le definizioni di un tipo di collegamento

Il comando seguente consente di esportare la definizione di tutti i tipi di collegamento al file mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Importare la definizione di tipi di collegamento

Nell'esempio seguente viene importata la definizione dei tipi di collegamento definita nel file XML:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Vedere anche

Condividi tramite