Usuwanie projektu zespołowego

Można usunąć projekt zespołowy z Team Foundation Server (TFS), kiedy projekt nie jest już wymagany, używając TFSDeleteProject.Ponadto jeśli istnieją składniki, które pozostaną nieusunięte po nieudanym tworzeniu projektu zespołowego, można użyć narzędzia TFSDeleteProject, aby je usunąć.

Aby usunąć projekt zespołowy z usługi Visual Studio Online lub z programu TFS przy użyciu konsoli administracyjnej, zobacz Usuwanie projektu zespołowego.

Przestroga
Polecenie TFSDeleteProject trwale likwiduje projekt zespołowy; po tej operacji nie można go odzyskać.Powinieneś wykonać kopie zapasowe wszystkich ważnych danych projektowych przed użyciem TFSDeleteProject.

Aby uzyskać dostęp do narzędzia wiersza poleceń TFSDeleteProject otwórz okno Wiersza polecenia, w którym zainstalowany jest Visual Studio lub Team Explorer i wejdź do:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

W 32-bitowej wersji systemu Windows należy zastąpić %programfiles(x86)% elementem %programfiles%.

Wymagane są uprawnienia

Aby użyć polecenia TFSDeleteProject musisz być członkiem grupy bezpieczeństwa Administratorów Team Foundation lub Administratorów projektu.Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień administracyjnych w Team Foundation Server.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Parametry

Opcja	Opis
/q	Opcjonalnie.Użyj trybu cichego.Nie monituj użytkownika o potwierdzenie.
/force	Opcjonalnie.Określa, że proces usuwania powinien być kontynuowany, nawet jeśli niektórych składników nie można usunąć.
/excludewss	Opcjonalnie.Określa, że nie należy usuwać witryny programu SharePoint skojarzonej z projektem zespołowym.Określ tę opcję, aby zachować istniejącą witrynę, dzięki czemu inne projekty zespołowe będą mogły nadal jej używać.
/collection:URL	Wymagany.Określa URI kolekcji projektu zespołowego.Format, którego musisz używać dla URI: http://ServerName:Port/VirtualDirectoryName/CollectionName Jeśli nie określisz używanego katalogu wirtualnego, musisz użyć następującego formatu dla URI: http://ServerName:Port/CollectionName.
TeamProjectName	Wymagany.Nazwa projektu.Jeśli nazwa zawiera spacje, należy ją ująć w znaki cudzysłowu.

Uwagi

Podczas tworzenia projektu zespołowego program Team Foundation Server tworzy obiekty danych na serwerze, który obsługuje Team Foundation Server i może tworzyć obiekty danych na serwerze obsługującym Produkty SharePoint oraz serwerze, który obsługuje usługi SQL Server Reporting Services.Podczas usuwania projektu zespołowego, raporty są automatycznie usuwane z SQL Server usług Reporting Services.

Podczas usuwania projektu zespołowego można wybrać, czy należy usunąć obiekty, które zostały utworzone do obsługi witryny programu SharePoint.Jednak błąd może uniemożliwić programowi Team Foundation Server tworzenie lub usuwanie wszystkich obiektów.Aby rozwiązać te problemy, w poniższych sekcjach przedstawiono informacje, łącza do innych zasobów i określone kroki, które pomagają ustalić przyczynę problemu, rozwiązać go i w razie konieczności usunąć dane obiektów, które pozostały po uruchomieniu TFSDeleteProject.

• Proces TFSDeleteProject

• Dane, które mogą pozostać nieusunięte

• Sprawdzenie, czy części składowe projektu zespołu zostały usunięte

• Usuń pozostałe składniki po częściowym usunięciu projektu

• Zwiększ limit czasu wyjścia

Proces TFSDeleteProject

Podczas korzystania z narzędzia wiersza poleceń TFSDeleteProject, najpierw usuwa ono dane projektu, a następnie witryny sieci Web projektu.

Etap 1: TFSDeleteProject usuwa dane projektu

W pierwszej fazie TFSDeleteProject automatycznie wykonuje następujące czynności, aby usunąć dane projektu zespołu:

1. Polecenie TFSDeleteProject tworzy spis wszystkich składników, które są kandydatami do usunięcia.Obejmuje to składniki, które integrują się z Test Manager, Team Foundation Build i Kontrola wersji programu Team Foundation.

2. Polecenie TFSDeleteProject usuwa składnik, który wyświetla węzeł projektu w programie Team Explorer.

3. Polecenie TFSDeleteProject oflagowuje informacje o kontroli wersji do usunięcia, ale nie od razu usuwa te informacje.Informacje obejmują wszystkie gałęzie kontroli wersji w określonym projekcie, ale nie inne gałęzie spoza projektu.

   • Jeżeli zarówno gałęzie nadrzędna i podrzędna są w projekcie, narzędzie TFSDeleteProject flaguje obie do usunięcia.

   • Jeśli gałęzie nadrzędne i podrzędne znajdują się w różnych projektach, narzędzie TFSDeleteProject flaguje tylko określoną gałąź.

   • Jeśli inny projekt jest gałęzią określonego projektu, narzędzie TFSDeleteProject flaguje tylko określony projekt.Po usunięciu określonego projektu, projekt odgałęzienia staje się oddzielony.

4. Polecenie TFSDeleteProject natychmiast usuwa dane kompilacji, w tym informacje oraz dane podstawowe, definicje kompilacji, agentów kompilacji i wyniki testów związane z projektem zespołowym.Narzędzie nie usuwa docelowych lokalizacji kompilacji.Nie trzeba usuwać lokalizacji docelowej kompilacji starego projektu zespołu przed utworzeniem projektu zespołu, który korzysta z tej samej lokalizacji docelowej kompilacji.

   Jeśli określony projekt zawiera dużą ilość danych kompilacji, usunięcie nie może zakończyć się pomyślnie przed upływem limitu czasu.Aby obejść ten problem, zobacz Zwiększenie limitu czasu, a następnie uruchom TFSDeleteProject ponownie.

5. Polecenie TFSDeleteProject natychmiast usuwa elementy robocze i pola elementów roboczych, które należą do określonego projektu, i usuwa wszystkie nieudostępnione metadane.

   Jeśli określony projekt zawiera dużą ilość danych elementów roboczych, usunięcie nie może zakończyć się pomyślnie przed upływem limitu czasu.Aby rozwiązać ten problem, zobacz Zwiększenie limitu czasu, a następnie uruchom TFSDeleteProject ponownie.

Etap 2: TFSDeleteProject usuwa dane projektu witryny sieci Web

W drugim etapie TFSDeleteProject usuwa następujące dane:

Ważne
Te kroki mogą zająć dużo czasu, w trakcie którego może obniżyć się wydajność serwera.

• Polecenie TFSDeleteProject używa interfejsów API usług Reporting Services do usuwania raportów na serwerze hostującym usługi Reporting Services.

• Polecenie TFSDeleteProject usuwa witrynę sieci Web portalu projektu z serwera, który hostuje zestaw Produkty SharePoint.Krok ten występuje tylko wtedy, gdy projekt jest właścicielem witryny i usunięcie witryny nie jest wykluczone w wierszu polecenia. (należy wziąć pod uwagę, że wiele projektów może odwoływać się do jednej witryny, ale tylko jedna z nich może być właścicielem, gdzie raporty/pulpity nawigacyjne domyślnie korzystają z tego projektu).

  [!UWAGA]

  Przed usunięciem zespołu projektu, może potwierdzić, że Usługi raportowania i Produkty SharePoint uzywają poprawnych projektów URL sprawdzając ustawienia portalu.Aby uzyskać więcej informacji, zobacz How to: Add a Team Project Portal.

Jeśli narzędzie TFSDeleteProject pomyślnie usuwa wszystkie z powyższych elementów danych, zwraca komunikat Gotowe.Aby sprawdzić wynik, zobacz Sprawdzanie usunięcia składników projektu zespołu.

Jeśli jeden lub więcej składników nie jest usuwane, można ponownie uruchomić narzędzie TFSProjectDelete za pomocą opcji /force, aby kontynuować proces usuwania, nawet jeśli nie jest on w stanie usunąć wszystkich elementów danych.Po wybraniu tej opcji TFSDeleteProject pomija składnik, którego nie może usunąć, zwraca komunikat o błędzie, usuwa następny składnik dalej i pozostawia w niezmienionym stanie metadane dotyczące projektu zespołowego i ustawień zabezpieczeń.

Dane, które mogą pozostać nieusunięte

Następujące dane mogły pozostać we wdrożeniu po pomyślnym wykonaniu polecenia TFSDeleteProject:

• Dane projektu zespołowego w module.Dane projektu zespołowego pozostają w module, dopóki nie zostanie on przebudowany, kiedy to usługa kontrolera magazynu usuwa wszystkie historyczne dane kompilacji, które zostały usunięte z baz danych programu Team Foundation.

• Pliki zrzutu i foldery kompilacji.Pliki binarne kompilacji, pliki dziennika kompilacji oraz pliki dziennika zawierające wyniki testów są publikowane podczas procesu kompilacji.Lokalizacje tych plików nie są usuwane.Jeśli chcesz usunąć te pliki, należy je usunąć ręcznie.

• Metadane śledzenia elementów roboczych, które są udostępniane.Polecenie TFSDeleteProject nie usuwa żadnych metadanych dotyczących śledzenia elementów roboczych, które są współużytkowane między projektami zespołowymi.

• Zestawy odłożone kontroli wersji zawierające kod udostępniony.Zestawy odłożone kontroli wersji nie są usuwane, jeśli istnieje kod w zestawie odłożonym z wielu projektów zespołu.

Sprawdzenie usunięcia projektu

Można zweryfikować sukces usunięcia projektu, potwierdzając, że węzeł projektu zespołu nie jest już wyświetlany w Team Explorer i że jego strona sieci Web portalu projektu i foldery raportów już nie istnieją.

Aby sprawdzić, czy projekt zespołu został pomyślnie usunięty

1. Otwórz Team Explorer i sprawdź, czy projekt nie jest wyświetlany jako węzeł projektu.

2. Otwórz program Internet Explorer i wpisz adres URL witryny portalu sieci Web projektu.Upewnij się, że witryna już nie istnieje.

3. W programie Internet Explorer w polu adresu wpisz adres URL witryny sieci Web usługi Reporting Services przy użyciu jednego z następujących formatów adresu URL:

   • http://ReportingServices/Reports

   • **http://ReportingServices/Reports_**TFSInstance

4. W Menedżerze raportów wybierz opcję Pokaż szczegóły.

5. Sprawdź, czy folder usuniętego projektu zespołu nie jest już wyświetlany.Wybierz folder główny TfsReports, a następnie folder wyznaczony dla kolekcji projektu zespołowego.Nie powinien istnieć już folder o nazwie usuniętego projektu.

6. Jeśli raporty lub witryna sieci Web pozostała, zobacz następną procedurę.

Usuń pozostałe składniki po częściowym usunięciu projektu

Jeżeli portal projektów, witryna sieci Web i folderu raportów pozostają po usunięciu projektu zespołowego, usuń witrynę i folder ręcznie.

Aby ręcznie usunąć raporty i witrynę sieci Web portalu usuniętego projektu zespołu

1. Zaloguj się do serwera, który obsługuje Usługi raportowania dla projektu zespołowego, który zostanie usunięty.

2. Otwórz program Internet Explorer i w polu adresu wpisz adres URL witryny sieci Web usług raportowania przy użyciu jednego z następujących formatów adresu URL:

   • https://localhost/Reports

   • **https://localhost/Reports_**TFSInstance

3. W Menedżerze raportów wybierz opcję Pokaż szczegóły.

4. Wybierz folder główny TfsReports, a następnie folder wyznaczony dla kolekcji projektu zespołowego.

5. Zaznacz pole wyboru odpowiadające projektowi zespołowemu, który został usunięty.

6. Wybierz Usuń.

7. Wybierz OK, aby potwierdzić zamiar usunięcia folderu raportów dla projektu zespołowego.

8. Aby usunąć witrynę sieci Web portalu usuniętego projektu, zobacz następującą stronę w witrynie firmy Microsoft w sieci Web: Jak: tworzenie, edycja i usuwanie witryn usług Windows SharePoint Services.

Zwiększ limit czasu wyjścia

Domyślnie, każde wywołanie usługi sieci Web, jakie wywołuje polecenie TFSDeleteProject, aby usunąć składnik, musi zostać zakończone w ciągu 10 minut.Jeśli istnieje sześć wywołań, proces może potrwać do godziny.Jeśli chcesz usunąć projekt zespołowy, który jest skojarzony z dużą ilość danych, można tymczasowo zwiększyć ten limit czasu.

[!UWAGA]

Zwiększenie limitu czasu wpływa na wszystkie połączenia usługi sieci Web.Ogólnie rzecz biorąc chcesz zachować limit czasu 10 minut, aby zapobiec temu, że wywołania usługi sieci Web mają negatywny wpływ na wydajność serwera i powodują, że użytkownicy mają zablokowaną możliwość używania interfejsu użytkownika przez długie okresy.Dlatego po pomyślnym usunięciu projektu należy zmienić limit czasu z powrotem na 10 minut.

Wymagane są uprawnienia

Aby wykonać te procedury, musisz być administratorem systemu Windows na serwerze warstwy aplikacji.

Ważne
Nieprawidłowe zmodyfikowanie rejestru komputera może spowodować niestabilność komputera.Jeśli użytkownik nie jest zaznajomiony z rejestrem, nie należy dodawać ani usuwać wpisów ani go modyfikować w jakikolwiek sposób.

Aby zwiększyć limit czasu dla polecenia TFSDeleteProject

1. Zaloguj się do serwera warstwy aplikacji.

2. Wybierz Start, kliknij Uruchom, wpisz wyrażenie regedit, a następnie kliknij OK.

3. W okienku przeglądarki rozwiń HKEY_ LOCAL_MACHINE:

   • Jeśli na serwerze działa 32-bitowy system operacyjny, rozwiń: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.

   • Jeśli na serwerze działa 64-bitowy system operacyjny, rozwiń: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.

4. Jeśli klucz TeamFoundation\RequestSettings nie istnieje, wykonaj następujące kroki, aby go utworzyć:

   1. Otwórz menu kontekstowe dla pozycji TeamFoundation, wskaż polecenie Nowy i wybierz polecenie Klucz.

   2. Nazwij klucz RequestSettings.

   3. Otwórz menu kontekstowe dla pozycji RequestSettings, wskaż polecenie Nowy i wybierz polecenie Wartość DWORD.

   4. Nazwij nową wartość DefaultTimeout.

5. Otwórz menu kontekstowe dla DefaultTimeout, a następnie wybierz Modyfikuj.

6. W Dane wartości, wpisz limit czasu w milisekundach, a następnie wybierz Dziesiętne.

   Na przykład aby zwiększyć limit czasu do 30 minut, wpisz 1800000.Aby zmienić limit czasu do 10 minut, wpisz 600000.

7. Wybierz przycisk OK.

8. W menu Plik kliknij przycisk Wyjdź.

Przykład

Poniższe polecenie usuwa wszystkie elementy związane z projektem zespołowym StoreFront na serwerze AdventureWorks1 programu Team Foundation Server w kolekcji projektów Collection1 i z programu Team Explorer.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/tfs/Collection1 StoreFront

Zobacz też

Koncepcje

Połącz się z projektami zespołowymi na serwerze Team Foundation Server

Inne zasoby

Tworzenie projektu zespołowego

Narzędzia wiersza polecenia dla TFS