Polecenie Obszary robocze (Kontrola wersji serwera Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Polecenie Kontrola wersji serwera Team Foundation (TFVC) workspaces 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.
Wymagania wstępne
Aby użyć workspaces polecenia, musisz mieć uprawnienie Odczyt ustawione na Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.
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 workspaces polecenia.
Argumenty
Argument
Opis
<owner-name>
Udostępnia wartość /owner opcji. Użyj pustego ciągu (""), aby dopasować obszary robocze utworzone przez dowolnego użytkownika.
<computer-name>
Udostępnia wartość /computer opcji. 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 /updateUserName opcji .
<old-computer-name>
Zawiera starą nazwę komputera dla /updateComputerName opcji .
<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ść /login opcji. Tę wartość można określić jako DOMAIN\<username> lub <username>.
<password>
Udostępnia wartość /login opcji.
Opcje
Opcja
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, najnowszą datę dostępu, a także aliasy właściciela. Format szczegółowy można użyć tylko wtedy, gdy zostanie określona /collection opcja. Brief jest wartością domyślną.
/updateUserName
Aktualizacje informacji identyfikacji 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 /collection opcji .
/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 /collection opcji .
/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 tf narzędzia wiersza polecenia 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 Obszar roboczy.
Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, 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
W poniższym przykładzie przedstawiono 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