Polecenie obszaru roboczego (Kontrola wersji programu Team Foundation)
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) workspace umożliwia tworzenie, usuwanie, wyświetlanie lub modyfikowanie właściwości i mapowań skojarzonych z obszarem roboczym.
Warunki wstępne
- Aby zmodyfikować lub usunąć istniejący obszar roboczy, być właścicielem lub mieć uprawnienia globalne Administrowanie obszarami roboczymi ustawione na Zezwalaj na.
- Aby utworzyć obszar roboczy, ustaw uprawnienia globalne Tworzenie obszaru roboczegoZezwalaj na.
- Aby utworzyć obszary robocze dla innych użytkowników, ustaw uprawnienie Administrowanie obszarami roboczymiZezwalaj na.
Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.
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 polecenia workspace.
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ść opcji /computer. |
<comment> |
Udostępnia wartość opcji /comment. |
@<comment-file> |
Określa ścieżkę pliku, w którym powinien zostać odczytany komentarz. |
<username> |
Udostępnia wartość opcji /login. Tę wartość można określić jako DOMAIN\<username> lub <username>. |
<password> |
Udostępnia wartość opcji /login. |
<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ść opcji /newowner. |
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 lub administrować obszarem roboczym.
- Public Limited: każdy 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. Ta wartość jest wartością domyślną.
- 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 zaewidencjonować swoją pracę w bazie kodu zespołu, należy zatwierdzić 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 używania narzędzia wiersza polecenia tf, 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 Set up Team Foundation Version Control on your dev machine.
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. - Wybierz 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 pozycję OK.
Podczas tworzenia nowego obszaru roboczego można określić obszar roboczy szablonu w ramach opcji /new. 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 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.
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
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.
Nuta
Polecenia uruchamiane ręcznie wymagają opcji /noprompt pomijania potwierdzenia użytkownika. Należy zachować ostrożność, jeśli używasz metody Start() programu PowerShell do uruchamiania poleceń. Opcję /noprompt można ustawić automatycznie w programie PowerShell.
Podczas usuwania obszaru roboczego należy podać <workspace-owner> i <workspace-name>
Aby pobrać te wartości, możesz użyć polecenia workspace. Aby uzyskać więcej informacji, zobacz polecenie workspaces.
Aby znaleźć wartość <workspace-owner>, uruchom następujące polecenie:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Aby znaleźć wartość <workspace-name>, użyj wartości <OwnerId> z danych wyjściowych poprzedniego polecenia jako wartości <workspace-owner>. 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. Następnie 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
W poniższym przykładzie zostanie otwarte okno dialogowe Dodawanie obszaru roboczego i utworzenie nowego obszaru roboczego. Możesz użyć okna dialogowego Dodawanie obszaru roboczego, aby edytować folder 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. AdminWorkspaces uprawnienia do przypisywania własności nowego obszaru roboczego do innego użytkownika. Aby uzyskać więcej informacji na temat uprawnień zabezpieczeń, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.
c:\projects>tf workspace /new Beta1;jenh
Poniższy przykład tworzy nowy obszar roboczy przy użyciu obszaru roboczego
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
Poniższy przykład otwiera obszar roboczy Beta1 należący do jenh, aby zobaczyć jego właściwości i mapowania. Jeśli masz uprawnienie AdminWorkspaces, możesz zmienić właściwości i mapowania obszaru roboczego.
c:\projects> tf workspaces Beta1;jenh