Příkaz Pracovního prostoru (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) 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

  • Pokud chcete upravit nebo odstranit existující pracovní prostor, musíte být vlastníkem nebo mít oprávnění globálního Správa ister workspaces nastavená na Povolit.
  • Pokud chcete vytvořit pracovní prostor, musíte mít globální oprávnění k vytvoření pracovního prostoru nastavené na Povolit.
  • Pokud chcete vytvářet pracovní prostory pro ostatní uživatele, musíte mít oprávnění Správa ister workspaces nastavená na Povolit.

Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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 workspace příkazu.

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 možnosti /computer .
<comment> Poskytuje hodnotu možnosti /comment .
@<comment-file> Určuje cestu k souboru, do kterého se má komentář číst.
<username> Poskytuje hodnotu možnosti /login . Tuto hodnotu můžete zadat buď nebo DOMAIN\<username><username>.
<password> Poskytuje hodnotu možnosti /login .
<team-project-collection-url> Adresa URL kolekce projektů, která obsahuje pracovní prostor, který chcete vytvořit, upravit, odstranit nebo zobrazit informace, například https://myserver:8080/tfs/DefaultCollection.
<owner-name> Poskytuje hodnotu možnosti /newowner .

Možnosti

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: Libovolný platný uživatel může pracovní prostor používat. 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. Při vrácení práce do základu kódu týmu potvrdíte změny na server. Zpřístupní se ostatním uživatelům mimo váš pracovní prostor.

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.

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áva 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:

  1. Zadejte tf workspace <workspace-name>, kde <workspace-name> je název existujícího pracovního prostoru. Zobrazí se dialogové okno Upravit pracovní prostor .
  2. Kliknutím sem zadáte novou pracovní složku.
  3. Do pole Složka správy zdrojového kódu zadejte cestu k serveru, na kterou chcete namapovat aktuální adresář.
  4. Do pole Místní složka zadejte aktuální adresář.
  5. Vyberte OK.

Při vytváření nového pracovního prostoru můžete jako součást /new této možnosti 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. get Pomocí příkazu 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 přidáte zástupný znak hvězdičky (*) do pole Složka správy zdrojového kódu v dialogovém okně Přidat pracovní prostor , $/folder/*například . 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í /noprompt možnost obejít potvrzení uživatele. Pokud ke spouštění příkazů používáte metodu PowerShellu Start() , buďte opatrní. Tuto /noprompt možnost je možné automaticky nastavit v PowerShellu.

Při odstraňování pracovního prostoru je potřeba zadat <workspace-owner><workspace-name>

Tyto hodnoty můžete načíst pomocí workspace příkazu. Další informace najdete v příkazu pracovní prostory. Hodnotu najdete <workspace-owner> spuštěním následujícího příkazu:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Pokud chcete tuto hodnotu najít <workspace-name> , použijte <OwnerId> jako hodnotu hodnotu hodnotu z výstupu <workspace-owner> předchozího příkazu. 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. Dialogové okno Přidat pracovní prostor můžete použít k úpravě složky správy zdrojového kódu, vlastníka, počítače, komentáře a místních složek.

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. Abyste mohli přiřadit vlastnictví nového pracovního prostoru jinému uživateli, musíte mít oprávnění Správa Workspaces. 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 pracovní prostor Beta1 ze serveru:

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 vlastněný jenhem , abyste viděli jeho vlastnosti a mapování. Pokud máte oprávnění Správa Workspaces, můžete změnit vlastnosti a mapování pracovního prostoru.

c:\projects> tf workspaces Beta1;jenh