Polecenie obszaru roboczego (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) 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:

  1. Wprowadź tf workspace <workspace-name>, gdzie <workspace-name> jest nazwą istniejącego obszaru roboczego. Zostanie wyświetlone okno dialogowe Edytowanie obszaru roboczego .
  2. Kliknij tutaj, aby wprowadzić nowy folder roboczy.
  3. W polu Folder kontroli źródła wprowadź ścieżkę serwera, do której chcesz zamapować bieżący katalog.
  4. W polu Folder lokalny wprowadź bieżący katalog.
  5. 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