Munkaterület parancs (Team Foundation verziókövetés)
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:
- Adja meg
tf workspace <workspace-name>a<workspace-name>meglévő munkaterület nevét. Megjelenik a Munkaterület szerkesztése párbeszédpanel. - Kattintson ide egy új munkamappa megadásához.
- 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.
- A Helyi mappa mezőbe írja be az aktuális könyvtárat.
- 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