Megosztás a következőn keresztül:

Munkaterület parancs (Team Foundation verziókövetés)

  • Cikk

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

Visual Studio 2019 | Visual Studio 2022

A Team Foundation Version Control (TFVC) workspace parancs lehetővé teszi a munkaterülethez társított tulajdonságok és leképezések létrehozását, törlését, megtekintését vagy módosítását.

Előfeltételek

  • Meglévő munkaterület módosításához vagy törléséhez a tulajdonosnak kell lennie, vagy engedélyeznie kell a globális Rendszergazda ister munkaterületek engedélyét.
  • Munkaterület létrehozásához engedélyeznie kell a globális munkaterület-létrehozási jogosultságot.
  • Ha más felhasználók számára szeretne munkaterületeket létrehozni, engedélyeznie kell a munkaterületek Rendszergazda ister engedélyét.

További információ: Alapértelmezett TFVC-engedélyek.

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)]

Paraméterek

A következő szakaszok a workspace parancs argumentumait és beállításait ismertetik.

Argumentumok

Argumentum Leírás
<workspace-name> Megadja annak a munkaterületnek a nevét, amelyről adatokat szeretne létrehozni, szerkeszteni, törölni vagy megjeleníteni.
<workspace-owner> Megadja a munkaterület felhasználónevét. Ez a paraméter akkor szükséges, ha a munkaterület tulajdonosa nem az a személy, aki végrehajtja a parancsot.
<computer-name> Értéket ad a /computer beállításnak.
<comment> Értéket ad a /comment beállításnak.
@<comment-file> Megadja annak a fájlnak az elérési útját, amelyben a megjegyzést el kell olvasni.
<username> Értéket ad a /login beállításnak. Ezt az értéket megadhatja a következőképpen: DOMAIN\<username> vagy <username>.
<password> Értéket ad a /login beállításnak.
<team-project-collection-url> Annak a projektgyűjteménynek az URL-címe, amely tartalmazza a létrehozni, szerkeszteni, törölni vagy megjeleníteni kívánt munkaterületet, például https://myserver:8080/tfs/DefaultCollection.
<owner-name> Értéket ad a /newowner beállításnak.

Beállítások

Lehetőség Leírás
/new Új munkaterületet hoz létre.
/template Egy meglévő munkaterületet határoz meg, amelyet sablonként szeretne használni egy új munkaterület létrehozásához. Az új munkaterület a meglévő munkaterület leképezéseit használja.
/delete Törli a megadott munkaterületet.
/computer Megadja annak a számítógépnek a nevét, amelyen munkaterületet szeretne létrehozni. Ez a beállítás egy speciális lehetőség.
/comment A munkaterületet leíró megjegyzést tartalmaz.
/newname Átnevez egy meglévő munkaterületet.
/noprompt Párbeszédpanel megjelenítése nélkül hajtja végre a megadott munkaterületi parancsot.
/collection A projektgyűjteményt adja meg.
/permission Megadja a munkaterület engedélyeinek beállításait:

    - Private: Csak a tulajdonosok használhatják, ellenőrizhetik a munkaterület fájljait, vagy felügyelhetik a munkaterületet.


    - Public Limited: Bármely érvényes felhasználó használhatja a munkaterületet. De csak a tulajdonosok adhatnak be fájlokat a munkaterülethez, vagy felügyelhetik a fájlokat.


    - Public: Bármely érvényes felhasználó használhatja, beadhatja a munkaterület fájljait, vagy felügyelheti a munkaterületet.
/location A munkaterület létrehozásának helyét adja meg:

    - local: Az ügyfélszámítógépen. Ez az érték az alapértelmezett érték.


    - server: Az Azure DevOps-kiszolgálón.
/login Megadja a felhasználó Azure DevOpsszal való hitelesítéséhez használt felhasználónevet és jelszót.
/newowner Megadja a munkaterület új tulajdonosának felhasználónevét.

Megjegyzések

A munkaterület a kiszolgálón lévő fájlok és mappák helyi másolata, valamint a helyi módosítások. Ha bármilyen verzió által vezérelt elemet ad hozzá, szerkeszt, töröl, átnevez vagy más módon módosít, a módosítások elkülönítve lesznek a munkaterületen, ahol elvégezheti és tesztelheti a módosításokat. Amikor bejelentkezik a munkájába a csapat kódbázisában, véglegesíti a módosításokat a kiszolgálón. Elérhetővé válnak a munkaterületen kívüli felhasználók számára.

A parancssori segédprogram használatáról további információt a tf Team Foundation verziókövetési parancsainak használata című témakörben talál.

Munkaterület létrehozása

Mielőtt fájlokat vehet fel a verziókövetési kiszolgálóra, vagy ki kell vennie a kiszolgáló elemeit, létre kell hoznia egy munkaterületet, vagy társítania kell egy meglévőt az aktuális címtárral. További információ: A Team Foundation verziókövetésének beállítása a fejlesztői gépen.

Ha az aktuális könyvtárat egy meglévő munkaterület munkamappájává szeretné tenni a számítógépen, kövesse az alábbi lépéseket:

  1. Adja meg tf workspace <workspace-name>a <workspace-name> meglévő munkaterület nevét. Megjelenik a Munkaterület szerkesztése párbeszédpanel.
  2. Kattintson ide egy új munkamappa megadásához.
  3. A Forrásvezérlő mappa mezőbe írja be azt a kiszolgálói útvonalat, amelyhez le szeretné képezni az aktuális könyvtárat.
  4. A Helyi mappa mezőbe írja be az aktuális könyvtárat.
  5. Kattintson az OK gombra.

Új munkaterület létrehozásakor a beállítás részeként megadhatja a /new sablon-munkaterületet. Amikor sablon-munkaterületet ad meg, a TFVC létrehoz egy új munkaterületet az aktuális számítógépen. A TFVC emellett beállítja a tulajdonost az aktuális tulajdonosra, és replikálja a következő munkaterület-tulajdonságokat az új munkaterületre a sablon-munkaterületről: mappings és comment. Ha nincs megadva név, a rendszer az aktuális számítógépnéven alapuló nevet használ. Amikor sablonnal hoz létre munkaterületet, a TFVC nem kéri le a kiszolgálóról leképezendő fájlokat. get A paranccsal szinkronizálhatja az új munkaterületet a kiszolgáló legújabb verziójával. További információt a Get command (Parancs lekérése) című témakörben talál.

Egyetlen mappaleképezés

Dönthet úgy, hogy csak a verziókövetési mappa közvetlen gyermekeit rendeli egy helyi munkaterülethez. Ehhez vegyen fel egy csillag (*) helyettesítő karaktert a Forrásvezérlő mappa mezőjébe a Munkaterület hozzáadása párbeszédpanelen, például $/folder/*. Ellenkező esetben alapértelmezés szerint a verziókövetési mappa összes gyermeke rekurzív módon van leképezve a helyi munkaterületre.

A verziókövetési hierarchián belüli egyetlen mappaleképezés azért hasznos, mert korlátozza az ügyfélszámítógépre letöltött elemek számát. A letöltött fájlok korlátozásának másik módja, ha olyan fájlokat takar, amelyeket nem kell a munkaterületen töltenie. További információ: A munkaterület optimalizálása. Ez a módszer gyorsabb letöltési időt biztosít, és lemezterületet takarít meg az ügyfélszámítógépen.

Munkaterület törlése

Ha függőben lévő módosításokat tartalmazó munkaterületet töröl, a TFVC a törlési folyamat részeként megszakítja a függőben lévő módosításokat. A munkaterület törlése nem törli a munkaterületen lévő ügyfélszámítógép fájljait és mappáit.

Feljegyzés

A manuálisan futtatott parancsokhoz meg kell adni a /noprompt felhasználói nyugtázás megkerülését. Legyen óvatos, ha a PowerShell-metódust Start() használja a parancsok futtatásához. A /noprompt beállítás automatikusan beállítható a PowerShellben.

Munkaterület törlésekor meg kell adnia a <workspace-owner><workspace-name>

A parancs használatával workspace lekérheti ezeket az értékeket. További információ: Munkaterületek parancs. Az <workspace-owner> érték megkereséséhez futtassa a következő parancsot:

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

Az <workspace-name> érték megkereséséhez használja az <OwnerId> előző parancs kimenetének értékét értékként <workspace-owner> . Ez az érték egy Azure Active Directory -objektumazonosító (Azure AD) formátumával rendelkezik, amelyet egy fordított perjel és egy egyszerű felhasználónév követ. Használja a teljes értéket. Ezt követően futtassa a következő parancsot:

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

A munkaterület törléséhez futtassa a következő parancsot:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Munkaterület szerkesztése

A munkaterület alábbi attribútumait módosíthatja:

  • Munkaterület neve
  • Megjegyzés
  • Munkamappa-leképezések

Ha nincs megadva munkaterület-specifikáció, a rendszer az aktuális mappa munkaterületét használja.

Példák

Az alábbi példa megnyitja a Munkaterület hozzáadása párbeszédpanelt, és létrehoz egy új munkaterületet. A Munkaterület hozzáadása párbeszédpanelen szerkesztheti a forrásvezérlő mappát, a tulajdonost, a számítógépet, a megjegyzést és a helyi mappákat.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

Az alábbi példa létrehoz egy béta1 nevű új munkaterületet, és jenh-t rendel hozzá a munkaterület tulajdonosához. Rendelkeznie kell a Rendszergazda Workspaces engedélyével ahhoz, hogy egy új munkaterület tulajdonjogát egy másik felhasználóhoz rendelje. A biztonsági engedélyekkel kapcsolatos további információkért lásd az alapértelmezett TFVC-engedélyeket.

c:\projects>tf workspace /new Beta1;jenh

Az alábbi példa egy új munkaterületet hoz létre a Jenh által sablonként birtokolt Beta1 munkaterület használatával:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

Az alábbi példa eltávolítja a Béta1 munkaterületet a kiszolgálóról:

c:\projects>tf workspace /delete Beta1

Az alábbi példa az aktuális munkaterület tulajdonságait szerkessze:

c:\projects>tf workspace

Az alábbi példa megnyitja a Jenh tulajdonában lévő Beta1-munkaterületet, hogy láthassa annak tulajdonságait és leképezéseit. Ha rendelkezik a Rendszergazda Workspaces engedéllyel, módosíthatja a munkaterület tulajdonságait és leképezéseit.

c:\projects> tf workspaces Beta1;jenh