Zarządzanie typami łączy [witadmin]
Podobnie jak typy elementów pracy, można definiować i modyfikować typy łączy niestandardowych. Nie można jednak wprowadzać wszelkie zmiany typy łączy zdefiniowanych przez system. Przed dodaniem nowego typu łącze do swojej kolekcji projektów zespołowych, przejrzyj dostępne do użycia typy łączy. Zobacz Zarządzanie zależnościami, łączenie elementów roboczych w celu obsługi śledzenia.
Zarządzaj zdefiniowane dla kolekcji projektów zespołowych przy użyciu następujących typów łącza witadmin polecenia:
deactivatelinktype: Dezaktywuje typu określonego łącza. Użytkownicy nie będą już nie może utworzyć łącza tego typu. Istniejące łącza tego typu będą nadal działać prawidłowo.
deletelinktype: Trwale usuwa typ określonego łącza z bazy danych. Wszystkie łącza zdefiniowane za pomocą tego typu łącza również zostaną usunięte.
exportlinktype: Eksportuje definicje typów łącza. Można wyeksportować definicji jednego łącza lub wszystkie typy łączy zdefiniowane dla serwera.
importlinktype: Importuje definicje typów łącza z pliku XML. Jeśli typ łącza o takiej samej nazwie odwołanie już istnieje, jej zostaną zaktualizowane w celu pasuje do typu importowanych łącza. Jeśli ustawiono typ łącza jeszcze nie istnieje, zostanie utworzony nowy typ łącza.
listlinktypes: Wyświetla zestaw dostępne typy łączy na serwerze.
reactivatelinktype: Spowoduje ponowne uaktywnienie typu określonego łącza, a opcjonalnie przypisuje mu nową nazwę.
witadmin Narzędzia wiersza polecenia działa tylko, jeśli zostanie uruchomione względem TFS lokalnie. Aby uruchomić narzędzie, Otwórz okno wiersza polecenia gdzie albo Visual Studio lub Team Explorer jest zainstalowany, a następnie wprowadź:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
W przypadku 32-bitowej wersji systemu Windows, zastępuje %programfiles(x86)% z %programfiles%.
Wymagania
Dla kolekcji projektów zespołowych, gdzie są zdefiniowane typy łączy, musi mieć następujące uprawnienia 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 o wartości Zezwalaj.
Do usuwania, importowanie i typy łączy reagowania musi być członkiem administratorów kolekcji projektów zabezpieczeń grupie lub mieć swoją typy łączy elementu roboczego Zarządzaj uprawnienie ustawione na Zezwalaj.
Aby uzyskać więcej informacji, zobacz Uprawnienia serwera programu Team Foundation Server.
Uwaga
Nawet wtedy, gdy użytkownik loguje się z uprawnieniami administracyjnymi, należy otworzyć okno wiersza polecenia z podniesionymi uprawnieniami do wykonania tej funkcji na serwerze, na którym działa Windows Server 2008.Aby otworzyć okno Wiersz polecenia z podwyższonym poziomem uprawnień, 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 kolekcji projektów zespołowych. Format identyfikatora URI jest następująca: http://nazwa_serwera: port/NazwaKataloguWirtualnego/CollectionName Na przykład: http: //ServerName:8080/tfs/Collection0 Jeśli katalog wirtualny nie jest używany, a następnie format identyfikatora URI jest następująca: http://Nazwa_serwera: port / CollectionName |
/n: LinkName |
Nazwa lub nazwa typu łącze Dezaktywuj lub usuń odwołania. |
/f: FileName |
Plik XML typów łącza. Wymagane do importowania, opcjonalnie eksportu. Jeśli ten parametr jest pominięty, dane wyjściowe polecenia pojawi się na ekranie. |
/e: encoding |
Nazwa .NET Framework 2.0 format kodowania. Określony schemat kodowania 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 |
Weryfikuje łącze typu XML bez konieczności ich 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.
Uzyskać informacje o sposobie może 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 są stosowane następujące wartości:
Identyfikator URI dla kolekcji projektów zespołowych: DefaultCollection-http://AdventureWorksServer:8080/tfs
Nazwa serwera: AdventureWorksServer
Danych wejściowych lub wyjściowych nazwa pliku: myLinkTypes.xml
Nazwa typu łącze: 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 łą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
Poniższe przykłady 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
Definicja typu łącza eksportu
Następujące polecenie eksportuje definicji wszystkich typów łącza do pliku, mylinktype.xml:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Importowanie definicji typy łączy
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
Zarządzanie zależnościami, łączenie elementów roboczych w celu obsługi śledzenia
witAdmin: dostosowywanie obiektów i zarządzanie nimi w celu śledzenia elementów pracy