Udostępnij za pośrednictwem

Polecenie Label (Kontrola wersji programu Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Program Visual Studio 2022

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

Warunki wstępne

Aby użyć polecenia , ustaw uprawnienie etykiet Zezwalaj na. Aby zmodyfikować lub usunąć etykiety utworzone przez innych użytkowników, należy administrować etykietami ustawioną na Zezwalaj na. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

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ów

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 unikatowa. 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 po prostu juango do opcji /owner.

<itemspec>

Identyfikuje plik lub folder, z którego ma być etykieta, ponowne etykietowanie lub modyfikowanie. Aby uzyskać więcej informacji na temat analizowania itemspec w 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).

Nuta

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

<versionspec>

Udostępnia wartość, taką jak c2 dla opcji /version. 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ść opcji /login. Wartość nazwy użytkownika można określić 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

opcji

opis

/owner

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

/version

Fakultatywny. 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 kontrola wersji podstawowego obszaru roboczego korzysta z wersji podstawowego obszaru roboczego, jeśli nie podano versionspec.

/comment

Dodaje lub modyfikuje opis lub komentarz etykiety.

/child

Nie udokumentowane.

/recursive

Etykietuje wszystkie elementy w katalogu, które pasują do 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 punktów kontrolnych, 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 polecenie label, aktualizacja zostanie natychmiast odzwierciedlona na serwerze TFVC.

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

Usuwanie i usuwanie etykiet

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

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 Labels.

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 do zestawu 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 mają etykietę M3, możesz również zastosować etykietę M3 do plików w katalogu $/projects.

Aby uzyskać, usunąć etykietę lub zarządzać M3-labeled items, należy określić parametr @scope, aby poinformować tfVC, z którym M3 etykietę, z którą chcesz pracować.

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

Przykłady

Poniższy przykład dołącza etykietę goodbuild do wersji obszaru roboczego docs folderu 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 dokumentacji , ale nie do plików i folderów zawartych w folderze docs.

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