az devops migrations
Note
To odwołanie jest częścią rozszerzenia azure-devops dla Azure CLI (wersja 2.30.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az devops migrations . Dowiedz się więcej o rozszerzeniach.
Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zarządzanie migracjami na żywo w przedsiębiorstwie.
Ta grupa poleceń jest częścią rozszerzenia azure-devops i jest w wersji zapoznawczej. Dostępność może być ograniczona (na przykład do 1P/dozwolonych użytkowników). W przypadku migracji ELM --org powinna być adresem URL organizacji usługi Azure DevOps (na przykład: https://dev.azure.com/myorg).
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az devops migrations abandon |
Porzucenie migracji. |
Extension | Preview |
| az devops migrations create |
Utwórz migrację dla repozytorium. |
Extension | Preview |
| az devops migrations cutover |
Zarządzanie migracją jednorazową. |
Extension | Preview |
| az devops migrations cutover approve |
Zatwierdzanie migracji jednorazowej przez akceptowanie nieprzetworzonych elementów i/lub weryfikowanie ponownie połączonych potoków. |
Extension | Preview |
| az devops migrations cutover cancel |
Anulowanie zaplanowanego migracji jednorazowej. |
Extension | Preview |
| az devops migrations cutover review |
Przed rozpoczęciem migracji jednorazowej przejrzyj nieprzetworzone elementy migracji. |
Extension | Preview |
| az devops migrations cutover set |
Planowanie migracji jednorazowej. |
Extension | Preview |
| az devops migrations list |
Wyświetlanie listy migracji w organizacji. |
Extension | Preview |
| az devops migrations pause |
Wstrzymaj aktywną migrację. |
Extension | Preview |
| az devops migrations pipelines |
Zarządzanie ponownym wirowaniem potoku na potrzeby migracji. (Wersja zapoznawcza). |
Extension | Preview |
| az devops migrations pipelines delete |
Usuwanie danych ponownego wirowania potoku na potrzeby migracji. (Wersja zapoznawcza). |
Extension | Preview |
| az devops migrations pipelines list |
Wyświetlanie listy konfiguracji ponownego wirowania potoku i stanu dla potoku. |
Extension | Preview |
| az devops migrations pipelines retry |
Ponów próbę nie powiodło się ponowne przełączanie wpisów potoku. (Wersja zapoznawcza). |
Extension | Preview |
| az devops migrations pipelines submit |
Przesyłanie potoków do ponownego przesyłania. (Wersja zapoznawcza). |
Extension | Preview |
| az devops migrations pipelines update |
Konfiguracja ponownego wirowania potoku aktualizacji zbiorczej. (Wersja zapoznawcza). |
Extension | Preview |
| az devops migrations resume |
Wznów zatrzymaną (wstrzymaną, nieudaną) migrację. |
Extension | Preview |
| az devops migrations status |
Pobieranie stanu migracji dla repozytorium. |
Extension | Preview |
az devops migrations abandon
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Porzucenie migracji.
Przenosi migrację do stanu porzuconego/nieudanego; rekord migracji nie jest czyszczone. Dane ponownego instalowania potoku są pozostawione bez zmian, więc kolejna migracja może ich ponownie używać.
az devops migrations abandon [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--remove-read-only]
[--repository-id]
[--yes]
Przykłady
Porzucanie i utrzymywanie repozytorium tylko do odczytu (ustawienie domyślne).
az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Porzucanie i ustawianie repozytorium z powrotem do odczytu i zapisu.
az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Ustaw również repozytorium Azure Repos z powrotem na stan odczytu i zapisu, wysyłając polecenie removeReadOnly=true.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Identyfikator repozytorium Azure Repos (GUID).
Nie monituj o potwierdzenie.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az devops migrations create
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Utwórz migrację dla repozytorium.
GitHub uwierzytelnianie korzysta z przepływu urządzenia: interfejs wiersza polecenia wyświetla adres URL i jednorazowy kod umożliwiający interaktywne ukończenie logowania. Nie jest wymagany token GitHub ani połączenie z usługą.
az devops migrations create [--acquire-policy-token]
[--agent-pool]
[--auto-discover --enable-auto-discover-pipelines]
[--change-reference]
[--cutover-date]
[--detect {false, true}]
[--enable-boards-gh --enable-boards-github-connection]
[--org --organization]
[--pipeline-sc-id --pipeline-service-connection-id]
[--repository-id]
[--skip-validation]
[--target-owner-user-id]
[--target-repository]
[--validate-only]
Przykłady
Tworzenie migracji.
az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool>
Utwórz migrację tylko do weryfikacji.
az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --agent-pool <your-agent-pool> --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Nazwa puli agentów do użycia na potrzeby pracy migracji.
Zrezygnuj z automatycznego odnajdywania potoków w trybie jednorazowym. Domyślnie wyłączone. Po włączeniu zadania synchronizacji ELM przeprowadza repozytorium źródłowe i tworzy definicje klonowania dla każdego potoku, który odwołuje się do niego. Wymaga parametru --pipeline-service-connection-id; bez odnajdywania jest uruchamiany jako no-op i rejestruje 0 potoków. Samo wirowanie potoku jest zawsze dostępne za pośrednictwem polecenia az devops migrations pipelines submit/update.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Zaplanowana data/godzina migracji jednorazowej (ISO 8601).
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Zrezygnuj z aprowizacji połączenia Azure Boards GitHub podczas migracji jednorazowej. Domyślnie wyłączone. Wymaga zainstalowania aplikacji Azure Boards GitHub w docelowej organizacji GitHub Enterprise przed uruchomieniem migracji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Project o zakresie GitHub identyfikator połączenia usługi (GUID) dołączony w czasie tworzenia na potrzeby ponownego wirowania potoku. Wymagane do pełnego automatycznego odnajdywania w połączeniu z potokami --enable-auto-discover-pipelines; opcjonalne w trybie ręcznym (wstępnie dołącza połączenie, aby kolejne potoki przesyłały wywołania wymagają tylko parametru --pipeline-ids).
Identyfikator repozytorium Azure Repos (GUID).
Zasady walidacji do pominięcia. Akceptuje rozdzieloną przecinkami listę nazw zasad (na przykład AgentPoolExists, MaxFileSize) lub nieujemną maskę bitów. Obsługiwane nazwy zasad (bez uwzględniania wielkości liter): None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.
Identyfikator użytkownika właściciela repozytorium docelowego. Przestarzałe i ignorowane po włączeniu rozpoznawania właściciela opartego na tokenach po stronie serwera.
Adres URL repozytorium docelowego (musi zaczynać się od http:// lub https://).
Utwórz w trybie tylko weryfikacji (tylko sprawdzanie przed migracją).
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az devops migrations list
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Wyświetlanie listy migracji w organizacji.
Domyślnie jest zwracana najnowsza migracja na repozytorium niezależnie od stanu. Użyj --include-all, aby zwrócić pełną historię migracji.
az devops migrations list [--detect {false, true}]
[--include-all]
[--include-inactive]
[--org --organization]
[--project]
Przykłady
Wyświetl listę najnowszych migracji na repozytorium.
az devops migrations list --org https://dev.azure.com/myorg
Wyświetl pełną historię migracji dla każdego repozytorium.
az devops migrations list --org https://dev.azure.com/myorg --include-all
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Zwróć pełną historię migracji (wszystkie rekordy na repozytorium). Domyślnie zwracana jest tylko najnowsza migracja na repozytorium, niezależnie od stanu.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Opcja "--include-inactive" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--include-all".
Deprecated. Zamiast tego użyj --include-all.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Opcjonalna nazwa lub identyfikator projektu do filtrowania migracji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az devops migrations pause
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Wstrzymaj aktywną migrację.
az devops migrations pause [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Identyfikator repozytorium Azure Repos (GUID).
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az devops migrations resume
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Wznów zatrzymaną (wstrzymaną, nieudaną) migrację.
az devops migrations resume [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--migration]
[--org --organization]
[--repository-id]
[--validate-only]
Przykłady
Wznów korzystanie z bieżącego trybu.
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Wznów w trybie tylko do weryfikacji.
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only
Kontynuuj migrację (czyści tryb tylko weryfikacji).
az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Podwyższanie poziomu migracji tylko do weryfikacji zakończonej powodzeniem do pełnej migracji (zestawy validateOnly=false i statusRequested=active).
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Identyfikator repozytorium Azure Repos (GUID).
Wznów w trybie tylko do weryfikacji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az devops migrations status
Grupa poleceń "devops migrations" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Pobieranie stanu migracji dla repozytorium.
az devops migrations status [--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--repository-id]
Przykłady
Pobieranie stanu migracji według identyfikatora repozytorium.
az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Automatycznie wykrywaj organizację.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie zostało skonfigurowane jako domyślne lub pobrane z konfiguracji Git. Przykład: https://dev.azure.com/MyOrganizationName/.
Identyfikator repozytorium Azure Repos (GUID).
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |