witAdmin: dostosowywanie obiektów do śledzenia pracy i zarządzanie nimi
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Ważne
W przypadku lokalnego modelu procesów XML można użyć narzędzia witadmin do wyświetlania listy, importowania, eksportowania i modyfikowania procesu dla projektu. W przypadku modeli procesów Dziedziczone i Hostowane xml można używać tylko narzędzia witadmin do wyświetlania listy i eksportowania informacji o procesie. Aby zapoznać się z omówieniem modeli procesów i obsługiwanymi elementami, zobacz Dostosowywanie środowiska śledzenia pracy.
Możesz zmienić sposób śledzenia postępu zespołu, tworząc i dostosowując obiekty śledzące elementy robocze. Za pomocą narzędzia wiersza polecenia witadmin można tworzyć, usuwać, importować i eksportować obiekty, takie jak kategorie, listy globalne, globalny przepływ pracy, typy łączy i typy elementów roboczych. Można również usunąć, wyświetlić listę lub zmienić atrybuty pól elementów roboczych.
Ponadto w przypadku lokalnych serwerów Usługi Azure DevOps można zarządzać typami rozpoznawania, usterkami i błędami używanymi z zarządzaniem przypadkami testowymi za pomocą polecenia tcm fieldmapping.
Jak pokazano na poniższej ilustracji, zarządzasz kategoriami i typami elementów roboczych dla każdego projektu. Zarządzasz listami globalnymi, typami łączy i polami w elemencie roboczym dla każdej kolekcji projektów. Możesz dostosować globalny przepływ pracy dla projektu lub kolekcji.
W przypadku większości poleceń musisz być członkiem grup Administratorzy projektu lub Administratorzy kolekcji projektów. Aby uzyskać więcej informacji, zobacz Zmiana uprawnień na poziomie kolekcji projektów.
witadmin Uruchamianie narzędzia wiersza polecenia
Aby uruchomić witadmin narzędzie wiersza polecenia, otwórz okno wiersza polecenia, w którym jest zainstalowany program Visual Studio. Narzędzie witadmin wiersza polecenia jest instalowane z dowolną wersją programu Visual Studio. Dostęp do tego narzędzia można uzyskać, instalując bezpłatną wersję programu Visual Studio Community lub Visual Studio Team Explorer.
Uwaga
Aby nawiązać połączenie z usługą Azure DevOps Services, zalecamy użycie najnowszej wersji programu Visual Studio lub Visual Studio Community.
Uwaga
Aby nawiązać połączenie z serwerem lokalnym, zalecamy użycie tej samej lub nowszej wersji programu Visual Studio co serwer Usługi Azure DevOps. Jeśli na przykład połączysz się z usługą Azure DevOps Server 2019, połącz się z projektem z wersji programu Visual Studio 2019.
Dla programu Visual Studio 2022
%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
lub Professional Enterprise zamiast programu , w zależności od zainstalowanej Communitywersji.
Dla programu Visual Studio 2019
%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
lub Professional Enterprise zamiast programu , w zależności od zainstalowanej Communitywersji.
Dla programu Visual Studio 2017
%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
lub TeamExplorer Professional zamiast programu , w zależności od zainstalowanej Enterprisewersji.
W 32-bitowej wersji systemu Windows zastąp ciąg %programfiles(x86)% ciągiem %programfiles%. Możesz zainstalować program Visual Studio Community (który zapewnia dostęp do programu Team Explorer) lub Visual Studio Team Explorer 2017 bezpłatnie.
Parametry globalne
Możesz użyć następujących parametrów, aby wyświetlić tekst pomocy dla elementu witadmin.
| Parametr | Opis |
|---|---|
/? lub help |
Wyświetla składnię i parametry witadmin narzędzia wiersza polecenia. |
command /helplub command /? |
Wyświetla składnię i parametry określonego witadmin polecenia. |
Pliki definicji XML
Wszystkie obiekty śledzenia pracy — takie jak typy elementów roboczych, konfiguracja procesu, listy globalne — można dostosować, aktualizując ich definicje XML. Jeśli dopiero zaczynasz śledzenia pracy, zobacz Dostosowywanie środowiska śledzenia pracy.
Uruchamiasz polecenia witadmin względem usług Azure DevOps Services lub lokalnego serwera Azure DevOps Server. Jak pokazano na poniższych listach poleceń, obsługiwane są tylko polecenia witadmin , które wyświetlają lub eksportują pliki dla usług Azure DevOps Services.
Typy elementów roboczych
Elementy robocze służą do śledzenia wszystkich elementów potrzebnych do śledzenia. Każdy element roboczy jest oparty na typie elementu roboczego. Każdy typ elementu roboczego definiuje pola dostępne do przechowywania informacji. Dostępne typy elementów roboczych zależą od procesu użytego podczas tworzenia projektu (Agile, Scrum, Basic lub CMMI). Aby uzyskać więcej informacji, zobacz Track your work items in Azure Boards user stories, issues, bugs, features, and epics (Śledzenie elementów roboczych w scenariuszach, problemach, błędach, funkcjach i epikach usługi Azure Boards).
W przypadku modelu procesu dziedziczonego można dodawać i usuwać typy elementów roboczych z portalu internetowego. Aby uzyskać więcej informacji, zobacz Dodawanie typów elementów roboczych (proces dziedziczenia) i zarządzanie nimi.
Command
Azure DevOps Services
Azure DevOps Server
destroywitd: Usuwanie typu elementu roboczego
✔️
exportwitd: Eksportowanie pliku typu elementu roboczego
✔️
✔️
importwitd: Importowanie pliku typu elementu roboczego
✔️
listwitd: Wyświetlanie listy typów elementów roboczych
✔️
✔️
renamewitd: Zmienianie nazwy wyświetlanej dla typu elementu roboczego
✔️
Pola
Pola służą do śledzenia stanu i informacji skojarzonych z elementami roboczymi. Pola są definiowane dla organizacji lub kolekcji. Aby uzyskać więcej informacji, zobacz Pola i atrybuty elementu roboczego. Aby wyszukać opis określonego pola, zobacz Opisy pól domyślnych i pól elementów roboczych używanych w szablonach procesów.
W przypadku modelu procesu dziedziczonego można wyświetlać i usuwać pola z portalu internetowego. Aby uzyskać więcej informacji, zobacz Dodawanie pól (proces dziedziczenia) i zarządzanie nimi.
Command
Azure DevOps Services
Azure DevOps Server
deletefield: Usuwanie pola
✔️
listfields: Atrybuty pól listy
✔️
✔️
changefield: Zmienianie atrybutu pola
✔️
renamewitd: Zmienianie nazwy wyświetlanej funkcji WIT
✔️
Kategorie
Kategorie kojarzą jeden lub więcej typów elementów roboczych jako należących do tej samej kategorii. Usługa Azure Boards opiera się na domyślnych definicjach kategorii, z których wiele określa pojedynczy typ elementu roboczego na kategorię. Aby uzyskać więcej informacji, zobacz Używanie kategorii do grupowania typów elementów roboczych.
Command
Azure DevOps Services
Azure DevOps Server
exportcategories: Eksportowanie pliku Kategorii
✔️
✔️
importcategories: Zaimportuj plik Kategorii
✔️
Typy łączy
Użyj różnych typów linków, aby zarządzać różnymi relacjami między elementami roboczymi. W przypadku lokalnych modeli procesów XML i Hosted XML można zdefiniować niestandardowe typy linków. Aby uzyskać więcej informacji, zobacz Łączenie elementów roboczych z innymi obiektami i Przewodnik referencyjny dla typów linków.
Command
Azure DevOps Services
Azure DevOps Server
deletelinktype: Usuwanie typu łącza
✔️
exportlinktype: Eksportowanie pliku typu łącza
✔️
✔️
listlinktypes: Wyświetlanie listy zdefiniowanych typów linków
✔️
✔️
reactivatelinktype: Uaktywnij ponownie lub zmień nazwę typu łącza
✔️
Listy globalne
Listy globalne to listy wyboru, które można uwzględnić w co najmniej jednym polu i definicjach typu elementu roboczego. Elementy listy można udostępniać między kilka typów elementów roboczych dla kolekcji projektów, dołączając elementy listy w co najmniej jednym elemencie GLOBALLIST . Aby uzyskać więcej informacji, zobacz Dokumentacja elementu XML GLOBALLIST.
Command
Azure DevOps Services
Azure DevOps Server
destroygloballist: Usuwanie listy globalnej
✔️
exportgloballist: Eksportowanie listy globalnej
✔️
✔️
importgloballist: Importowanie listy globalnej
✔️
listgloballist: Wyświetl listę wszystkich nazw list globalnych
✔️
✔️
Globalny przepływ pracy
Za pomocą globalnego przepływu pracy można definiować i aktualizować pola oraz listy globalne, które mają zastosowanie do wszystkich typów elementów roboczych w projekcie lub kolekcji. Aby uzyskać więcej informacji, zobacz Dokumentacja elementu XML globalnego przepływu pracy.
Command
Azure DevOps Services
Azure DevOps Server
exportglobalworkflow: Eksportowanie pliku globalnego przepływu pracy
✔️
importglobalworkflow: Importowanie globalnego pliku przepływu pracy
✔️
Konfiguracja procesu
Konfiguracja procesu definiuje domyślną konfigurację i funkcje, do których zespoły mogą uzyskiwać dostęp przy użyciu usługi Azure Boards. Konfiguracja określa typy elementów roboczych, które są wyświetlane na liście prac produktu, listach prac przebiegu, tablicach i tablicach zadań. Aby uzyskać więcej informacji na temat konfiguracji procesu i tego, co można dostosować, zobacz Konfiguracja procesu.
W przypadku modelu procesów dziedziczonego można dostosować listy prac z poziomu portalu internetowego. Aby uzyskać więcej informacji, zobacz Dostosowywanie listy prac lub tablic (proces dziedziczenia).
Command
Azure DevOps Services
Azure DevOps Server
exportprocessconfig: Eksportowanie pliku ProcessConfiguration
✔️
✔️
importprocessconfig: Importowanie pliku ProcessConfiguration
✔️
Pamięć podręczna klienta
Po niektórych operacjach konserwacji komputery klienckie wymagają odświeżenia pamięci podręcznej. Po przeniesieniu, przywróceniu, zmianie nazwy lub przejściu w tryb failover serwera warstwy danych lub serwera warstwy aplikacji należy odświeżyć pamięć podręczną na potrzeby śledzenia elementów roboczych, a użytkownicy muszą odświeżyć pamięć podręczną kontroli wersji na komputerach klienckich.
Następujące witadmin polecenie jest dostępne tylko dla lokalnego serwera Azure DevOps Server.
rebuildcache: Ponowne kompilowanie pamięci podręcznej klienta
Mapowanie pól zarządzania przypadkami testowymi
Aby dostosować typy rozwiązywania, typ elementu roboczego usterki i typy błędów używane podczas pracy z planami testów platformy Azure, możesz użyć następującego polecenia tcm . To polecenie jest dostępne tylko dla wersji lokalnych usługi Azure DevOps Server.
tcm fieldmapping: Zaimportuj lub wyeksportuj plik, który definiuje typy rozwiązywania problemów, usterek lub błędów do użycia z zarządzaniem przypadkami testowymi.