Udostępnij za pośrednictwem

Polecenie Unshelve (Kontrola wersji programu Team Foundation)

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Program Visual Studio 2022

Kontrola wersji programu Team Foundation (TFVC) unshelve polecenie przywraca odłożone poprawki plików, notatki zaewidencjonowane, komentarze i skojarzenia elementów roboczych z bieżącym obszarem roboczym. Możesz również użyć polecenia unshelve, aby usunąć istniejący zestaw półek z serwera.

Warunki wstępne

  • Aby użyć polecenia unshelve:
    • Ustaw uprawnienie odczytu Zezwalaj na.
    • Uprawnienie Wyewidencjonuj dla elementów w zestawie półek ustawiono na Zezwalaj na.
  • Aby usunąć zestaw na półce, być jego właścicielem lub mieć Administrowanie odłożone zmiany globalne uprawnienia ustawione na Zezwalaj na.

Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

Składnia

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Parametry

W poniższych sekcjach opisano argumenty i opcje polecenia unshelve.

Argumenty

argumentów

opis

<shelveset-name>

Określa nazwę zestawu na półce do przywrócenia.

<owner-name>

Określa nazwę użytkownika właściciela zestawu na półce.

<item-spec>

Identyfikuje poprawki plików lub folderów, które mają być wstrzymane w bieżącym obszarze roboczym. Jeśli ten parametr nie jest uwzględniony, wszystkie oczekujące zmiany w określonym zestawie półek są domyślnie niezatrzymane. Ścieżki serwera nie są dozwolone.

Aby uzyskać więcej informacji na temat analizowania wartości <item-spec> kontroli wersji serwera Team Foundation w celu określenia, które elementy znajdują się w zakresie, zobacz Use Team Foundation version control commands - Use options to modify how a command functions.

Nuta

Można określić więcej niż jeden argument <item-spec>.

<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

/move

Usuwa określony zestaw półek z serwera Usługi Azure DevOps po pomyślnym usunięciu zestawu półek. Tej opcji nie można połączyć z wartością <item-spec>.

Zestaw półek można również usunąć przy użyciu polecenia shelve.

/recursive

Określa, że wartość <item-spec> powinna być dopasowywana rekursywnie.

/noprompt

Określa, że funkcja TFVC nie powinna monitu o podanie danych wejściowych.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps.

Uwagi

Polecenie unshelve narzędzia wiersza polecenia tf pobiera wszystkie poprawki plików odłożonych lub zdefiniowany podzestaw wszystkich odłożonych poprawek plików z serwera Usługi Azure DevOps. Następnie polecenie przechowuje poprawki w bieżącym obszarze roboczym.

Aby usunąć element, w docelowym obszarze roboczym nie może być żadnych oczekujących poprawek.

Po usunięciu zestawu półek funkcja TFVC przywraca każdą odłożoną poprawkę do docelowego obszaru roboczego jako oczekującą zmianę, o ile poprawka nie powoduje konfliktu ze zmianą, która była już oczekująca w obszarze roboczym. Aby uzyskać więcej informacji na temat tego, co się stanie podczas procesu wstrzymania, zobacz Praca z zestawami półek.

Możesz użyć polecenia unshelve, aby przywrócić poszczególne poprawki plików z zestawu na półce do obszaru roboczego. Po uruchomieniu polecenia unshelve uruchom polecenie get, aby uzgodnić wszelkie zmiany zaewidencjonowane na serwerze od momentu utworzenia zestawu półek.

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).

Odłożone zmiany odłożone

Jeśli chcesz zintegrować poprawki odłożone z bieżącym obszarem roboczym w celu wprowadzania bieżących poprawek, usuń odpowiedni zestaw półek. Najlepszym rozwiązaniem jest również pobranie najnowszej wersji plików kontrolowanych przez wersję po usunięciu zabezpieczeń.

Usuń zabezpieczenia i przejrzyj kod innego użytkownika

Możesz również usunąć zestaw półek, aby przejrzeć zmiany z obszaru roboczego innego użytkownika. Aby usunąć z tego powodu, masz dwie opcje:

  • Pierwsza opcja jest odpowiednia, gdy odłożone przedmioty i powiązane elementy nie zostały zmienione lub zostały zmienione tylko lekko od czasu utworzenia zestawu półek. W takim przypadku możesz pobrać podstawową wersję wszystkich powiązanych elementów z obszaru roboczego właściciela zestawu na półce. Aby użyć tej opcji, uruchom odmianę następującego polecenia: tf get \* /version;W<workspace-name>, gdzie <workspace-name> jest nazwą obszaru roboczego utworzonego przez innego użytkownika na półce.

  • Druga opcja jest odpowiednia, gdy minęła znaczna ilość czasu lub wiele poprawek znajdowało się w obszarze roboczym od momentu utworzenia zestawu półek. W takim przypadku można pobrać wersję wszystkich powiązanych elementów z serwera zgodnie z datą i godziną utworzenia zestawu półek.

Możesz cofnąć zmianę odłożonego innego użytkownika, dołączając nazwę użytkownika do nazwy zestawu półek. Można jednak usunąć zestaw półek tylko z serwera Usługi Azure DevOps, który został utworzony przez innego użytkownika, jeśli masz uprawnienie AdminShelvedChangesets.

Jeśli próbujesz usunąć element z oczekującą zmianą w docelowym obszarze roboczym, funkcja TFVC nie scala różnic między elementami i nie pobiera poprawki do obszaru roboczego.

Zestaw półek można usunąć przy użyciu tf shelve /delete. Aby uzyskać więcej informacji, zobacz polecenie Shelve. Aby automatycznie usunąć zestaw na półce po usunięciu całego zestawu na półce, użyj tf unshelve /move.

Przykłady

Poniższy przykład otwiera okno dialogowe Unshelve, dzięki czemu można znaleźć i usunąć zestaw półek w bieżącym obszarze roboczym. Istnieje również opcja w oknie dialogowym, aby zestaw półek został usunięty po zakończeniu operacji unshelve.

c:\>tf unshelve

W poniższym przykładzie zestaw półek buddytest_1256 do bieżącego obszaru roboczego i usuwa go z serwera Usługi Azure DevOps:

c:\>tf unshelve /move buddytest_1256