Udostępnij za pośrednictwem

Polecenie label (Kontrola wersji serwera Team Foundation)

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Polecenie Kontrola wersji serwera Team Foundation (TFVC) tf label dołącza etykietę do lub usuwa etykietę z wersji pliku lub folderu na serwerze TFVC.

Wymagania wstępne

Aby użyć label polecenia, musisz mieć uprawnienie Etykieta ustawione na Zezwalaj. Aby zmodyfikować lub usunąć etykiety utworzone przez innych użytkowników, musisz mieć uprawnienie Administracja ister labels ustawione na Wartość Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parametry

Argumenty

Argument

Opis

<labelname>

Określa nazwę etykiety, która ma zostać dołączona, zmodyfikowana lub usunięta z określonych elementów.

@<scope>

Określa katalog serwera TFVC, w którym labelname jest unikatowy. Ten parametr umożliwia niezależne tworzenie, zarządzanie, pobieranie i usuwanie jednej etykiety lub zestawu oznaczonych elementów, gdy dwie etykiety o tej samej nazwie znajdują się w różnych częściach serwera TFVC.

<ownername>

Udostępnia wartość, taką jak DOMAIN\JuanGo lub tylko juango /owner dla opcji.

<itemspec>

Identyfikuje plik lub folder, z którego ma być etykieta, ponowne etykietowanie lub modyfikowanie. Aby uzyskać więcej informacji o sposobie analizowania kontroli wersji serwera TEAMVC w itemspec celu określenia, które elementy znajdują się w zakresie, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Uwaga

Można określić więcej niż jeden itemspec argument.

<versionspec>

Zawiera wartość, taką jak c2 dla /version opcji. Aby uzyskać więcej informacji na temat analizowania specyfikacji wersji w celu określenia, które elementy znajdują się w jego zakresie, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

<comment>

Komentarz podany przez użytkownika dotyczący etykiety.

@<commentfile>

Podana przez użytkownika ścieżka pliku na dysku, który zawiera komentarz do użycia dla etykiety.

<username>

Udostępnia wartość /login opcji. Możesz określić wartość nazwy użytkownika jako DOMAIN\username lub username.

<TeamProjectCollectionUrl>

Adres URL określonej kolekcji projektów, która zawiera wersję pliku lub folderu, do którego chcesz dołączyć etykietę lub z której chcesz usunąć etykietę, na przykład http://myserver:8080/tfs/DefaultCollection.

Opcje

Opcja

Opis

/owner

Określa nazwę użytkownika, który jest właścicielem etykiety.

/version

Opcjonalny. Określa wersję pliku lub folderu, do którego ma być dołączona, zmodyfikowana lub z której ma zostać usunięta etykieta. Są to wartości zestawu zmian, na przykład C93. Domyślnie funkcja TFVC używa podstawowej wersji obszaru roboczego, jeśli nie versionspec jest podana.

/comment

Dodaje lub modyfikuje opis lub komentarz etykiety.

/child

Nie udokumentowane.

/recursive

Etykietuje wszystkie elementy w katalogu zgodnym z elementami itemspec i versionspec. Nie można używać z opcją /delete .

/delete

Usuwa etykietę.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps.

/collection

Określa kolekcję projektów.

Uwagi

Etykieta to znacznik, który można dołączyć do zestawu w inny sposób niepowiązanych plików i folderów na serwerze TFVC. Użyj etykiety, aby uprościć pobieranie plików i folderów do obszaru roboczego na potrzeby programowania lub kompilacji. Etykieta jest jak zestaw zmian lub data/godzina, do której i z którego można dowolnie dodawać i usuwać pliki i foldery lub zmieniać ich wersje. Etykieta to specyfikacja wersji, którą można przekazać do następujących poleceń kontroli wersji:

Typowe typy etykiet to etykiety kamieni milowych, takie jak M1, Beta2lub Release Candidate 0.

Etykiety są specyficzne dla wersji. Oznacza to, że można dołączyć etykietę tylko do jednej wersji pliku lub folderu. Każda wersja elementu może obsługiwać wiele etykiet.

Etykieta nie jest obiektem w wersji. W związku z tym historia etykiet plików nie jest śledzona. Ponadto operacja etykiety nie powoduje utworzenia oczekującej zmiany w obszarze roboczym. Gdy wydasz label polecenie, aktualizacja zostanie natychmiast odzwierciedlona na serwerze TFVC.

Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Usuwanie i usuwanie etykiet

Możesz użyć polecenia Unlabel, aby usunąć etykietę z pliku lub folderu. Alternatywnie można usunąć etykietę z systemu przy użyciu tf label /delete polecenia .

Aby uzyskać informacje o istniejącej etykiecie zawierającej listę elementów, do których została dołączona etykieta, jej komentarz, zakres i właściciel, zobacz Polecenie Etykiety.

Zarządzanie przeciążonymi etykietami

Nazwy etykiet muszą być unikatowe w określonym zakresie. Po dodaniu etykiety należy zarezerwować użycie tej nazwy etykiety w określonym lub domniemanym zakresie. Wartością domyślną parametru @scope jest projekt, na przykład $/TeamProject1.

Jeśli inny zespół lub użytkownik dodaje wspólną etykietę, taką jak M3 zestaw plików kontrolowanych przez wersję w innej części serwera TFVC, można zastosować etykietę M3 do plików kontrolowanych wersjami w projekcie, o ile foldery projektu głównego znajdują się w różnych katalogach. Jeśli na przykład pliki w katalogu $/math są oznaczone etykietą M3, możesz również zastosować etykietę M3 do plików w katalogu $/projects .

Aby uzyskać, usunąć etykietę lub zarządzać elementami oznaczonymi etykietami M3w inny sposób, należy określić @scope parametr, aby poinformować tfVC, z którą M3 etykietą chcesz pracować.

Można uniemożliwić innym użytkownikom "przeciążenie" etykiety, takiej jak M3 w różnych częściach serwera TFVC, tworząc etykietę w katalogu głównym $/ serwera kontroli wersji programu Team Foundation lub dostosowując uprawnienia etykiety dla niektórych folderów.

Przykłady

Poniższy przykład dołącza etykietę goodbuild do wersji obszaru roboczego folderu docs oraz plików i folderów, które zawiera.

c:\projects>tf label goodbuild docs /recursive

Poniższy przykład dołącza etykietę do folderu docs, ale nie do plików i folderów, które zawiera folder docs.goodbuild

c:\projects>tf label goodbuild docs

Poniższy przykład dołącza etykietę goodbuild do wersji 3 314.cs na serwerze TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

Poniższy przykład usuwa etykietę badbuild ze wszystkich elementów na serwerze TFVC.

c:\projects>tf label /delete badbuild

W poniższym przykładzie użyto @ opcji zakresu, aby zastosować etykietę do 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs