Příkaz Workfold (Správa verzí Team Foundation)
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žít workfold , musíte být vlastníkem zadaného nebo předpokládaného pracovního prostoru nebo mít globální oprávnění Spravovat pracovní prostory nastavené 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í tf get 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