Polecenie folderu 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) 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 Administrowanie obszarami roboczymi ustawione na 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 tf get 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