Udostępnij za pośrednictwem

Polecenie folderu 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) workfold tworzy, modyfikuje lub wyświetla informacje o mapowaniach między folderami obszaru roboczego a folderami, które znajdują się na serwerze Usługi Azure DevOps dla serwera TFVC.

Wymagania wstępne

Aby użyć workfold polecenia, musisz być właścicielem określonego lub dorozumianego obszaru roboczego lub mieć uprawnienia globalne Administracja ster obszarów roboczych ustawione na Wartość Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

tf workfold <local-folder> [/login:<username>,[<password>]]

tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]

tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>

tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>] 
[/workspace:<workspace-name>][/login:<username>,[<password>]

tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] 
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]

tf workfold /cloak 
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]

tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]

Parametry

W poniższych sekcjach opisano argumenty i opcje workfold polecenia.

Argumenty

Argument

Opis

<workspace-name>

Określa nazwę obszaru roboczego, na którym działa polecenie z opcją /workspace .

<server-folder>

Określa nazwę folderu serwera usługi Azure DevOps.

<local-folder>

Określa nazwę folderu lokalnego.

<team-project-collection-url>

Adres URL kolekcji projektów, który zawiera foldery, które chcesz porównać z folderami serwera, na przykład https://myserver:8080/tfs/DefaultCollection/.

<username>

Udostępnia wartość /login opcji. Tę wartość można określić jako DOMAIN\<username> lub <username>.

<password>

Udostępnia wartość /login opcji.

Opcje

Opcja

Opis

/workspace

Określa nazwę obszaru roboczego do pracy.

/map

Określa skojarzenie między folderem lokalnym a folderem serwera usługi Azure DevOps. Domyślnie workfold polecenie używa tej opcji, nawet jeśli nieokreślone, chyba że /unmap/cloakokreślono , lub /decloak .

/unmap

Określa mapowanie folderów do usunięcia z obszaru roboczego.

/cloak

Określa, że folder powinien być wykluczony z jakichkolwiek akcji kontroli wersji, które są wykonywane w obszarze roboczym.

/decloak

Dekokuje folder, aby folder można było pobrać do obszaru roboczego.

/collection

Określa kolekcję projektów.

/login

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

Uwagi

Za pomocą workfold polecenia tf narzędzia wiersza polecenia można tworzyć i edytować mapowania obszarów roboczych. Mapowanie obszaru roboczego tworzy folder po stronie klienta, w którym podczas uruchamiania tfget operacji są pobierane wszystkie pliki i podfoldery w folderze serwera Usługi Azure DevOps. Operacja get nie działa, jeśli folder po stronie klienta jest zamaskowany.

Możesz również użyć gwiazdki (*) symbolu wieloznacznego, aby zamapować folder usługi Azure DevOps Server i jego bezpośrednie elementy do lokalnego obszaru roboczego. To mapowanie jest często określane jako pojedyncze mapowanie folderów.

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

Opcje mapowania obszaru roboczego

Mapowanie obszaru roboczego to lista aktywnych i zamaskowanych elementów. Elementy serwera usługi Azure DevOps można dodać do zamapowanej listy w obszarze roboczym przy użyciu /map opcji . Możesz również jawnie wykluczyć element z obszaru roboczego przy użyciu /cloak opcji . Można zamaskować tylko elementy, które mają zamapowany element nadrzędny. Cloaking to skuteczny sposób poprawy szybkości operacji wsadowych get i oszczędzania miejsca na dysku.

Użyj maskowania z dyskrecjami. Aby uniknąć problemów z kompilacją i integracją, należy zamaskować tylko te elementy, które wiesz, że znajdują się poza zakresem bieżących i przyszłych projektów, takich jak obrazy i pliki dokumentacji zewnętrznej.

Opcje i /decloak umożliwiają /unmap selektywne usuwanie zamapowanych i zamaskowanych wpisów z mapowania obszaru roboczego.

Jak są stosowane mapowania obszarów roboczych

Domyślnie mapowania obszarów roboczych są stosowane rekursywnie. Podczas mapowania folderu lokalnego na folder serwera usługi Azure DevOps system niejawnie tworzy mapowanie między wszystkimi jego bieżącymi i przyszłymi podfolderami.

Załóżmy na przykład, że mapujesz projekty $/projects na C:\projects. Następnie dodasz projekt o nazwie $/projects/project_one, a następnie uruchom polecenie get w obszarze roboczym. W tym scenariuszu funkcja TFVC automatycznie tworzy lokalny folder roboczy o nazwie project_one w katalogu C:\projects .

W poniższym przykładzie użyto gwiazdki (*) symbolu wieloznacznego, aby zamapować folder serwera i jego bezpośrednie elementy do lokalnego obszaru roboczego:

tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject

W poniższym przykładzie workfold użyto polecenia , aby zastąpić mapowanie, które jest automatycznie tworzone między elementami $/projects/project_one i C:\projects\project_one:

tf workfold $/projects/project_one C:\DifferentWorkfold

Mapowania pod płaszczami

Mapowania folderów rozpakowanych znajdujących się pod folderem zamaskowanym w hierarchii kontroli wersji można mapować na lokalny obszar roboczy.

Przykłady

W poniższym przykładzie przedstawiono mapowania obszaru roboczego, w którym znajdują się foldery c:\projects :

c:\projects>tf workfold

Poniższy przykład maskuje folder c:\projects\lib :

c:\projects>tf workfold /cloak c:\projects\lib

Poniższy przykład przedstawia mapowanie pliku lokalnego word.cs:

c:\projects>tf workfold word.cs

Poniższy przykład mapuje folder C:\DifferentWorkfold na folder serwera Usługi Azure DevOps $/projects/project_one i zastępuje poprzednie mapowanie obszaru roboczego dla folderu $/projects/project_one folderu serwera Usługi Azure DevOps:

c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold