Udostępnij za pośrednictwem

Zarządzanie typami łączy

  • Artykuł

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