Polecenie obszaru roboczego (Kontrola wersji serwera Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Polecenie Kontrola wersji serwera Team Foundation (TFVC) workspace umożliwia tworzenie, usuwanie, wyświetlanie lub modyfikowanie właściwości i mapowań skojarzonych z obszarem roboczym.
Wymagania wstępne
- Aby zmodyfikować lub usunąć istniejący obszar roboczy, musisz być właścicielem lub mieć uprawnienia globalne Administracja ster obszarów roboczych ustawione na Wartość Zezwalaj.
- Aby utworzyć obszar roboczy, musisz mieć globalne uprawnienie Tworzenie obszaru roboczego na wartość Zezwalaj.
- Aby utworzyć obszary robocze dla innych użytkowników, musisz mieć uprawnienie Administracja ister workspaces ustawione na Zezwalaj.
Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.
Składnia
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
Parametry
W poniższych sekcjach opisano argumenty i opcje workspace polecenia.
Argumenty
| Argument | opis |
|---|---|
<workspace-name> |
Określa nazwę obszaru roboczego, który chcesz utworzyć, edytować, usunąć lub wyświetlić informacje o. |
<workspace-owner> |
Określa nazwę użytkownika obszaru roboczego. Ten parametr jest wymagany, gdy właściciel obszaru roboczego nie jest osobą wykonującą polecenie. |
<computer-name> |
Udostępnia wartość /computer opcji. |
<comment> |
Udostępnia wartość /comment opcji. |
@<comment-file> |
Określa ścieżkę pliku, w którym powinien zostać odczytany komentarz. |
<username> |
Udostępnia wartość /login opcji. Tę wartość można określić jako DOMAIN\<username> lub <username>. |
<password> |
Udostępnia wartość /login opcji. |
<team-project-collection-url> |
Adres URL kolekcji projektów, który zawiera obszar roboczy, który chcesz utworzyć, edytować, usunąć lub wyświetlić informacje o, na przykład https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Udostępnia wartość /newowner opcji. |
Opcje
| Opcja | Opis |
|---|---|
/new |
Tworzy nowy obszar roboczy. |
/template |
Określa istniejący obszar roboczy do użycia jako szablon do tworzenia nowego obszaru roboczego. Nowy obszar roboczy używa mapowań istniejącego obszaru roboczego. |
/delete |
Usuwa określony obszar roboczy. |
/computer |
Określa nazwę komputera, na którym ma zostać utworzony obszar roboczy. Ta opcja jest opcją zaawansowaną. |
/comment |
Zawiera komentarz opisujący obszar roboczy. |
/newname |
Zmienia nazwę istniejącego obszaru roboczego. |
/noprompt |
Wykonuje określone polecenie obszaru roboczego bez wyświetlania okna dialogowego. |
/collection |
Określa kolekcję projektów. |
/permission |
Określa opcje uprawnień obszaru roboczego:
Private: Tylko właściciele mogą używać, ewidencjonować pliki do lub administrować obszarem roboczym.- Public Limited: Dowolny prawidłowy użytkownik może używać obszaru roboczego. Ale tylko właściciele mogą ewidencjonować pliki do obszaru roboczego lub administrować nim.- Public: Dowolny prawidłowy użytkownik może używać, ewidencjonować pliki lub administrować obszarem roboczym. |
/location |
Określa miejsce utworzenia obszaru roboczego:
local: na komputerze klienckim. Jest to wartość domyślna.- server: na serwerze Usługi Azure DevOps. |
/login |
Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps. |
/newowner |
Określa nazwę użytkownika nowego właściciela obszaru roboczego. |
Uwagi
Obszar roboczy to lokalna kopia plików i folderów na serwerze oraz wszelkie zmiany wprowadzone lokalnie. Podczas dodawania, edytowania, usuwania, przenoszenia, zmieniania nazwy lub zmiany dowolnego elementu kontrolowanego przez wersję zmiany są izolowane w obszarze roboczym, w którym można wprowadzać i testować zmiany. Gdy zaewidencjonujesz swoją pracę w bazie kodu zespołu, zatwierdź zmiany na serwerze. Stają się one dostępne dla innych użytkowników, którzy znajdują się poza obszarem roboczym.
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).
Tworzenie obszaru roboczego
Aby można było dodać pliki do serwera kontroli wersji lub wyewidencjonować elementy na serwerze, należy utworzyć obszar roboczy lub skojarzyć istniejący z bieżącym katalogiem. Aby uzyskać więcej informacji, zobacz Konfigurowanie Kontrola wersji serwera Team Foundation na maszynie dewelopera.
Aby ustawić bieżący katalog jako folder roboczy dla istniejącego obszaru roboczego na komputerze, wykonaj następujące kroki:
- Wprowadź
tf workspace <workspace-name>, gdzie<workspace-name>jest nazwą istniejącego obszaru roboczego. Zostanie wyświetlone okno dialogowe Edytowanie obszaru roboczego . - Kliknij tutaj, aby wprowadzić nowy folder roboczy.
- W polu Folder kontroli źródła wprowadź ścieżkę serwera, do której chcesz zamapować bieżący katalog.
- W polu Folder lokalny wprowadź bieżący katalog.
- Wybierz przycisk OK.
Podczas tworzenia nowego obszaru roboczego możesz określić obszar roboczy szablonu /new jako część opcji. Po określeniu obszaru roboczego szablonu serwer TFVC tworzy nowy obszar roboczy na bieżącym komputerze. Funkcja TFVC ustawia również właściciela na bieżącego właściciela i replikuje następujące właściwości obszaru roboczego do nowego obszaru roboczego z obszaru roboczego szablonu: mappings i comment. Jeśli żadna nazwa nie zostanie określona, system używa nazwy opartej na bieżącej nazwie komputera. Podczas tworzenia obszaru roboczego przy użyciu szablonu funkcja TFVC nie pobiera plików mapowane z serwera. Użyj polecenia , get aby zsynchronizować nowy obszar roboczy z najnowszą wersją na serwerze. Aby uzyskać więcej informacji, zobacz Get command (Uzyskiwanie polecenia).
Mapowanie pojedynczego folderu
Możesz mapować tylko bezpośrednie elementy podrzędne folderu kontroli wersji na lokalny obszar roboczy. W tym celu dodaj gwiazdkę (*) symbol wieloznaczny w polu Folder kontroli źródła w oknie dialogowym Dodawanie obszaru roboczego , na przykład $/folder/*. W przeciwnym razie wszystkie elementy podrzędne folderu kontroli wersji są rekursywnie mapowane na lokalny obszar roboczy.
Mapowanie pojedynczego folderu w hierarchii kontroli wersji jest przydatne, ponieważ ogranicza liczbę elementów pobranych do komputera klienckiego. Innym sposobem ograniczenia pobranych plików jest sklonowanie plików, które nie są potrzebne w obszarze roboczym. Aby uzyskać więcej informacji, zobacz Optymalizowanie obszaru roboczego. Takie podejście zapewnia krótszy czas pobierania i oszczędza miejsce na dysku na komputerze klienckim.
Usuwanie obszaru roboczego
Jeśli usuniesz obszar roboczy, który zawiera oczekujące zmiany, program TFVC anuluje oczekujące zmiany w ramach procesu usuwania. Usunięcie obszaru roboczego nie powoduje usunięcia plików i folderów na komputerze klienckim, które znajdowały się w tym obszarze roboczym.
Uwaga
Polecenia uruchamiane ręcznie wymagają /noprompt opcji obejścia potwierdzenia użytkownika. Należy zachować ostrożność, jeśli używasz metody programu PowerShell Start() do uruchamiania poleceń. Tę /noprompt opcję można ustawić automatycznie w programie PowerShell.
Podczas usuwania obszaru roboczego należy podać element <workspace-owner> i <workspace-name>
Możesz użyć workspace polecenia , aby pobrać te wartości. Aby uzyskać więcej informacji, zobacz polecenie obszary robocze.
Aby znaleźć <workspace-owner> wartość, uruchom następujące polecenie:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Aby znaleźć <workspace-name> wartość, użyj <OwnerId> wartości z danych wyjściowych poprzedniego polecenia jako <workspace-owner> wartości. Ta wartość ma format identyfikatora obiektu usługi Azure Active Directory (Azure AD), po którym następuje ukośnik odwrotny i główna nazwa użytkownika. Użyj całej wartości. Uruchom następujące polecenie:
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
Aby usunąć obszar roboczy, uruchom następujące polecenie:
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
Edytowanie obszaru roboczego
Możesz zmienić następujące atrybuty obszaru roboczego:
- Nazwa obszaru roboczego
- Komentarz
- Mapowania folderów roboczych
Jeśli nie podano żadnej specyfikacji obszaru roboczego, używany jest obszar roboczy bieżącego folderu.
Przykłady
Poniższy przykład otwiera okno dialogowe Dodawanie obszaru roboczego i tworzy nowy obszar roboczy. Okno dialogowe Dodawanie obszaru roboczego umożliwia edytowanie folderu kontroli źródła, właściciela, komputera, komentarza i folderów lokalnych.
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
Poniższy przykład tworzy nowy obszar roboczy o nazwie Beta1 i przypisuje jenh jako właściciel obszaru roboczego. Musisz mieć uprawnienie Administracja Workspaces, aby przypisać własność nowego obszaru roboczego innemu użytkownikowi. Aby uzyskać więcej informacji na temat uprawnień zabezpieczeń, zobacz Domyślne uprawnienia serwera TFVC.
c:\projects>tf workspace /new Beta1;jenh
Poniższy przykład tworzy nowy obszar roboczy przy użyciu obszaru roboczego Beta1 należącego do narzędzia jenh jako szablonu:
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
Poniższy przykład usuwa obszar roboczy Beta1 z serwera:
c:\projects>tf workspace /delete Beta1
Poniższy przykład umożliwia edytowanie właściwości bieżącego obszaru roboczego:
c:\projects>tf workspace
W poniższym przykładzie zostanie otwarty obszar roboczy Beta1 , który jest własnością narzędzia jenh , aby zobaczyć jego właściwości i mapowania. Jeśli masz uprawnienie Administracja Workspaces, możesz zmienić właściwości i mapowania obszaru roboczego.
c:\projects> tf workspaces Beta1;jenh