Příkaz Pracovní prostor (Správa verzí Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Příkaz TFVC (Team Foundation Version Control) workspace poskytuje způsob, jak vytvořit, odstranit, zobrazit nebo upravit vlastnosti a mapování, které jsou přidružené k pracovnímu prostoru.
Požadavky
- Chcete-li upravit nebo odstranit existující pracovní prostor, buď vlastníkem nebo mít globální Spravovat pracovní prostory oprávnění nastavena na Povolit.
- Pokud chcete vytvořit pracovní prostor, nastavte globální Vytvořit pracovní prostor oprávnění na Povolit.
- Pokud chcete vytvářet pracovní prostory pro ostatní uživatele, nastavte oprávnění Správa pracovních prostorů na Povolit.
Další informace najdete v tématu Výchozí oprávnění TFVC.
Syntax
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
Následující části popisují argumenty a možnosti příkazu workspace.
Argumenty
| Argument | Popis |
|---|---|
<workspace-name> |
Určuje název pracovního prostoru, který chcete vytvořit, upravit, odstranit nebo zobrazit informace o něm. |
<workspace-owner> |
Určuje uživatelské jméno pro pracovní prostor. Tento parametr se vyžaduje, když vlastník pracovního prostoru není osoba, která příkaz provádí. |
<computer-name> |
Poskytuje hodnotu /computer možnosti. |
<comment> |
Poskytuje hodnotu /comment možnosti. |
@<comment-file> |
Určuje cestu k souboru, do kterého se má komentář číst. |
<username> |
Poskytuje hodnotu /login možnosti. Tuto hodnotu můžete zadat buď jako DOMAIN\<username>, nebo jako <username>. |
<password> |
Poskytuje hodnotu /login možnosti. |
<team-project-collection-url> |
Adresa URL kolekce projektů, která obsahuje pracovní prostor, který chcete vytvořit, upravit, odstranit nebo zobrazit informace o https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Poskytuje hodnotu /newowner možnosti. |
Volby
| Možnost | Popis |
|---|---|
/new |
Vytvoří nový pracovní prostor. |
/template |
Určuje existující pracovní prostor, který se má použít jako šablona pro vytvoření nového pracovního prostoru. Nový pracovní prostor používá mapování existujícího pracovního prostoru. |
/delete |
Odstraní zadaný pracovní prostor. |
/computer |
Určuje název počítače, na kterém se má pracovní prostor vytvořit. Tato možnost je rozšířená. |
/comment |
Poskytuje komentář, který popisuje pracovní prostor. |
/newname |
Přejmenuje existující pracovní prostor. |
/noprompt |
Provede zadaný příkaz pracovního prostoru bez zobrazení dialogového okna. |
/collection |
Určuje kolekci projektů. |
/permission |
Určuje možnosti oprávnění pracovního prostoru:
Private: Pracovní prostor můžou používat, vrátit se změnami nebo spravovat jenom vlastníci.
- Public Limited: Pracovní prostor může používat libovolný platný uživatel. Pracovní prostor ale můžou vrátit se změnami nebo spravovat jenom vlastníci.
- Public: Libovolný platný uživatel může použít, vrátit soubory se změnami nebo spravovat pracovní prostor. |
/location |
Určuje, kde se pracovní prostor vytvoří:
local: Na klientském počítači. Tato hodnota je výchozí.
- server: Na serveru Azure DevOps. |
/login |
Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps. |
/newowner |
Určuje uživatelské jméno nového vlastníka pracovního prostoru. |
Poznámky
Pracovní prostor je místní kopie souborů a složek na serveru a všechny změny, které jste provedli místně. Když přidáte, upravíte, odstraníte, přesunete, přejmenujete nebo jinak změníte libovolnou položku řízenou verzí, budou vaše změny v pracovním prostoru izolované, kde můžete provádět a testovat změny. Když vrátit práci do týmového základu kódu, potvrdíte změny na server. Zpřístupní se ostatním uživatelům mimo váš pracovní prostor.
Další informace o použití nástroje příkazového řádku tf naleznete v tématu Použití příkazů správy verzí Team Foundation.
Vytvoření pracovního prostoru
Než budete moct přidat soubory na server správy verzí nebo rezervovat položky na serveru, musíte vytvořit pracovní prostor nebo přidružit existující k aktuálnímu adresáři. Další informace najdete v tématu Nastavení správy verzí Team Foundation na vývojovém počítači.
Chcete-li nastavit aktuální adresář jako pracovní složku pro existující pracovní prostor v počítači, postupujte takto:
- Zadejte
tf workspace <workspace-name>, kde<workspace-name>je název existujícího pracovního prostoru. Zobrazí se dialogové okno Upravit pracovní prostor. - Vyberte kliknutím sem zadejte novou pracovní složku.
- Do pole složka správy zdrojového kódu zadejte cestu k serveru, na kterou chcete namapovat aktuální adresář.
- Do pole Místní složka zadejte aktuální adresář.
- Vyberte OK.
Při vytváření nového pracovního prostoru můžete jako součást možnosti /new zadat pracovní prostor šablony . Když zadáte pracovní prostor šablony, TFVC vytvoří v aktuálním počítači nový pracovní prostor. TFVC také nastaví vlastníka na aktuálního vlastníka a replikuje následující vlastnosti pracovního prostoru do nového pracovního prostoru z pracovního prostoru šablony: mappings a comment. Pokud není zadaný žádný název, systém použije název založený na aktuálním názvu počítače. Když vytvoříte pracovní prostor pomocí šablony, TFVC nenačte soubory, na které se mapuje ze serveru. Pomocí příkazu get synchronizujte nový pracovní prostor s nejnovější verzí na serveru. Další informace naleznete v tématu Získat příkaz.
Mapování jedné složky
Můžete se rozhodnout namapovat pouze bezprostřední podřízené položky složky správy verzí do místního pracovního prostoru. Uděláte to tak, že do pole Složka správy zdrojového kódu přidáte zástupný znak hvězdičky (*) v dialogovém okně Přidat pracovní prostor, například $/folder/*. Jinak se ve výchozím nastavení všechny podřízené položky složky správy verzí rekurzivně mapují na místní pracovní prostor.
Mapování jedné složky v hierarchii správy verzí je užitečné, protože omezuje počet položek stažených do klientského počítače. Dalším způsobem, jak omezit stažené soubory, je zakrýt soubory, které nemusíte mít ve svém pracovním prostoru. Další informace najdete v tématu Optimalizace pracovního prostoru. Tento přístup umožňuje rychlejší stahování a šetří místo na disku v klientském počítači.
Odstranění pracovního prostoru
Pokud odstraníte pracovní prostor, který obsahuje čekající změny, TFVC zruší čekající změny v rámci procesu odstranění. Odstranění pracovního prostoru neodstraní soubory a složky v klientském počítači, který byl v tomto pracovním prostoru.
Poznámka
Příkazy, které se spouští ručně, vyžadují možnost /noprompt k obejití potvrzení uživatele. Pokud ke spouštění příkazů používáte Start() metodu PowerShellu, buďte opatrní. Možnost /noprompt lze v PowerShellu nastavit automaticky.
Při odstraňování pracovního prostoru je potřeba zadat <workspace-owner> a <workspace-name>
Tyto hodnoty můžete načíst pomocí příkazu workspace. Další informace najdete v tématu příkaz pracovních prostorů.
Pokud chcete najít hodnotu <workspace-owner>, spusťte následující příkaz:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Pokud chcete najít <workspace-name> hodnotu, použijte hodnotu <OwnerId> z výstupu předchozího příkazu jako hodnotu <workspace-owner>. Tato hodnota má formát ID objektu Azure Active Directory (Azure AD), za kterým následuje zpětné lomítko a hlavní název uživatele. Použijte celou hodnotu. Pak spusťte následující příkaz:
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
Pokud chcete pracovní prostor odstranit, spusťte následující příkaz:
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
Úprava pracovního prostoru
Můžete změnit následující atributy pracovního prostoru:
- Název pracovního prostoru
- Komentář
- Mapování pracovních složek
Pokud není k dispozici žádná specifikace pracovního prostoru, použije se pracovní prostor pro aktuální složku.
Příklady
Následující příklad otevře dialogové okno Přidat pracovní prostor a vytvoří nový pracovní prostor. Pomocí dialogového okna Přidat pracovní prostor můžete upravit složku správy zdrojového kódu, vlastníka, počítače, komentáře a místní složky.
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
Následující příklad vytvoří nový pracovní prostor s názvem Beta1 a přiřadí jenh jako vlastníka pracovního prostoru. Mít oprávnění AdminWorkspaces přiřadit vlastnictví nového pracovního prostoru jinému uživateli. Další informace o oprávněních zabezpečení naleznete v tématu Výchozí oprávnění TFVC.
c:\projects>tf workspace /new Beta1;jenh
Následující příklad vytvoří nový pracovní prostor pomocí pracovního prostoru Beta1, který vlastní jenh jako šablonu:
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
Následující příklad odebere ze serveru pracovní prostor Beta1:
c:\projects>tf workspace /delete Beta1
Následující příklad upraví vlastnosti aktuálního pracovního prostoru:
c:\projects>tf workspace
Následující příklad otevře pracovní prostor Beta1, který vlastní jenh, abyste viděli jeho vlastnosti a mapování. Pokud máte oprávnění AdminWorkspaces, můžete změnit vlastnosti a mapování pracovního prostoru.
c:\projects> tf workspaces Beta1;jenh
Související články
- Optimalizace pracovního prostoru
- použití příkazů pro správu verzí Team Foundation
- příkaz pracovních prostorů
- Vytvoření a práce s pracovními prostory
- nastavení správy verzí Team Foundation na vývojovém počítači