Polecenie Obszary robocze (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Program Visual Studio 2022
Narzędzie Team Foundation Version Control (TFVC) workspaces polecenie wyświetla informacje o obszarach roboczych w systemie i aktualizuje buforowane informacje o zmianie nazwy użytkownika lub komputera na serwerze Usługi Azure DevOps.
Warunki wstępne
Aby użyć polecenia workspaces, ustaw uprawnienie Odczyt na Zezwalaj na. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.
Składnia
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
Parametry
W poniższych sekcjach opisano argumenty i opcje polecenia workspaces.
Argumenty
argumentów
opis
<owner-name>
Udostępnia wartość opcji /owner. Użyj pustego ciągu (""), aby dopasować obszary robocze utworzone przez dowolnego użytkownika.
<computer-name>
Udostępnia wartość opcji /computer. Użyj pustego ciągu (""), aby dopasować obszary robocze na dowolnym komputerze.
<workspace-name>
Określa nazwę obszaru roboczego do wyświetlania informacji. Jeśli wartość nie zostanie określona, zostaną wyświetlone informacje o wszystkich obszarach roboczych na serwerze. Możesz również użyć gwiazdki (*) symbolu wieloznacznego, aby wyświetlić informacje o wszystkich obszarach roboczych dla serwera.
<old-user-name>
Udostępnia starą nazwę użytkownika dla opcji /updateUserName.
<old-computer-name>
Zawiera starą nazwę komputera dla opcji /updateComputerName.
<team-project-collection-url>
Adres URL kolekcji projektu, który zawiera obszary robocze, o których chcesz wyświetlić informacje, na przykład https://myserver:8080/tfs/DefaultCollection.
<username>
Udostępnia wartość opcji /login. Tę wartość można określić jako DOMAIN\<username> lub <username>.
<password>
Udostępnia wartość opcji /login.
Opcje
opcji
opis
/owner
Określa nazwę użytkownika, który utworzył obszar roboczy. Jeśli nie określono żadnego właściciela, funkcja TFVC zwraca informacje o obszarach roboczych należących tylko do bieżącego użytkownika.
/computer
Określa nazwę komputera klienckiego, według którego ma być filtrowana lista obszarów roboczych dla serwera. Jeśli żaden komputer nie zostanie określony, funkcja TFVC zwraca informacje o obszarach roboczych tylko na bieżącym komputerze.
/format
Określa format informacji o obszarze roboczym.
Brief zwraca informacje o obszarze roboczym bez mapowań.
Detailed zwraca informacje o obszarze roboczym, a także mapowania.
Xml zwraca informacje o obszarze roboczym, mapowanie, datę ostatniego dostępu, a także aliasy właściciela. Format szczegółowy można używać tylko wtedy, gdy określono opcję /collection.
Brief jest wartością domyślną.
/updateUserName
Aktualizuje informacje identyfikacyjne zabezpieczeń na serwerze Usługi Azure DevOps dla użytkownika, którego nazwa użytkownika sieci została zmieniona. Jeśli określisz tę opcję, musisz również określić kolekcję projektów przy użyciu opcji /collection.
/updateComputerName
Instruuje tfVC zaktualizować jego tabele, aby odzwierciedlały zmianę nazwy komputera klienckiego. Jeśli określisz tę opcję, musisz również określić kolekcję projektów przy użyciu opcji /collection.
/remove
Usuwa określone wpisy obszaru roboczego dla określonej kolekcji projektu z pamięci podręcznej klienta.
/collection
Określa kolekcję projektów.
/login
Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika za pomocą usługi Azure DevOps Server.
Uwagi
Polecenie workspaces narzędzia wiersza polecenia tf wyświetla informacje o obszarach roboczych na bieżącym komputerze należącym do określonego użytkownika lub dla wszystkich obszarów roboczych skojarzonych z określonym serwerem Usługi Azure DevOps. Dla każdego obszaru roboczego funkcja TFVC wyświetla nazwę, właściciela, komentarz i nazwę komputera. W przypadku szczegółowych danych wyjściowych są również wyświetlane mapowania obszarów roboczych. Jeśli nie podasz filtru, takiego jak właściciel, komputer lub nazwa obszaru roboczego, kontrola wersji serwera TEAMVC wyświetla tylko informacje o utworzonych obszarach roboczych.
Aby uzyskać więcej informacji na temat edytowania właściwości obszaru roboczego, zobacz polecenie Workspace.
Aby uzyskać więcej informacji na temat używania narzędzia wiersza polecenia tf, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).
Przykłady
Poniższy przykład przedstawia listę wszystkich obszarów roboczych dla bieżącego użytkownika na bieżącym komputerze:
c:\projects>tf workspaces
Poniższy przykład przedstawia listę wszystkich obszarów roboczych dla wszystkich użytkowników na wszystkich komputerach utworzonych w następującej kolekcji projektów pod adresem https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
Poniższy przykład przedstawia szczegółowe informacje o wszystkich obszarach roboczych utworzonych przez bieżącego użytkownika w kolekcji projektu pod adresem https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
Poniższy przykład przedstawia szczegółowe informacje o obszarze roboczym WS1, który jest własnością bieżącego użytkownika i znajduje się na bieżącym komputerze. Wyświetlane informacje zawierają listę mapowań obszarów roboczych.
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
Poniższy przykład usuwa wszystkie buforowane obszary robocze z pamięci podręcznej w kolekcji projektów pod adresem https://myserver:8080/tfs/DefaultCollection:
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection