Zarządzanie typami łączy
Podobnie jak typy elementów pracy, można definiować i modyfikować typy łączy niestandardowych.Jednak nie można wprowadzać wszelkie zmiany typów zdefiniowanych w systemie łącza.Przed dodaniem nowego typu łącze do swojej kolekcji projektu zespołowego, przejrzyj typów łącza dostępnych dla użytkownika.Zobacz Łączenie elementów roboczych w celu obsługi funkcji śledzenia.
Zarządzanie zdefiniowane dla kolekcji projektów zespołu za pomocą następujących typów łącza witadmin polecenia:
deactivatelinktype: Dezaktywuje typ określonego łącza.Użytkownicy nie będą już nie może utworzyć łącza tego typu.Istniejące łącza tego typu będzie działać prawidłowo.
deletelinktype: Trwale usuwa typ określonego łącza z bazy danych.Wszystkie łącza zdefiniowane za pomocą tego typu łącza są również usuwane.
exportlinktype: Eksportuje definicje typów łącza.Można wyeksportować definicji typu łącza jednego lub wszystkich typów łącza zdefiniowane dla serwera.
importlinktype: Importuje definicje typów łącza z pliku XML.Typ łącza o tej samej nazwie odwołanie już istnieje, zostanie zaktualizowania zgodnie z typem importowanych łącza.Jeśli ustawiono typ łącza jeszcze nie istnieje, zostanie utworzony nowy typ łącza.
listlinktypes: Wyświetla zestaw dostępnych typów łącza na serwerze.
reactivatelinktype: Spowoduje ponowne uaktywnienie typ określonego łącza, a opcjonalnie przypisuje mu nową nazwę.
Aby uruchomić witadmin wiersza polecenia narzędzie, Otwórz okno wiersza polecenia gdzie albo Visual Studio lub Team Explorer jest zainstalowana i wprowadź:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
W przypadku 32-bitowej wersji systemu Windows, zastępuje %programfiles(x86)% z %programfiles%.
Wymagania
Kolekcja projektów zespołu, gdzie są zdefiniowane typy łączy, musisz mieć uprawnienia następujące ustawienia:
Na liście lub wyeksportować typy łączy, musi mieć swoją wyświetlić informacje dotyczące projektu uprawnień dla projektów zespołowych w kolekcji, ustaw Zezwalaj.
To delete, import, or reactive link types, you must be a member of the Project Collection Administrators security group or have your Manage work item link types permission set to Allow.
Aby uzyskać więcej informacji, zobacz Uprawnienia serwera programu Team Foundation Server.
[!UWAGA]
Nawet jeśli użytkownik loguje się przy użyciu uprawnień administracyjnych, należy otworzyć okno wiersza polecenia z podniesionymi uprawnieniami tej funkcji na serwerze, na którym działa Windows Server 2008.Aby otworzyć okno wiersza polecenia z podniesionymi uprawnieniami, wybierz polecenie Start, otwórz wiersza polecenia menu skrótów, a następnie wybierz Uruchom jako Administrator.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: kontroli dostępu użytkownika.
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
Parametry
Parametr |
Opis |
---|---|
/collection:CollectionURL |
Określa identyfikator URI Kolekcja projektów zespołu.Format dla identyfikatora URI jest następująca: http://nazwa_serwera: port/NazwaKataloguWirtualnego/nazwa_kolekcji Na przykład: http: //ServerName:8080/tfs/Collection0 Jeśli katalog wirtualny nie jest używany, format dla identyfikatora URI jest następujący: http://Nazwa_serwera: port / nazwa_kolekcji |
/n:LinkName |
Nazwa lub nazwa odwołania typu łącza, aby dezaktywować lub usunąć. |
/f:FileName |
Plik XML typów łącza.Wymagane do importowania opcjonalne dla eksportu.Jeśli ten parametr zostanie pominięty, dane wyjściowe polecenia pojawi się na ekranie. |
/e:encoding |
Nazwa Program .NET Framework 2,0 format kodowania.Kodowanie określonego będzie używany do eksportowania i importowania danych XML.Na przykład /e:utf-7 Określa kodowanie Unicode (UTF-7).Jeśli ten parametr zostanie pominięty witadmin próbuje wykryć kodowania, i w przypadku niepowodzenia wykrywania witadmin używa UTF-8. |
/v |
Sprawdza typ łącza XML bez importowania. |
/noprompt |
Wyłącza monit o potwierdzenie. |
/? lub help |
Wyświetla Pomoc dotyczącą polecenia w oknie wiersza polecenia. |
Uwagi
Dla struktury schematu definicji typu łącze, zobacz Odwołania do elementu typów łączy.
Aby uzyskać informacje, jak można ograniczyć typy relacji łącza, które mogą wprowadzać członkowie zespołu, zobacz Formanty łączy, ograniczenia i odwołania pola i Elementy LinksControlOptions.
Przykłady
Jeśli nie podano inaczej, w każdym przykładzie mają zastosowanie następujące wartości:
Identyfikator URI dla kolekcji projektu zespołowego: DefaultCollection-http://AdventureWorksServer:8080/tfs
Nazwa serwera: AdventureWorksServer
Danych wejściowych lub wyjściowych nazwa pliku: myLinkTypes.xml
Nazwa typu łącza: mylinktype
Domyślnym kodowaniem: UTF-8
Lista typów łącza
Następujące polecenie wyświetla typy łączy niestandardowych zdefiniowanych dla Team Foundation AdventureWorksServer.
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Lista definicji typu łącza
Poniższy przykład przedstawia definicję typu łącze w oknie wiersza polecenia:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Dezaktywuj, a następnie uaktywnić łącza
W poniższych przykładach Dezaktywuj typ łącza, mylinktype i następnie Uaktywnij ponownie:
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
Eksportowanie definicji typu łącza
Następujące polecenie eksportuje definicji typów łącze do pliku, mylinktype.xml:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Importowanie definicji typów łącza
Poniższy przykład importuje definicji typów łączy zdefiniowane w pliku XML:
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Zobacz też
Koncepcje
Odwołania do elementu typów łączy
Formanty łączy, ograniczenia i odwołania pola
Inne zasoby
Łączenie elementów roboczych w celu obsługi funkcji śledzenia
witAdmin: dostosowywanie obiektów i zarządzanie nimi w celu śledzenia elementów pracy