Příkaz Workfold (Správa verzí Team Foundation)

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Příkaz Správa verzí Team Foundation (TFVC) workfold vytvoří, upraví nebo zobrazí informace o mapování mezi složkami pracovního prostoru a složkami, které jsou na serveru Azure DevOps pro TFVC.

Požadavky

Pokud chcete tento příkaz použítworkfold, musíte být vlastníkem zadaného nebo předpokládaného pracovního prostoru nebo mít globální oprávnění Správa ister workspaces nastaveno na Povolit. Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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

Následující části popisují argumenty a možnosti workfold příkazu.

Argumenty

Argument

Popis

<workspace-name>

Určuje název pracovního prostoru, se kterým příkaz pracuje s /workspace možností.

<server-folder>

Určuje název složky serveru Azure DevOps.

<local-folder>

Určuje název místní složky.

<team-project-collection-url>

Adresa URL kolekce projektů, která obsahuje složky, které chcete porovnat se složkami serveru, https://myserver:8080/tfs/DefaultCollection/například .

<username>

Poskytuje hodnotu možnosti /login . Tuto hodnotu můžete zadat buď nebo DOMAIN\<username><username>.

<password>

Poskytuje hodnotu možnosti /login .

Možnosti

Možnost

Popis

/workspace

Určuje název pracovního prostoru, ve které se má pracovat.

/map

Určuje přidružení mezi místní složkou a složkou serveru Azure DevOps. Ve výchozím nastavení workfold používá příkaz tuto možnost, i když není zadán, pokud /unmap/cloaknení zadán , nebo /decloak není zadán.

/unmap

Určuje mapování složek, které se má z pracovního prostoru odebrat.

/cloak

Určuje, že složka by měla být vyloučena z akcí správy verzí provedených v pracovním prostoru.

/decloak

Decloaksuje složku, aby ji bylo možné načíst do pracovního prostoru.

/collection

Určuje kolekci projektů.

/login

Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps.

Poznámky

Pomocí příkazu nástroje příkazového řádku můžete workfold vytvářet a upravovat mapování pracovních prostorů.tf Mapování pracovního prostoru vytvoří složku na straně klienta, do které se při spuštění tfget operace načtou všechny soubory a podsložky ve složce serveru Azure DevOps. Operace get nefunguje, pokud je složka na straně klienta zakrytá.

K mapování složky Azure DevOps Serveru a jejích okamžitých položek do místního pracovního prostoru můžete také použít zástupný znak hvězdičky (*). Toto mapování se často označuje jako mapování jedné složky.

Další informace o tom, jak používat nástroj příkazového tf řádku, naleznete v tématu Použití příkazů správy verzí Team Foundation.

Možnosti mapování pracovního prostoru

Mapování pracovního prostoru je seznam aktivních a maskovaných položek. Položky serveru Azure DevOps můžete přidat do mapovaného seznamu v pracovním prostoru pomocí této /map možnosti. Položku můžete z pracovního prostoru vyloučit také explicitně pomocí této /cloak možnosti. Položky, které mají namapované nadřazené položky, můžete pouze zavlepat. Cloaking je efektivní způsob, jak zlepšit rychlost dávkových get operací a ušetřit místo na disku.

Používejte cloaking s uvážením. Abyste se vyhnuli problémům s kompilací a integrací, měli byste zabalit jenom ty položky, které víte, že jsou mimo rozsah vašich aktuálních a budoucích projektů, jako jsou obrázky a externí soubory dokumentace.

Pomocí možností /unmap můžete /decloak selektivně odstranit mapované a cloaked položky z mapování pracovního prostoru.

Způsob použití mapování pracovních prostorů

Ve výchozím nastavení se mapování pracovních prostorů používá rekurzivně. Když mapujete místní složku do složky serveru Azure DevOps, systém implicitně vytvoří mapování mezi všemi jeho aktuálními a budoucími podsložkami.

Předpokládejme například, že mapujete $/projects na C:\projects. Dále přidáte projekt s názvem $/projects/project_one a pak spustíte get příkaz v pracovním prostoru. V tomto scénáři TFVC automaticky vytvoří místní pracovní složku s názvem project_one v adresáři C:\projects .

Následující příklad používá zástupný znak hvězdičky (*) k mapování složky serveru a jejích okamžitých položek do místního pracovního prostoru:

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

Následující příklad používá workfold příkaz k přepsání mapování, které se automaticky vytvoří mezi $/projects/project_one a C:\projects\project_one:

tf workfold $/projects/project_one C:\DifferentWorkfold

Mapování pod maskami

Mapování nezařazených složek, které jsou umístěné pod sklápěcí složkou v hierarchii správy verzí, lze mapovat na místní pracovní prostor.

Příklady

Následující příklad zobrazí mapování pracovního prostoru, ve kterém se nachází c:\projects :

c:\projects>tf workfold

Následující příklad zakryvuje složku c:\projects\lib :

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

Následující příklad zobrazí mapování místního souboru word.cs:

c:\projects>tf workfold word.cs

Následující příklad mapuje složku C:\DifferentWorkfold do složky serveru Azure DevOps $/projects/project_one a nahradí předchozí mapování pracovního prostoru pro složku serveru $/projects/project_one Serveru Azure DevOps:

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