az devops migrations

  • Preview

Opmerking

Deze verwijzing maakt deel uit van de extensie azure-devops voor de Azure CLI (versie 2.30.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az devops migrations-opdracht uitvoert. Meer informatie over uitbreidingen.

Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Zakelijke livemigraties beheren.

Deze opdrachtgroep maakt deel uit van de azure-devops-extensie en is in preview. De beschikbaarheid kan beperkt zijn (bijvoorbeeld voor 1P-/toegestane gebruikers). Voor ELM-migraties moet --org de URL van uw Azure DevOps-organisatie zijn (bijvoorbeeld: https://dev.azure.com/myorg).

Opdracht

Name Description Type Status
az devops migrations abandon

Een migratie afbreken.

 Extension Voorbeeld
az devops migrations create

Maak een migratie voor een opslagplaats.

 Extension Voorbeeld
az devops migrations cutover

Cutover voor migratie beheren.

 Extension Voorbeeld
az devops migrations cutover approve

Keur cutover goed door niet-verwerkte items te accepteren en/of opnieuw ingerichte pijplijnen te verifiëren.

 Extension Voorbeeld
az devops migrations cutover cancel

Een geplande cutover annuleren.

 Extension Voorbeeld
az devops migrations cutover review

Bekijk niet-verwerkte migratie-items vóór cutover.

 Extension Voorbeeld
az devops migrations cutover set

Cutover plannen voor een migratie.

 Extension Voorbeeld
az devops migrations list

Migraties in een organisatie vermelden.

 Extension Voorbeeld
az devops migrations pause

Een actieve migratie onderbreken.

 Extension Voorbeeld
az devops migrations pipelines

Pijplijn opnieuw draaien voor migraties beheren. (Preview).

 Extension Voorbeeld
az devops migrations pipelines delete

Verwijder gegevens voor het opnieuw draaien van pijplijnen voor een migratie. (Preview).

 Extension Voorbeeld
az devops migrations pipelines list

Maak een lijst met opnieuw draaiende configuratie van pijplijnen en status per pijplijn.

 Extension Voorbeeld
az devops migrations pipelines retry

Opnieuw proberen mislukte pijplijn opnieuw te draaien vermeldingen. (Preview).

 Extension Voorbeeld
az devops migrations pipelines submit

Verzend pijplijnen voor opnieuw bekabelen. (Preview).

 Extension Voorbeeld
az devops migrations pipelines update

Configuratie voor het opnieuw draaien van pijplijnen bulksgewijs bijwerken. (Preview).

 Extension Voorbeeld
az devops migrations resume

Hervatten van een gestopte (onderbroken, mislukte) migratie.

 Extension Voorbeeld
az devops migrations status

De migratiestatus voor een opslagplaats ophalen.

 Extension Voorbeeld

az devops migrations abandon

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een migratie afbreken.

Hiermee verplaatst u de migratie naar een verlaten/mislukte status; de migratierecord is niet opgeschoond. Het opnieuw draaien van gegevens voor pijplijnen blijft intact, zodat een volgende migratie deze opnieuw kan gebruiken.

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--remove-read-only]
                             [--repository-id]
                             [--yes]

Voorbeelden

De opslagplaats verlaten en alleen-lezen houden (standaard).

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

De opslagplaats verlaten en terugzetten op lezen/schrijven.

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Stel ook de Azure-opslagplaatsen opslagplaats weer in op de status Lezen/schrijven door removeReadOnly=true te verzenden.

Eigenschap Waarde
Default value: False
--repository-id

Id van de Opslagplaats voor Azure-opslagplaatsen (GUID).

--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az devops migrations create

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Maak een migratie voor een opslagplaats.

Als --github-token niet is opgegeven, controleert de CLI ELM_GITHUB_TOKEN en voert vervolgens GitHub apparaatstroom uit om een token te verkrijgen.

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]
                            [--github-token]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--service-endpoint-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

Voorbeelden

Maak een migratie.

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>

Maak een alleen-validerende migratie.

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

Maak met behulp van een vooraf gegenereerd GitHub token of PAT.

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --github-token <token>

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--agent-pool

Naam van agentgroep die moet worden gebruikt voor migratiewerk.

--auto-discover --enable-auto-discover-pipelines

Meld u aan voor automatische pijplijndetectie bij cutover. Standaard uitgeschakeld. Wanneer deze functie is ingeschakeld, begeleidt de ELM-synchronisatietaak de bronopslagplaats en maakt u kloondefinities voor elke pijplijn die ernaar verwijst. Vereist --pipeline-service-connection-id; zonder dat de detectie wordt uitgevoerd als een no-op en 0 pijplijnen registreert. Pijplijn die zelf opnieuw wordt gewiwed, is altijd beschikbaar via az devops migrations pipelines submit/update.

Eigenschap Waarde
Default value: False
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--cutover-date

Geplande cutover-datum/tijd (ISO 8601).

--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--enable-boards-gh --enable-boards-github-connection

Meld u aan voor het inrichten van de Azure Boards GitHub-verbinding bij cutover. Standaard uitgeschakeld. Vereist dat de Azure Boards GitHub-app is geïnstalleerd op de doel-GitHub Enterprise-organisatie voordat de migratie wordt uitgevoerd.

Eigenschap Waarde
Default value: False
--github-token

GitHub gebruikerstoken dat wordt gebruikt voor verificatie van de gebruikersidentiteit op de doelhost. Onafhankelijk van --service-endpoint-id. Als dit wordt weggelaten en --service-endpoint-id niet is opgegeven, controleert de CLI ELM_GITHUB_TOKEN en wordt vervolgens GitHub apparaatstroom uitgevoerd. Wanneer --service-endpoint-id wordt opgegeven, wordt de apparaatstroom overgeslagen; geef --github-token door of stel ELM_GITHUB_TOKEN in om het gebruikerstoken op te geven.

--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--pipeline-sc-id --pipeline-service-connection-id

Project-scoped GitHub GUID (Service Connection ID) gekoppeld tijdens het maken van pijplijnen. Vereist voor volledige automatische detectie in combinatie met --enable-auto-discover-pipelines; optioneel in de handmatige modus (koppelt de verbinding vooraf, zodat volgende pijplijnen alleen --pipeline-id's nodig hebben).

--repository-id

Id van de Opslagplaats voor Azure-opslagplaatsen (GUID).

--service-endpoint-id

Service-eindpunt-id (GUID) voor de GitHub Enterprise Server-verbinding die wordt gebruikt voor het synchroniseren van doorvoeringen naar het doel. Onafhankelijk van verificatie van gebruikersidentiteit: --github-token/ELM_GITHUB_TOKEN kan naast deze vlag worden geleverd. Apparaatstroom wordt overgeslagen wanneer deze vlag is ingesteld.

--skip-validation

Validatiebeleid om over te slaan. Accepteert een door komma's gescheiden lijst met beleidsnamen (bijvoorbeeld AgentPoolExists, MaxFileSize) of een niet-negatief geheel getal bitmasker. Ondersteunde beleidsnamen (hoofdlettergevoelig): None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

Gebruikers-id van doelopslagplaatseigenaar. Afgeschaft en genegeerd wanneer de oplossing van een token op de server is ingeschakeld.

--target-repository

URL van doelopslagplaats (moet beginnen met http:// of https://).

--validate-only

Maken in de modus Alleen valideren (alleen controles vóór migratie).

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az devops migrations list

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Migraties in een organisatie vermelden.

Standaard wordt de meest recente migratie per opslagplaats geretourneerd, ongeacht de status. Gebruik --include-all om de volledige migratiegeschiedenis te retourneren.

az devops migrations list [--detect {false, true}]
                          [--include-all]
                          [--include-inactive]
                          [--org --organization]
                          [--project]

Voorbeelden

Vermeld de meest recente migratie per opslagplaats.

az devops migrations list --org https://dev.azure.com/myorg

Vermeld de volledige migratiegeschiedenis voor elke opslagplaats.

az devops migrations list --org https://dev.azure.com/myorg --include-all

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--include-all

Retourneert de volledige migratiegeschiedenis (alle records per opslagplaats). Standaard wordt alleen de meest recente migratie per opslagplaats geretourneerd, ongeacht de status.

Eigenschap Waarde
Default value: False
--include-inactive
Afgeschaft

Optie '--include-inactive' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--include-all'.

Deprecated. Gebruik in plaats daarvan --include-all.

Eigenschap Waarde
Default value: False
--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--project

Optionele projectnaam of id voor het filteren van migraties.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az devops migrations pause

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een actieve migratie onderbreken.

az devops migrations pause [--acquire-policy-token]
                           [--change-reference]
                           [--detect {false, true}]
                           [--org --organization]
                           [--repository-id]

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--repository-id

Id van de Opslagplaats voor Azure-opslagplaatsen (GUID).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az devops migrations resume

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Hervatten van een gestopte (onderbroken, mislukte) migratie.

az devops migrations resume [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--migration]
                            [--org --organization]
                            [--repository-id]
                            [--validate-only]

Voorbeelden

Hervatten met de huidige modus.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Hervatten in de modus Alleen-valideren.

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only

Doorgaan met de migratie (hiermee wordt de modus Alleen valideren gewist).

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--migration

Promoveren van een geslaagde alleen-valideren-migratie naar een volledige migratie (sets validateOnly=false en statusRequested=active).

Eigenschap Waarde
Default value: False
--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--repository-id

Id van de Opslagplaats voor Azure-opslagplaatsen (GUID).

--validate-only

Hervatten in de modus Alleen-valideren.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az devops migrations status

Preview

De opdrachtgroep Devops-migraties is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

De migratiestatus voor een opslagplaats ophalen.

az devops migrations status [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--org --organization]
                            [--repository-id]

Voorbeelden

Migratiestatus ophalen op basis van opslagplaats-id.

az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--org --organization

Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

--repository-id

Id van de Opslagplaats voor Azure-opslagplaatsen (GUID).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False